<path-permission>
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
- نحو:
<path-permission android:path="string"
android:pathPrefix="string"
android:pathPattern="string"
android:permission="string"
android:readPermission="string"
android:writePermission="string" />- موجود در:
-
<provider> - توضیحات:
- مسیر و مجوزهای لازم را برای زیرمجموعه خاصی از داده ها در یک ارائه دهنده محتوا تعریف می کند. این عنصر را می توان چندین بار برای ارائه چندین مسیر مشخص کرد.
- صفات:
-
android:path - یک مسیر URI کامل برای زیر مجموعه ای از داده های ارائه دهنده محتوا. مجوز فقط می تواند به داده های خاصی که توسط این مسیر شناسایی شده اند اعطا شود. هنگامی که برای ارائه محتوای پیشنهادی جستجو استفاده می شود، با
/search_suggest_query اضافه می شود. -
android:pathPrefix - بخش اولیه یک مسیر URI برای زیر مجموعه ای از داده های ارائه دهنده محتوا. می توان به همه زیرمجموعه های داده با مسیرهایی که این قسمت اولیه را به اشتراک می گذارند، مجوز داد.
-
android:pathPattern - یک مسیر URI کامل برای زیرمجموعه‌ای از داده‌های ارائه‌دهنده محتوا، اما مسیری که می‌تواند از حروف عام زیر استفاده کند:
- یک ستاره (
* ). این یک دنباله از صفر تا بسیاری از اتفاقات نویسه بلافاصله قبل را مطابقت می دهد. - نقطه به دنبال ستاره (
.* ). این با هر دنباله ای از کاراکترهای صفر یا بیشتر مطابقت دارد.
از آنجایی که وقتی رشته از XML خوانده می‌شود، از بک اسلش ( \ ) به عنوان یک کاراکتر فرار استفاده می‌شود، قبل از اینکه به‌عنوان یک الگو تجزیه شود، باید دوبار escape کنید. به عنوان مثال، یک * تحت اللفظی به صورت " \\* " و یک \ تحت اللفظی به صورت " \\\ " نوشته می شود. این همان چیزی است که هنگام ساخت رشته در زبان برنامه نویسی جاوا می نویسید.
برای اطلاعات بیشتر در مورد این نوع الگوها، به توضیحات PATTERN_LITERAL ، PATTERN_PREFIX ، و PATTERN_SIMPLE_GLOB در کلاس PatternMatcher مراجعه کنید.
-
android:permission - نام مجوزی که مشتریان برای خواندن یا نوشتن داده‌های ارائه‌دهنده محتوا به آن نیاز دارند. این ویژگی روشی مناسب برای تنظیم یک مجوز برای خواندن و نوشتن است. با این حال، صفات
readPermission و writePermission بر این ویژگی اولویت دارند. -
android:readPermission - مجوزی که مشتریان برای پرس و جو از ارائه دهنده محتوا به آن نیاز دارند.
-
android:writePermission - مجوزی که مشتریان برای ایجاد تغییرات در داده های کنترل شده توسط ارائه دهنده محتوا به آن نیاز دارند.
- معرفی شده در:
- API سطح 4
- همچنین ببینید:
-
SearchManager -
Manifest.permission - نکات امنیتی
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# <path-permission\u003e\n\nsyntax:\n:\n\n ```xml\n \u003cpath-permission android:path=\"string\"\n android:pathPrefix=\"string\"\n android:pathPattern=\"string\"\n android:permission=\"string\"\n android:readPermission=\"string\"\n android:writePermission=\"string\" /\u003e\n ```\n\ncontained in:\n: [\u003cprovider\u003e](/guide/topics/manifest/provider-element)\n\ndescription:\n: Defines the path and required permissions for a specific subset of data\n within a content provider. This element can be\n specified multiple times to supply multiple paths.\n\nattributes:\n:\n\n `android:path`\n : A complete URI path for a subset of content provider data.\n Permission can be granted only to the particular data identified by this path.\n When used to provide search suggestion content, it is appended\n with `/search_suggest_query`.\n\n `android:pathPrefix`\n : The initial part of a URI path for a subset of content provider data.\n Permission can be granted to all data subsets with paths that share this initial part.\n\n `android:pathPattern`\n : A complete URI path for a subset of content provider data,\n but one that can use the following wildcards:\n\n - An asterisk (`*`). This matches a sequence of zero to many occurrences of the immediately preceding character.\n - A period followed by an asterisk (`.*`). This matches any sequence of zero or more characters.\n\n\n Because the backslash (`\\`) is used as an escape character when the string is read\n from XML, before it is parsed as a pattern, you need to double-escape.\n For example, a literal `*` is written as \"`\\\\*`\" and a\n literal `\\` is written as \"`\\\\\\`\". This is\n the same as what you write if constructing the string in the Java programming language.\n\n\n For more information about these types of patterns, see the descriptions of\n [`PATTERN_LITERAL`](/reference/android/os/PatternMatcher#PATTERN_LITERAL),\n [`PATTERN_PREFIX`](/reference/android/os/PatternMatcher#PATTERN_PREFIX), and\n [`PATTERN_SIMPLE_GLOB`](/reference/android/os/PatternMatcher#PATTERN_SIMPLE_GLOB) in the\n [`PatternMatcher`](/reference/android/os/PatternMatcher) class.\n\n `android:permission`\n : The name of a permission that clients need in order to read or write the\n content provider's data. This attribute is a convenient way of setting a\n single permission for both reading and writing. However, the\n `readPermission` and\n `writePermission` attributes take precedence\n over this one.\n\n `android:readPermission`\n : A permission that clients need in order to query the content provider.\n\n `android:writePermission`\n : A permission that clients need in order to make changes to the data controlled by the content provider.\n\nintroduced in:\n: API level 4\n\nsee also:\n: [SearchManager](/reference/android/app/SearchManager)\n: [Manifest.permission](/reference/android/Manifest.permission)\n: [Security tips](/guide/topics/security/security)"]]
