IntentFilter Classe

Riferimento

Definizione

Spazio dei nomi:: Android.Content

Assembly:: Mono.Android.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Descrizione strutturata dei valori delle finalità da trovare in corrispondenza.

[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à: Object

Object
IntentFilter

Attributi: RegisterAttribute

Implementazioni: IParcelable IJavaObject IJavaPeerable IDisposable

Commenti

Descrizione strutturata dei valori delle finalità da trovare in corrispondenza. IntentFilter può corrispondere a azioni, categorie e dati (tramite il tipo, lo schema e/o il percorso) in una finalità. Include anche un valore "priority" 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 della finalità che è possibile filtrare: l'azione em/em>>, data e <le categorie< em/em>>.<< Per ognuna di queste caratteristiche è possibile specificare più valori corrispondenti possibili (rispettivamente tramite #addAction, , #addDataPath#addDataSchemeSpecificPart#addDataAuthority#addDataType#addDataSchemee ).#addCategory Per le azioni, se non vengono specificate caratteristiche di dati, il filtro corrisponderà solo alle finalità che non contengono dati.

La caratteristica dei dati è suddivisa in tre attributi: tipo, schema, autorità e percorso. Tutti gli elementi specificati devono corrispondere al contenuto della finalità. Se si specifica uno schema ma nessun tipo, solo Intent che non ha un tipo (ad esempio mailto:) corrisponderà; un contenuto: l'URI non corrisponderà mai perché ha sempre un tipo MIME fornito dal provider di contenuti. Specificare un tipo senza schema ha un significato particolare: corrisponderà a un campo Intent senza URI o a un intento con contenuto: o file: URI. Se non si specificano nessuna delle due opzioni, solo una finalità senza dati o tipo corrisponderà. Per specificare un'autorità, è necessario specificare anche uno o più schemi a cui è associato. Per specificare un percorso, è inoltre necessario specificare una o più autorità e uno o più schemi a cui è associato.

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

Per informazioni su come creare e risolvere le finalità, vedere la Guida per sviluppatori intenti 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 una finalità, devono essere presenti tre condizioni: l'azione avanzata/>categoria avanzata/strong> deve corrispondere e<<> i dati (sia il tipo di< dati sicuro che>>< lo <>schema dati sicuro+authority+path se specificato) devono corrispondere (vedere #match(ContentResolver, Intent, boolean, String) per altri dettagli sul modo in cui i campi dati corrispondono).<><

Action match 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.

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

Data Scheme corrisponde se uno dei valori specificati corrisponde allo schema dei dati intenti. Lo schema finalità è determinato dalla chiamata Intent#getData e android.net.Uri#getScheme da tale URI. Si noti che la corrispondenza dello schema qui è <distinzione tra>maiuscole< e minuscole/b>, a differenza degli schemi RFC formali! È quindi consigliabile usare sempre lettere minuscole per gli schemi.

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

Data Authority match if any of the given values match the Intent's data authority and one of the data schemes in the filter has matched the Intent, or no authority were supplied in the filter. L'autorità finalità viene determinata chiamando Intent#getData e android.net.Uri#getAuthority su tale URI. Nota che l'autorità corrispondente qui è con distinzione tra maiuscole< e minuscole/b>, a differenza dei nomi host RFC formali! È quindi consigliabile usare sempre lettere minuscole per l'autorità.

Data Path match se uno dei valori specificati corrisponde al percorso <dati della finalità em>e sia uno schema che un'autorità nel filtro hanno corrispondenze con finalità, o non sono stati specificati percorsi nel filtro. L'autorità finalità viene determinata chiamando Intent#getData e android.net.Uri#getPath su tale URI.

Categories/strong match if em all/em of the categories in the Intent match categories given in the filter.strong Categories match if > 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 progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.

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 che corrisponde a una singola azione e a un tipo di dati.

Campi

SystemHighPriority	Obsoleti. Valore del filtro `#setPriority` in corrispondenza del quale vengono posizionati i ricevitori ad alta priorità di 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 `Object`oggetto . (Ereditato da Object)
Creator	Descrizione strutturata dei valori delle finalità da trovare in corrispondenza.
Handle	Handle per l'istanza di Android sottostante. (Ereditato da Object)
JniIdentityHashCode	Descrizione strutturata dei valori delle finalità da trovare in corrispondenza. (Ereditato da Object)
JniPeerMembers	Descrizione strutturata dei valori delle finalità da trovare in corrispondenza.
PeerReference	Descrizione strutturata dei valori delle finalità da trovare in corrispondenza. (Ereditato da Object)
Priority	Restituisce la priorità di questo filtro. -oppure- 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à in base alla quale eseguire la corrispondenza.
AddDataAuthority(String, String)	Aggiungere una nuova autorità dati finalità a cui eseguire la corrispondenza.
AddDataPath(String, Pattern)	Aggiungere un nuovo percorso dati finalità a cui trovare una corrispondenza.
AddDataScheme(String)	Aggiungere un nuovo schema di dati finalità per la corrispondenza.
AddDataSchemeSpecificPart(String, Pattern)	Aggiungere un nuovo "schema specifico part" dei dati finalità per la corrispondenza.
AddDataType(String)	Aggiungere un nuovo tipo di dati Intent per la corrispondenza.
AsPredicate()	Restituisce un oggetto `Predicate` che verifica se questo filtro corrisponde alla finalità</var>> specificata<.
AsPredicateWithTypeResolution(ContentResolver)	Restituisce un oggetto `Predicate` che verifica se questo filtro corrisponde alla finalità</var>> specificata<.
AuthoritiesIterator()	Restituisce un iteratore sulle autorità 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 dati nel filtro.
CountDataSchemeSpecificParts()	Restituisce il numero di parti specifiche dello schema dati nel filtro.
CountDataTypes()	Restituisce il numero di tipi di dati nel filtro.
Create(String, String)	Creare una nuova istanza intentFilter con un'azione e un tipo MIME specificati, in cui si sa che il tipo MIME è formattato correttamente.
DescribeContents()	Descrivere i tipi di oggetti speciali contenuti nella rappresentazione con marshalling di questo oggetto Parcelable.
Dispose()	Descrizione strutturata dei valori delle finalità da trovare in corrispondenza. (Ereditato da Object)
Dispose(Boolean)	Descrizione strutturata dei valori delle finalità da trovare in corrispondenza. (Ereditato da Object)
Dump(IPrinter, String)	Descrizione strutturata dei valori delle finalità da trovare in corrispondenza.
Equals(Object)	Indica se un altro oggetto è "uguale a" questo. (Ereditato da Object)
GetAction(Int32)	Restituisce un'azione nel filtro.
GetCategory(Int32)	Restituisce una categoria nel filtro.
GetDataAuthority(Int32)	Restituisce 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 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 fonti, 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 dati specificato è incluso nel filtro? Si noti che se il filtro non include alcuno schema, false verrà <>restituito sempre</em>.
HasDataSchemeSpecificPart(String)	La parte specifica dello schema 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 su un oggetto quando Garbage Collection determina che non sono presenti altri 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)	Trova la corrispondenza di questo filtro rispetto all'azione di una finalità.
MatchCategories(ICollection<String>)	Trova la corrispondenza di questo filtro rispetto alle categorie di una finalità.
MatchData(String, String, Uri)	Trova la corrispondenza di questo filtro rispetto ai dati di una finalità (tipo, schema e percorso).
MatchDataAuthority(Uri)	Trova la corrispondenza di questo filtro finalità rispetto ai dati di finalità specificati.
Notify()	Riattiva un singolo thread in attesa del monitor dell'oggetto. (Ereditato da Object)
NotifyAll()	Riattiva tutti i thread in attesa del monitor dell'oggetto. (Ereditato da Object)
PathsIterator()	Restituisce un iteratore sui percorsi dei dati del filtro.
ReadFromXml(XmlReader)	Descrizione strutturata dei valori delle finalità da trovare in corrispondenza.
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 delle finalità da trovare in corrispondenza. (Ereditato da Object)
ToString()	Restituisce una rappresentazione di stringa dell'oggetto. (Ereditato da Object)
TypesIterator()	Restituisce un iteratore sui tipi di dati del filtro.
UnregisterFromRuntime()	Descrizione strutturata dei valori delle finalità da trovare in corrispondenza. (Ereditato da Object)
Wait()	Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo <>una notifica</em> o <em>interrotto</em>. (Ereditato da Object)
Wait(Int64)	Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo>< 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)	Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo>< 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 pacco.
WriteToXml(IXmlSerializer)	Scrivere il contenuto di IntentFilter come flusso XML.

