<grant-uri-permission>

sintassi:
<grant-uri-permission android:path="string"
                      android:pathPattern="string"
                      android:pathPrefix="string" />
contenuto in:
<provider>
description:
Specifica i sottoinsiemi di dati dell'app che il fornitore di contenuti principale dispone dell'autorizzazione di accesso. I sottoinsiemi di dati sono indicati dalla parte del percorso di un URI content:. La parte autorevole dell'URI identifica fornitore di contenuti. La concessione dell'autorizzazione consente di abilitare i client del provider normalmente hanno l'autorizzazione ad accedere ai propri dati per superare questa restrizione una tantum.

Se grantUriPermissions del fornitore di contenuti è true, l'autorizzazione può essere concessa per qualsiasi dato in la portata del provider. Tuttavia, se questo attributo è false, l'autorizzazione viene concesso solo ai sottoinsiemi di dati specificati da questo elemento. Un provider può contenere un numero illimitato di elementi <grant-uri-permission>. Ciascuno di essi può specificare un solo percorso, utilizzando uno dei tre attributi possibili.

Per informazioni su come viene concessa l'autorizzazione, consulta la Di <intent-filter> elemento Attributo grantUriPermissions.

attributi:
android:path
android:pathPrefix
android:pathPattern
Un percorso che identifica il sottoinsieme o i sottoinsiemi di dati a cui è possibile eseguire l'autorizzazione per i quali è stato concesso. L'attributo path specifica un percorso completo. L'autorizzazione può essere concessa solo al sottoinsieme di dati identificato lungo questo percorso.

L'attributo pathPrefix specifica la parte iniziale di un percorso. L'autorizzazione può essere concessa a tutti i sottoinsiemi di dati con percorsi che lo condividono parte iniziale. L'attributo pathPattern specifica un percorso completo, ma uno che possono contenere i seguenti caratteri jolly:

  • Un asterisco (*) corrisponde a una sequenza da zero a molte occorrenze di il carattere immediatamente precedente.

  • Un punto seguito da un asterisco (.*) corrisponde a qualsiasi sequenza di da zero a molti caratteri.

Perché \ viene utilizzato come carattere di escape quando viene letta la stringa da XML, prima che venga analizzato come pattern, è necessario eseguire un doppio escape. Ad esempio, il valore letterale * viene scritto come \\* e un il valore letterale \ è scritto come \\\.

Per ulteriori informazioni su questi tipi di pattern, consulta le descrizioni PATTERN_LITERAL, PATTERN_PREFIX e PATTERN_SIMPLE_GLOB nel PatternMatcher corso.

introdotto in:
Livello API 1
vedi anche:
grantUriPermissions attributo del <provider> elemento