IntentFilter Classe
Definizione
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 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à
- 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
#addDataScheme
e , ).#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 |
SystemLowPriority |
Obsoleti.
Valore del filtro |
Proprietà
Class |
Restituisce la classe di runtime di questo |
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 |
AsPredicateWithTypeResolution(ContentResolver) |
Restituisce un |
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. |