Share via


IntentFilter Classe

Definizione

Descrizione strutturata dei valori finalità da trovare.

[Android.Runtime.Register("android/content/IntentFilter", DoNotGenerateAcw=true)]
public class IntentFilter : Java.Lang.Object, Android.OS.IParcelable, IDisposable, Java.Interop.IJavaPeerable
[<Android.Runtime.Register("android/content/IntentFilter", DoNotGenerateAcw=true)>]
type IntentFilter = class
    inherit Object
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
Ereditarietà
IntentFilter
Attributi
Implementazioni

Commenti

Descrizione strutturata dei valori finalità da corrispondere. Un IntentFilter può corrispondere a azioni, categorie e dati (tramite il relativo tipo, schema e/o percorso) in una finalità. Include anche un valore "priorità" usato per ordinare più filtri corrispondenti.

Gli oggetti IntentFilter vengono spesso creati in XML come parte del file di android.R.styleable#AndroidManifest AndroidManifest.xml un pacchetto usando android.R.styleable#AndroidManifestIntentFilter intent-filter tag.

Esistono tre caratteristiche finalità che è possibile filtrare: l'azione em/>em, <i dati</em>e <le categorie< em/>em>>.<>< Per ognuna di queste caratteristiche è possibile fornire più valori di corrispondenza possibili (rispettivamente tramite #addAction, #addDataAuthority#addDataSchemeSpecificPart#addDataPath#addDataType#addDataSchemee , ).#addCategory Per le azioni, se non vengono specificate caratteristiche dei dati, il filtro corrisponderà solo alle finalità che non contengono dati.

La caratteristica dei dati è divisa in tre attributi: tipo, schema, autorità e percorso. Qualsiasi oggetto specificato deve corrispondere al contenuto della finalità. Se si specifica uno schema ma nessun tipo, solo Finalità che non ha un tipo (ad esempio mailto:) corrisponderà; contenuto: l'URI non corrisponderà mai perché ha sempre un tipo MIME fornito dal provider di contenuto. L'impostazione di un tipo senza schema ha un significato speciale: corrisponderà a un campo Intent senza URI o a una finalità con un contenuto: o un URI. Se non si specifica nessuno, solo una finalità senza dati o tipo corrisponderà. Per specificare un'autorità, è necessario specificare anche uno o più schemi associati. Per specificare un percorso, è necessario specificare anche una o più autorità e uno o più schemi associati.

<div class="special reference"><h3 Developer Guide</h3>>

Per informazioni su come creare e risolvere le finalità, leggere la guida per sviluppatori Finalità e Filtri finalità .

</Div>

<h3>Regole< filtro/h3>

Una corrispondenza si basa sulle regole seguenti. Si noti che per un IntentFilter in modo che corrisponda a un intento, devono essere presenti tre condizioni: l'azione avanzata/>la categoria< complessa/strong> deve corrispondere e <>i dati (sia il>< tipo di< dati sicuro/><>strong che lo schema dati sicuro+authority+path</strong> se specificato) devono corrispondere (vedere #match(ContentResolver, Intent, boolean, String) per altri dettagli sulla corrispondenza dei campi dati).<><

<>strong Action</strong> matches if any of the given values match the Intent action; if the filter specifica no actions, then will only match Intents that do not contain an action.

<Strong>Data Type</strong> corrisponde se uno dei valori specificati corrisponde al tipo intent. Il tipo finalità è determinato chiamando Intent#resolveType. Un carattere jolly può essere usato per il sottotipo MIME, sia in IntentFilter che in IntentFilter, in modo che il tipo "audio/*" corrisponda a "audio/mpeg", "audio/aiff", "audio/*" e così via. <em>Nota che la corrispondenza dei tipi MIME qui è <con>distinzione tra maiuscole< e minuscole/b>, a differenza dei tipi MIME RFC formali.</em> È quindi consigliabile usare sempre lettere minuscole per i tipi MIME.

<strong>Data Scheme</strong> corrisponde se uno dei valori specificati corrisponde allo schema dei dati finalità. Lo schema Finalità viene determinato chiamando Intent#getData e android.net.Uri#getScheme in tale URI. <em>Si noti che lo schema corrispondente qui è <con>distinzione tra maiuscole< e minuscole/b>, a differenza degli schemi RFC formali!</em> È quindi consigliabile usare sempre lettere minuscole per gli schemi.

