<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> 元素。每個元素都只能指定一個路徑，使用三種可能屬性中的一種。

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

屬性：
android:path
android:pathPrefix
android:pathPattern
標識可授權資料子集的路徑。path 屬性會指定完整路徑。您只能針對該路徑標識的資料子集授予權限。

pathPrefix 屬性會指定路徑的初始部分。您可以針對路徑初始部分相同的所有資料子集授予權限。pathPattern 屬性會指定完整路徑，但可包含以下萬用字元：

  • 星號 (*)，代表前一個字元出現 0 次以上的序列。

  • 半形句號後面加上星號 (.*)，代表 0 個字元以上的任何序列。

由於在從 XML 讀取字串時，系統會使用「\」做為逸出字元，因此在剖析為模式之前，您必須先進行雙重逸出。例如，將常值「*」寫入為「\\*」，常值「\」寫入為 \\\。

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

導入版本：
API 級別 1
另請參閱：
<provider> 元素的 grantUriPermissions 屬性