<grant-uri-permission>

نحو:

<grant-uri-permission android:path="string"
                      android:pathPattern="string"
                      android:pathPrefix="string" />

موجود در:

<provider>

توضیحات:

زیرمجموعه‌های داده‌های برنامه را مشخص می‌کند که ارائه‌دهنده محتوای والد اجازه دسترسی به آنها را دارد. زیر مجموعه داده ها با قسمت مسیر یک content: URI. بخش مرجع URI ارائه دهنده محتوا را شناسایی می کند. اعطای مجوز روشی است برای قادر ساختن مشتریان ارائه‌دهنده که معمولاً مجوز دسترسی به داده‌های آن را ندارند تا بر این محدودیت به‌صورت یک‌باره غلبه کنند.

اگر ویژگی grantUriPermissions ارائه‌دهنده محتوا true باشد، می‌توان برای هر یک از داده‌های تحت اختیار ارائه‌دهنده مجوز اعطا کرد. با این حال، اگر آن ویژگی false باشد، مجوز فقط به زیرمجموعه‌های داده‌ای که توسط این عنصر مشخص شده‌اند اعطا می‌شود. یک ارائه‌دهنده می‌تواند حاوی هر تعداد عنصر <grant-uri-permission> باشد. هر یک می تواند تنها یک مسیر را با استفاده از یکی از سه ویژگی ممکن مشخص کند.

برای اطلاعات در مورد نحوه اعطای مجوز، ویژگی grantUriPermissions عنصر <intent-filter> را ببینید.

صفات:

android:path
android:pathPrefix
android:pathPattern

مسیری که زیرمجموعه داده یا زیرمجموعه هایی را شناسایی می کند که می توان برای آنها مجوز اعطا کرد. ویژگی path یک مسیر کامل را مشخص می کند. مجوز فقط می تواند به زیرمجموعه داده خاص مشخص شده توسط آن مسیر اعطا شود.

ویژگی pathPrefix قسمت اولیه یک مسیر را مشخص می کند. می توان به همه زیرمجموعه های داده با مسیرهایی که آن قسمت اولیه را به اشتراک می گذارد، مجوز داد. ویژگی pathPattern یک مسیر کامل را مشخص می‌کند، اما مسیری که می‌تواند شامل حروف عام زیر باشد:

• یک ستاره ( * ) دنباله ای از صفر را با بسیاری از اتفاقات نویسه بلافاصله قبل مطابقت می دهد.

• نقطه به دنبال ستاره ( .* ) با هر دنباله ای از صفر تا بسیاری از نویسه ها مطابقت دارد.

از آنجا که \ به عنوان یک کاراکتر escape هنگام خواندن رشته از XML استفاده می شود، قبل از اینکه به عنوان یک الگو تجزیه شود، باید دوبار escape کنید. به عنوان مثال، یک * تحت اللفظی به صورت \\* و یک \ تحت اللفظی به صورت \\\ نوشته می شود.

برای اطلاعات بیشتر در مورد این نوع الگوها، به توضیحات PATTERN_LITERAL ، PATTERN_PREFIX ، و PATTERN_SIMPLE_GLOB در کلاس PatternMatcher مراجعه کنید.

معرفی شده در:

API سطح 1

همچنین ببینید:

ویژگی grantUriPermissions عنصر <provider>