<>strong Data Scheme Specific Part</strong> matches if any of the given values match the Intent's data scheme specific part <em>and</em> one of the data schemes in the filter has matched the Intent, <em>or</em> no scheme specific parts were supplied in the filter. La parte specifica dello schema finalità è determinata dalla chiamata Intent#getData e android.net.Uri#getSchemeSpecificPart da tale URI. <em>Si noti che la corrispondenza di parti specifiche dello schema fa <>distinzione tra maiuscole< e minuscole/b>.</Em>

<>Attendibilità/corrispondenza assoluta dell'autorità>< dati se uno dei valori specificati corrisponde all'autorità <dati em>e</em> di Intent uno degli schemi dati nel filtro ha corrispondente a Intent, <em>o</em> nessuna autorità è stata fornita nel filtro. L'autorità finalità viene determinata chiamando Intent#getData e android.net.Uri#getAuthority su tale URI. <em>Nota che l'autorità corrispondente qui è <con>distinzione tra maiuscole< e minuscole/b>, a differenza dei nomi host RFC formali.</em> È quindi consigliabile usare sempre lettere minuscole per l'autorità.

<>strong Data Path</strong> matches if any of the given values match the Intent's data path <em>and</em both a scheme and authority> in the filter has matched against the Intent, <em>or</em> no paths were supplied in the filter. L'autorità finalità viene determinata chiamando Intent#getData e android.net.Uri#getPath su tale URI.

<strong>Categories/strong match if em all/em of the categories in the Intent match categories given in the filter.strong Categories</strong> match if <em all></em> of the categories in the Intent match categories given in the filter. Le categorie aggiuntive nel filtro che non si trovano nella finalità non causeranno l'esito negativo della corrispondenza. Si noti che, a differenza dell'azione, un IntentFilter senza categorie corrisponderà solo a una finalità che non ha categorie.

Documentazione java per android.content.IntentFilter.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal Android e usato in base ai termini descritti in 2.5 Attribution License Creative Commons 2.5 Attribution License.

Costruttori

IntentFilter()

Nuovo intentFilter vuoto.

IntentFilter(IntentFilter)

Nuovo IntentFilter contenente una copia di un filtro esistente.

IntentFilter(IntPtr, JniHandleOwnership)

Costruttore usato durante la creazione di rappresentazioni gestite di oggetti JNI; chiamato dal runtime.

IntentFilter(String)

Nuovo IntentFilter che corrisponde a una singola azione senza dati.

IntentFilter(String, String)

Nuovo IntentFilter corrispondente a un'unica azione e tipo di dati.

Campi

SystemHighPriority
Obsoleti.

Valore del filtro #setPriority in corrispondenza del quale vengono posizionati i ricevitori con priorità elevata del sistema, ovvero i ricevitori che devono essere eseguiti prima del codice dell'applicazione.

SystemLowPriority
Obsoleti.

Valore del filtro #setPriority in corrispondenza del quale vengono posizionati i ricevitori con priorità bassa del sistema, ovvero i ricevitori che devono essere eseguiti dopo il codice dell'applicazione.

Proprietà

Class

Restituisce la classe di runtime di questo Objectoggetto .

(Ereditato da Object)
Creator

Descrizione strutturata dei valori finalità da trovare.

Handle

Handle all'istanza di Android sottostante.

(Ereditato da Object)
JniIdentityHashCode

Descrizione strutturata dei valori finalità da trovare.

(Ereditato da Object)
JniPeerMembers

Descrizione strutturata dei valori finalità da trovare.

PeerReference

Descrizione strutturata dei valori finalità da trovare.

(Ereditato da Object)
Priority

Restituisce la priorità di questo filtro. -or- Modificare la priorità di questo filtro.

ThresholdClass

Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice.

ThresholdType

Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice.

Metodi

ActionsIterator()

Restituisce un iteratore sulle azioni del filtro.

AddAction(String)

Aggiungere una nuova azione Intent per la corrispondenza.

AddCategory(String)

Aggiungere una nuova categoria Finalità a cui eseguire la corrispondenza.

