<grant-uri-permission>

語法：

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

包含於：

說明：

指定可以為其授予父內容提供者許可權的哪些資料子集。資料子集由內容的路徑部分指示：URI。 （URI的許可權部分標識內容提供者。）授予許可權是一種允許通常沒有許可權訪問其資料的提供者的客戶端一次性克服該限制的方法。

如果內容提供者的grantUriPermissions屬性為“true”，則可以為提供者許可權下的任何資料授予許可權。但是，如果該屬性為“false”，則只能授予此元素指定的資料子集的許可權。提供程式可以包含任意數量的<grant-uri-permission>元素。每個只能指定一個路徑（三個可能的屬性中只有一個）。

有關如何授予許可權的資訊，請參閱<intent-filter>元素的grantUriPermissions屬性。

屬性：

android:pathandroid:pathPrefixandroid:pathPattern

標識可以授予許可權的資料子集或子集的路徑。 path屬性指定完整路徑;許可權只能授予該路徑標識的特定資料子集。 pathPrefix屬性指定路徑的初始部分;許可權可以授予具有共享該初始部分的路徑的所有資料子集。 pathPattern屬性指定完整路徑，但可以包含以下萬用字元：

• 星號（'*'）匹配前一個字元的0到多次出現的序列。
• 星號後跟一個句點（“。*”）匹配0到多個字元的任何序列。

因為當從XML讀取字串（在將其解析為模式之前）時，'\'被用作轉義字元，所以您需要雙重轉義：例如，文字'*'將被寫為“\\ *“和字面''將寫成”\\\\“。這與在Java程式碼中構造字串時需要編寫的內容基本相同。

有關這些型別的模式的更多資訊，請參閱PatternMatcher類中的PATTERN_LITERAL，PATTERN_PREFIX和PATTERN_SIMPLE_GLOB的說明。

引入於：

API Level 1

參閱：

<provider>元素的grantUriPermissions屬性