IntentFilter Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Strukturierte Beschreibung der zuzuordnenden Intent-Werte.
[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- Vererbung
- Attribute
- Implementiert
Hinweise
Strukturierte Beschreibung der zuzuordnenden Intent-Werte. Ein IntentFilter kann mit Aktionen, Kategorien und Daten (entweder über den Typ, das Schema und/oder den Pfad) in einer Absicht übereinstimmen. Sie enthält auch einen "Prioritätswert", der verwendet wird, um mehrere übereinstimmende Filter zu sortieren.
IntentFilter-Objekte werden häufig in XML als Teil der Datei eines Pakets android.R.styleable#AndroidManifest AndroidManifest.xml mithilfe von android.R.styleable#AndroidManifestIntentFilter intent-filter Tags erstellt.
Es gibt drei Intent-Merkmale, nach denen Sie filtern können: die <Em-Aktion></em>, <em-Daten<>/Em> und <em-Kategorien></em.> Für jedes dieser Merkmale können Sie mehrere mögliche übereinstimmende Werte (via #addAction, , #addDataType, #addDataScheme, #addDataSchemeSpecificPart#addDataAuthority, #addDataPath, , bzw#addCategory. ) angeben. Wenn für Aktionen keine Datenmerkmale angegeben werden, stimmt der Filter nur mit Absichten überein, die keine Daten enthalten.
Das Datenmerkmal ist selbst in drei Attribute unterteilt: Typ, Schema, Autorität und Pfad. Alle angegebenen Elemente müssen mit dem Inhalt der Absicht übereinstimmen. Wenn Sie ein Schema, aber keinen Typ angeben, stimmt nur "Intent", der keinen Typ hat (z. B. mailto:) überein; ein Inhalt: Der URI stimmt nie überein, da er immer einen MIME-Typ aufweist, der vom Inhaltsanbieter bereitgestellt wird. Die Angabe eines Typs ohne Schema hat etwas besondere Bedeutung: Er entspricht entweder einem Intent ohne URI-Feld oder einer Absicht mit einem Inhalt: oder datei: URI. Wenn Sie keines angeben, stimmen nur "Intent" ohne Daten oder Typ überein. Um eine Autorität anzugeben, müssen Sie auch ein oder mehrere Schemas angeben, denen sie zugeordnet ist. Um einen Pfad anzugeben, müssen Sie auch eine oder mehrere Behörden und mindestens ein Schema angeben, dem er zugeordnet ist.
<div class="special reference"><h3>Developer Guides</h3>
Informationen zum Erstellen und Auflösen von Absichten finden Sie im Entwicklerhandbuch "Intents" und "Intent Filters" .
</Div>
<h3>Filterregeln</h3>
Eine Übereinstimmung basiert auf den folgenden Regeln. Beachten Sie, dass für einen IntentFilter, der einem Intent entspricht, drei Bedingungen enthalten müssen: die starke Aktion/starke> und <starke Kategorie/starke>Kategorie</Starke> muss übereinstimmen, und die Daten (sowohl der starke>Datentyp</>starke <als <auch das starke>Datenschema+Autorität+Pfad/stark><, falls angegeben) müssen übereinstimmen (weitere #match(ContentResolver, Intent, boolean, String) Informationen dazu, wie die Datenfelder übereinstimmen).<><
<starke>Aktions<-/starke> Übereinstimmungen, wenn einer der angegebenen Werte der Intent-Aktion entspricht. Wenn der Filter keine Aktionen angibt, stimmt er nur mit Intents überein, die keine Aktion enthalten.
<starke>Datentyp<-/starke> Übereinstimmungen, wenn einer der angegebenen Werte mit dem Intent-Typ übereinstimmt. Der Intent-Typ wird durch Aufrufen Intent#resolveTypebestimmt. Ein Wildcard kann für den MIME-Untertyp sowohl im Intent- als auch im IntentFilter verwendet werden, sodass der Typ "audio/*" mit "audio/mpeg", "audio/aiff", "audio/*" usw. übereinstimmt. <em>Beachten Sie, dass der MIME-Typabgleich hier b<> groß/b> ist<, im Gegensatz zu formalen RFC MIME-Typen!</em> Sie sollten daher immer Kleinbuchstaben für Ihre MIME-Typen verwenden.
<starke>Datenschema<-/starke> Übereinstimmungen, wenn einer der angegebenen Werte mit dem Schema der Intent-Daten übereinstimmt. Das Intent-Schema wird durch Aufrufen Intent#getData und android.net.Uri#getScheme Für diesen URI bestimmt. <em>Beachten Sie, dass der Schemaabgleich hier b<> groß/b> ist<, im Gegensatz zu formalen RFC-Schemas!</em> Sie sollten daher immer Kleinbuchstaben für Ihre Schemas verwenden.
<starke>Datenschemaspezifische Teile</starke> Übereinstimmungen, wenn einer der angegebenen Werte mit dem Datenschema-spezifischen Teil <em>und</em> eines der Datenschemas im Filter mit dem Intent übereinstimmt, <em>oder< em> keine schemaspezifischen Teile im Filter angegeben wurden. Der spezifische Teil des Intent-Schemas wird durch Aufrufen Intent#getData und android.net.Uri#getSchemeSpecificPart Für diesen URI bestimmt. <em>Beachten Sie, dass bei schemaspezifischem Teilabgleich <die>Groß-/Kleinschreibung beachtet< wird/b>.</Em>
<starke>Datenautorität</starke> Übereinstimmungen, wenn einer der angegebenen Werte mit der Data Authority <em>und</em> des Intent eines der Datenschemas im Filter mit dem Intent übereinstimmt, <em>oder< em> keine Autoritäten im Filter angegeben wurden. Die Intent-Autorität wird durch Aufrufen Intent#getData und android.net.Uri#getAuthority Für diesen URI bestimmt. <em>Beachten Sie, dass die Übereinstimmung der Autorität hier b>groß</b> ist<, im Gegensatz zu formalen RFC-Hostnamen!</em> Sie sollten daher immer Kleinbuchstaben für Ihre Autorität verwenden.
<starke>Datenpfad<-/starke> Übereinstimmungen, wenn einer der angegebenen Werte dem Datenpfad <em>und/em> des Intent entspricht,< sowohl ein Schema als auch eine Autorität im Filter mit dem Intent, em>oder< em> übereinstimmen, <wurden keine Pfade im Filter angegeben. Die Intent-Autorität wird durch Aufrufen Intent#getData und android.net.Uri#getPath Für diesen URI bestimmt.
<starke>Kategorien</starke> Übereinstimmung, wenn <alle<>/em> der Kategorien in den im Filter angegebenen Kategorien übereinstimmen. Zusätzliche Kategorien im Filter, die sich nicht in der Absicht befinden, führen nicht dazu, dass die Übereinstimmung fehlschlägt. Beachten Sie, dass ein IntentFilter ohne Kategorien nur mit einer Absicht übereinstimmt, die keine Kategorien enthält.
Java-Dokumentation für android.content.IntentFilter.
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.
Konstruktoren
| IntentFilter() |
Neuer leerer IntentFilter. |
| IntentFilter(IntentFilter) |
Neuer IntentFilter, der eine Kopie eines vorhandenen Filters enthält. |
| IntentFilter(IntPtr, JniHandleOwnership) |
Ein Konstruktor, der beim Erstellen verwalteter Darstellungen von JNI-Objekten verwendet wird; wird von der Laufzeit aufgerufen. |
| IntentFilter(String) |
Neuer IntentFilter, der einer einzelnen Aktion ohne Daten entspricht. |
| IntentFilter(String, String) |
Neuer IntentFilter, der einer einzelnen Aktion und einem einzelnen Datentyp entspricht. |
Felder
| SystemHighPriority |
Veraltet.
Der Filterwert |
| SystemLowPriority |
Veraltet.
Der Filterwert |
Eigenschaften
| Class |
Gibt die Laufzeitklasse dieses Werts |
| Creator |
Strukturierte Beschreibung der zuzuordnenden Intent-Werte. |
| Handle |
Das Handle für die zugrunde liegende Android-Instanz. (Geerbt von Object) |
| JniIdentityHashCode |
Strukturierte Beschreibung der zuzuordnenden Intent-Werte. (Geerbt von Object) |
| JniPeerMembers |
Strukturierte Beschreibung der zuzuordnenden Intent-Werte. |
| PeerReference |
Strukturierte Beschreibung der zuzuordnenden Intent-Werte. (Geerbt von Object) |
| Priority |
Gibt die Priorität dieses Filters zurück. -oder- Die Priorität dieses Filters ändern. |
| ThresholdClass |
Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. |
| ThresholdType |
Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. |
Methoden
| ActionsIterator() |
Gibt einen Iterator für die Aktionen des Filters zurück. |
| AddAction(String) |
Fügen Sie eine neue Intent-Aktion hinzu, mit der abgeglichen werden soll. |
| AddCategory(String) |
Fügen Sie eine neue Intent-Kategorie hinzu, mit der abgeglichen werden soll. |
| AddDataAuthority(String, String) |
Fügen Sie eine neue Intent-Datenautorität hinzu, mit der abgeglichen werden soll. |
| AddDataPath(String, Pattern) |
Fügen Sie einen neuen Intent-Datenpfad hinzu, mit dem abgeglichen werden soll. |
| AddDataScheme(String) |
Fügen Sie ein neues Intent-Datenschema hinzu, mit dem abgeglichen werden soll. |
| AddDataSchemeSpecificPart(String, Pattern) |
Fügen Sie eine neue Intent-Daten "schemaspezifische Komponente" hinzu, mit der abgeglichen werden soll. |
| AddDataType(String) |
Fügen Sie einen neuen Intent-Datentyp hinzu, mit dem abgeglichen werden soll. |
| AsPredicate() |
Gibt einen |
| AsPredicateWithTypeResolution(ContentResolver) |
Gibt einen |
| AuthoritiesIterator() |
Geben Sie einen Iterator für die Datenbehörden des Filters zurück. |
| CategoriesIterator() |
Geben Sie einen Iterator für die Kategorien des Filters zurück. |
| Clone() |
Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object) |
| CountActions() |
Gibt die Anzahl der Aktionen im Filter zurück. |
| CountCategories() |
Gibt die Anzahl der Kategorien im Filter zurück. |
| CountDataAuthorities() |
Gibt die Anzahl der Datenquellen im Filter zurück. |
| CountDataPaths() |
Gibt die Anzahl der Datenpfade im Filter zurück. |
| CountDataSchemes() |
Gibt die Anzahl der Datenschemas im Filter zurück. |
| CountDataSchemeSpecificParts() |
Gibt die Anzahl der datenschemaspezifischen Teile im Filter zurück. |
| CountDataTypes() |
Gibt die Anzahl der Datentypen im Filter zurück. |
| Create(String, String) |
Erstellen Sie eine neue IntentFilter-Instanz mit einer angegebenen Aktion und einem MIME-Typ, in dem Sie wissen, dass der MIME-Typ richtig formatiert ist. |
| DescribeContents() |
Beschreiben Sie die Arten von speziellen Objekten, die in der Marshalldarstellung dieser Paketable enthalten sind. |
| Dispose() |
Strukturierte Beschreibung der zuzuordnenden Intent-Werte. (Geerbt von Object) |
| Dispose(Boolean) |
Strukturierte Beschreibung der zuzuordnenden Intent-Werte. (Geerbt von Object) |
| Dump(IPrinter, String) |
Strukturierte Beschreibung der zuzuordnenden Intent-Werte. |
| Equals(Object) |
Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist. (Geerbt von Object) |
| GetAction(Int32) |
Zurückgeben einer Aktion im Filter. |
| GetCategory(Int32) |
Gibt eine Kategorie im Filter zurück. |
| GetDataAuthority(Int32) |
Gibt eine Datenautorität im Filter zurück. |
| GetDataPath(Int32) |
Gibt einen Datenpfad im Filter zurück. |
| GetDataScheme(Int32) |
Gibt ein Datenschema im Filter zurück. |
| GetDataSchemeSpecificPart(Int32) |
Zurückgeben eines datenschemaspezifischen Teils im Filter. |
| GetDataType(Int32) |
Gibt einen Datentyp im Filter zurück. |
| GetHashCode() |
Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object) |
| HasAction(String) |
Ist die angegebene Aktion im Filter enthalten? Wenn der Filter keine Aktionen enthält, wird <"false">immer</em> zurückgegeben. |
| HasCategory(String) |
Ist die angegebene Kategorie im Filter enthalten? |
| HasDataAuthority(Uri) |
Ist die angegebene Datenautorität im Filter enthalten? Wenn der Filter keine Rechtsgrundlagen enthält, wird <"false" immer></em> zurückgegeben. |
| HasDataPath(String) |
Ist der angegebene Datenpfad im Filter enthalten? Wenn der Filter keine Pfade enthält, wird <"false" immer></em> zurückgegeben. |
| HasDataScheme(String) |
Ist das angegebene Datenschema im Filter enthalten? Wenn der Filter kein Schema enthält, wird <"false">immer</em> zurückgegeben. |
| HasDataSchemeSpecificPart(String) |
Ist der angegebene Datenschema-spezifische Teil im Filter enthalten? Wenn der Filter keine schemaspezifischen Teile enthält, wird <"false">immer</em> zurückgegeben. |
| HasDataType(String) |
Ist der angegebene Datentyp im Filter enthalten? Wenn der Filter keinen Typ enthält, wird <"false">immer</em> zurückgegeben. |
| JavaFinalize() |
Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind. (Geerbt von Object) |
| Match(ContentResolver, Intent, Boolean, String) |
Testen Sie, ob dieser Filter dem angegebenen <Var-Intent></Var> entspricht. |
| Match(String, String, String, Uri, ICollection<String>, String) |
Testen Sie, ob dieser Filter den angegebenen Absichtsdaten entspricht. |
| MatchAction(String) |
Stimmen Sie diesen Filter mit der Aktion einer Absicht überein. |
| MatchCategories(ICollection<String>) |
Stimmen Sie diesen Filter mit den Kategorien einer Absicht überein. |
| MatchData(String, String, Uri) |
Stimmen Sie diesen Filter mit den Daten eines Intents überein (Typ, Schema und Pfad). |
| MatchDataAuthority(Uri) |
Stimmen Sie diesen Intent-Filter mit den angegebenen Intent-Daten überein. |
| Notify() |
Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object) |
| NotifyAll() |
Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object) |
| PathsIterator() |
Gibt einen Iterator über die Datenpfade des Filters zurück. |
| ReadFromXml(XmlReader) |
Strukturierte Beschreibung der zuzuordnenden Intent-Werte. |
| SchemesIterator() |
Gibt einen Iterator für die Datenschemas des Filters zurück. |
| SchemeSpecificPartsIterator() |
Geben Sie einen Iterator für die datenschemaspezifischen Teile des Filters zurück. |
| SetHandle(IntPtr, JniHandleOwnership) |
Legt die Handle-Eigenschaft fest. (Geerbt von Object) |
| ToArray<T>() |
Strukturierte Beschreibung der zuzuordnenden Intent-Werte. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object) |
| TypesIterator() |
Gibt einen Iterator für die Datentypen des Filters zurück. |
| UnregisterFromRuntime() |
Strukturierte Beschreibung der zuzuordnenden Intent-Werte. (Geerbt von Object) |
| Wait() |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em> oder <em>unterbrochen</em>.<>< (Geerbt von Object) |
| Wait(Int64) |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
| Wait(Int64, Int32) |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
| WriteToParcel(Parcel, ParcelableWriteFlags) |
Flachen Sie dieses Objekt in ein Paket. |
| WriteToXml(IXmlSerializer) |
Schreiben Sie den Inhalt des IntentFilters als XML-Datenstrom. |
Explizite Schnittstellenimplementierungen
| IJavaPeerable.Disposed() |
Strukturierte Beschreibung der zuzuordnenden Intent-Werte. (Geerbt von Object) |
| IJavaPeerable.DisposeUnlessReferenced() |
Strukturierte Beschreibung der zuzuordnenden Intent-Werte. (Geerbt von Object) |
| IJavaPeerable.Finalized() |
Strukturierte Beschreibung der zuzuordnenden Intent-Werte. (Geerbt von Object) |
| IJavaPeerable.JniManagedPeerState |
Strukturierte Beschreibung der zuzuordnenden Intent-Werte. (Geerbt von Object) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Strukturierte Beschreibung der zuzuordnenden Intent-Werte. (Geerbt von Object) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Strukturierte Beschreibung der zuzuordnenden Intent-Werte. (Geerbt von Object) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Strukturierte Beschreibung der zuzuordnenden Intent-Werte. (Geerbt von Object) |
Erweiterungsmethoden
| JavaCast<TResult>(IJavaObject) |
Führt eine android-laufzeitgecheckte Typkonvertierung aus. |
| JavaCast<TResult>(IJavaObject) |
Strukturierte Beschreibung der zuzuordnenden Intent-Werte. |
| GetJniTypeName(IJavaPeerable) |
Strukturierte Beschreibung der zuzuordnenden Intent-Werte. |