AddDataAuthority(String, String)

Aggiungere una nuova autorità dati intenti a cui eseguire la corrispondenza.

AddDataPath(String, Pattern)

Aggiungere un nuovo percorso di dati Finalità da associare.

AddDataScheme(String)

Aggiungere un nuovo schema di dati intento a cui eseguire la corrispondenza.

AddDataSchemeSpecificPart(String, Pattern)

Aggiungere un nuovo tipo di dati intenti "parte specifica dello schema" a cui eseguire la corrispondenza.

AddDataType(String)

Aggiungere un nuovo tipo di dati Intent per la corrispondenza.

AsPredicate()

Restituisce un Predicate oggetto che verifica se questo filtro corrisponde alla finalità</var> specificata<>.

AsPredicateWithTypeResolution(ContentResolver)

Restituisce un Predicate oggetto che verifica se questo filtro corrisponde alla finalità</var> specificata<>.

AuthoritiesIterator()

Restituire un iteratore sulle autorità dei dati del filtro.

CategoriesIterator()

Restituisce un iteratore sulle categorie del filtro.

Clone()

Crea e restituisce una copia di questo oggetto.

(Ereditato da Object)
CountActions()

Restituisce il numero di azioni nel filtro.

CountCategories()

Restituisce il numero di categorie nel filtro.

CountDataAuthorities()

Restituisce il numero di autorità dati nel filtro.

CountDataPaths()

Restituisce il numero di percorsi dati nel filtro.

CountDataSchemes()

Restituisce il numero di schemi di dati nel filtro.

CountDataSchemeSpecificParts()

Restituisce il numero di parti specifiche dello schema di dati nel filtro.

CountDataTypes()

Restituisce il numero di tipi di dati nel filtro.

Create(String, String)

Creare una nuova istanza di IntentFilter con un'azione e un tipo MIME specificati, in cui si conosce che il tipo MIME è formattato correttamente.

DescribeContents()

Descrivere i tipi di oggetti speciali contenuti nella rappresentazione marshalled di Parcelable.

Dispose()

Descrizione strutturata dei valori finalità da trovare.

(Ereditato da Object)
Dispose(Boolean)

Descrizione strutturata dei valori finalità da trovare.

(Ereditato da Object)
Dump(IPrinter, String)

Descrizione strutturata dei valori finalità da trovare.

Equals(Object)

Indica se un altro oggetto è "uguale a" questo.

(Ereditato da Object)
GetAction(Int32)

Restituire un'azione nel filtro.

GetCategory(Int32)

Restituisce una categoria nel filtro.

GetDataAuthority(Int32)

Restituire un'autorità dati nel filtro.

GetDataPath(Int32)

Restituisce un percorso dati nel filtro.

GetDataScheme(Int32)

Restituisce uno schema di dati nel filtro.

GetDataSchemeSpecificPart(Int32)

Restituisce una parte specifica dello schema di dati nel filtro.

GetDataType(Int32)

Restituisce un tipo di dati nel filtro.

GetHashCode()

Restituisce un valore del codice hash per l'oggetto.

(Ereditato da Object)
HasAction(String)

L'azione specificata è inclusa nel filtro? Si noti che se il filtro non include alcuna azione, false verrà <>restituito sempre</em>.

HasCategory(String)

La categoria specificata è inclusa nel filtro?

HasDataAuthority(Uri)

L'autorità dati specificata è inclusa nel filtro? Si noti che se il filtro non include alcuna autorità, false verrà <>restituito sempre</em>.

HasDataPath(String)

Il percorso dati specificato è incluso nel filtro? Si noti che se il filtro non include percorsi, false verrà <>restituito sempre</em>.

HasDataScheme(String)

Lo schema di dati specificato è incluso nel filtro? Si noti che se il filtro non include alcun schema, false verrà <>restituito sempre</em>.

HasDataSchemeSpecificPart(String)

La parte specifica dello schema di dati specificato è inclusa nel filtro? Si noti che se il filtro non include parti specifiche dello schema, false verrà <>restituito sempre</em>.

HasDataType(String)

Il tipo di dati specificato è incluso nel filtro? Si noti che se il filtro non include alcun tipo, false verrà <>restituito sempre</em>.

