<grant-uri-permission>

Syntaxe :
<grant-uri-permission android:path="string"
                      android:pathPattern="string"
                      android:pathPrefix="string" />
Contenu dans :
<provider>
Description :
Spécifie les sous-ensembles de données d'application auxquels le fournisseur de contenu parent est autorisé à accéder. Les sous-ensembles de données sont indiqués par la partie chemin d'accès d'un URI content:. La partie authority de l'URI identifie le fournisseur de contenu. Accorder cette autorisation permet aux clients du fournisseur qui ne sont normalement pas autorisés à accéder à ses données de contourner cette restriction de façon ponctuelle.

Si l'attribut grantUriPermissions d'un fournisseur de contenu est true, l'autorisation peut être accordée pour toutes les données qui dépendent de ce fournisseur. Toutefois, si cet attribut est false, l'autorisation ne peut être accordée qu'aux sous-ensembles de données spécifiés par cet élément. Un fournisseur peut contenir un nombre illimité d'éléments <grant-uri-permission>. Chacun d'eux ne peut spécifier qu'un seul chemin d'accès, en utilisant un seul des trois attributs possibles.

Pour savoir comment l'autorisation est accordée, consultez l'attribut grantUriPermissions de l'élément <intent-filter>.

Attributs :
android:path
android:pathPrefix
android:pathPattern
Chemin d'accès identifiant le ou les sous-ensembles de données pour lesquels une autorisation peut être accordée. L'attribut path spécifie un chemin d'accès complet. L'autorisation ne peut être accordée qu'au sous-ensemble de données particulier identifié par ce chemin.

L'attribut pathPrefix spécifie la partie initiale d'un chemin d'accès. L'autorisation peut être accordée à tous les sous-ensembles de données dont les chemins d'accès partagent cette même partie initiale. L'attribut pathPattern spécifie un chemin d'accès complet, mais peut contenir les caractères génériques suivants :

  • Un astérisque (*) correspond à une séquence de zéro à plusieurs occurrences du caractère qui précède immédiatement.

  • Un point suivi d'un astérisque (.*) représente une séquence de zéro à plusieurs caractères.

Étant donné que la barre oblique inverse (\) est utilisée en tant que caractère d'échappement lorsque la chaîne est lue à partir d'un fichier XML, vous devez utiliser deux échappements avant qu'elle ne soit analysée en tant que modèle. Par exemple, une valeur littérale * s'écrit \\*, et une valeur littérale \ s'écrit \\\.

Pour en savoir plus sur ces types de schémas, consultez les descriptions de PATTERN_LITERAL, PATTERN_PREFIX, PATTERN_SIMPLE_GLOB et PatternMatcher dans la classe .

Première apparition :
Niveau d'API 1
Voir aussi :
Attribut grantUriPermissions de l'élément <provider>