語法：

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

包含於：

<provider>

說明：

指定父項內容供應者有權存取的應用程式資料。資料內容會以 content: URI 的路徑部分表示。(URI 的授權部分會標識內容供應者)。授予相關權限的方式，可讓提供者內原本無權存取其資料的用戶端擁有一次存取機會。

如果內容供應者的 grantUriPermissions 屬性為「true」，則會授予對提供者名下所有資料的存取權限。但是，如果該屬性是「false」，則只能授予對該元素所指定資料內容的存取權限。提供者可包含任意數量的 <grant-uri-permission> 元素。每個元素都只能指定一個路徑 (只能指定三種可能屬性中的一個)。

如要瞭解如何授予權限，請參閱 <intent-filter> 元素的 grantUriPermissions 屬性。

屬性：

android:path
android:pathPrefix
android:pathPattern

標識可授予權限的資料內容的路徑。path 屬性指定完整路徑；只能向該路徑標識的特定資料內容授予權限。pathPrefix 屬性指定路徑的初始部分；對於路徑中包含該初始部分的所有資料內容，均可授予權限。pathPattern 屬性指定完整路徑，但可包含以下萬用字元：

• 星號 (「*」) 會將一個 0 序列比對到多次出現的前一個字元。

• 星號後跟一個點 (「.*」) 會將所有 0 序列比對到許多字元。

由於在從 XML 讀取字串時，會使用「\」做為逸出字元 (在其剖析為模式前)，因此您需要進行雙重逸出：例如，常值「*」將寫入為「\\*」，常值「\」寫入為「\\\\」。當以 Java 程式碼建構字串時，寫入規則基本相同。

如要進一步瞭解這些模式，請參閱 PatternMatcher 類別中 PATTERN_LITERAL、PATTERN_PREFIX 和 PATTERN_SIMPLE_GLOB 的說明。

導入版本：

API 級別 1

另請參閱：

<provider> 元素的 grantUriPermissions 屬性