JavaFinalize()

Chiamato dal Garbage Collector in un oggetto quando Garbage Collection determina che non sono presenti più riferimenti all'oggetto.

(Ereditato da Object)
Match(ContentResolver, Intent, Boolean, String)

Verificare se questo filtro corrisponde alla finalità/var> specificata<>.<

Match(String, String, String, Uri, ICollection<String>, String)

Verificare se questo filtro corrisponde ai dati di finalità specificati.

MatchAction(String)

Corrisponde a questo filtro rispetto all'azione di una finalità.

MatchCategories(ICollection<String>)

Corrisponde a questo filtro rispetto alle categorie di intenti.

MatchData(String, String, Uri)

Corrisponde a questo filtro rispetto ai dati di una finalità (tipo, schema e percorso).

MatchDataAuthority(Uri)

Corrisponde a questo filtro finalità rispetto ai dati finalità specificati.

Notify()

Riattiva un singolo thread in attesa del monitoraggio dell'oggetto.

(Ereditato da Object)
NotifyAll()

Riattiva tutti i thread in attesa del monitoraggio dell'oggetto.

(Ereditato da Object)
PathsIterator()

Restituisce un iteratore sui percorsi dei dati del filtro.

ReadFromXml(XmlReader)

Descrizione strutturata dei valori finalità da trovare.

SchemesIterator()

Restituisce un iteratore sugli schemi di dati del filtro.

SchemeSpecificPartsIterator()

Restituisce un iteratore sulle parti specifiche dello schema di dati del filtro.

SetHandle(IntPtr, JniHandleOwnership)

Imposta la proprietà Handle.

(Ereditato da Object)
ToArray<T>()

Descrizione strutturata dei valori finalità da trovare.

(Ereditato da Object)
ToString()

Restituisce una rappresentazione in formato stringa dell'oggetto.

(Ereditato da Object)
TypesIterator()

Restituisce un iteratore sui tipi di dati del filtro.

UnregisterFromRuntime()

Descrizione strutturata dei valori finalità da trovare.

(Ereditato da Object)
Wait()

Causa l'attesa del thread corrente fino a quando non viene svegliata, in genere eseguendo>una notifica</em o <em interrotto</>em>>.<

(Ereditato da Object)
Wait(Int64)

Causa l'attesa del thread corrente fino a quando non viene svegliata, in genere <>eseguendo una notifica</em o <em interrotto/>>em>o fino a quando non è trascorsa< una determinata quantità di tempo reale.

(Ereditato da Object)
Wait(Int64, Int32)

Causa l'attesa del thread corrente fino a quando non viene svegliata, in genere <>eseguendo una notifica</em o <em interrotto/>>em>o fino a quando non è trascorsa< una determinata quantità di tempo reale.

(Ereditato da Object)
WriteToParcel(Parcel, ParcelableWriteFlags)

Appiattire questo oggetto in un pacchetto.

WriteToXml(IXmlSerializer)

Scrivere il contenuto di IntentFilter come flusso XML.

Implementazioni dell'interfaccia esplicita

IJavaPeerable.Disposed()

Descrizione strutturata dei valori finalità da trovare.

(Ereditato da Object)
IJavaPeerable.DisposeUnlessReferenced()

Descrizione strutturata dei valori finalità da trovare.

(Ereditato da Object)
IJavaPeerable.Finalized()

Descrizione strutturata dei valori finalità da trovare.

(Ereditato da Object)
IJavaPeerable.JniManagedPeerState

Descrizione strutturata dei valori finalità da trovare.

(Ereditato da Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)

Descrizione strutturata dei valori finalità da trovare.

(Ereditato da Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

Descrizione strutturata dei valori finalità da trovare.

(Ereditato da Object)
IJavaPeerable.SetPeerReference(JniObjectReference)

Descrizione strutturata dei valori finalità da trovare.

(Ereditato da Object)

Metodi di estensione

JavaCast<TResult>(IJavaObject)

Esegue una conversione dei tipi controllati dal runtime Android.

JavaCast<TResult>(IJavaObject)

Descrizione strutturata dei valori finalità da trovare.

GetJniTypeName(IJavaPeerable)

Descrizione strutturata dei valori finalità da trovare.

Si applica a