Implementazioni dell'interfaccia esplicita

IJavaPeerable.Disposed()	Descrizione strutturata dei valori delle finalità da trovare in corrispondenza. (Ereditato da Object)
IJavaPeerable.DisposeUnlessReferenced()	Descrizione strutturata dei valori delle finalità da trovare in corrispondenza. (Ereditato da Object)
IJavaPeerable.Finalized()	Descrizione strutturata dei valori delle finalità da trovare in corrispondenza. (Ereditato da Object)
IJavaPeerable.JniManagedPeerState	Descrizione strutturata dei valori delle finalità da trovare in corrispondenza. (Ereditato da Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Descrizione strutturata dei valori delle finalità da trovare in corrispondenza. (Ereditato da Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Descrizione strutturata dei valori delle finalità da trovare in corrispondenza. (Ereditato da Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Descrizione strutturata dei valori delle finalità da trovare in corrispondenza. (Ereditato da Object)

Metodi di estensione

JavaCast<TResult>(IJavaObject)	Esegue una conversione del tipo di tipo controllato dal runtime Android.
JavaCast<TResult>(IJavaObject)	Descrizione strutturata dei valori delle finalità da trovare in corrispondenza.
GetJniTypeName(IJavaPeerable)	Descrizione strutturata dei valori delle finalità da trovare in corrispondenza.

Si applica a

Condividi tramite