IntentFilter Klasse

Definition

Namespace:

Android.Content

Assembly:

Mono.Android.dll

Strukturierte Beschreibung der abzugleichenden Absichtswerte.

[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

Object

Object

IntentFilter

Attribute

RegisterAttribute

Implementiert

IParcelable IJavaObject IJavaPeerable IDisposable

Hinweise

Strukturierte Beschreibung der abzugleichenden Absichtswerte. Ein IntentFilter kann mit Aktionen, Kategorien und Daten (entweder über seinen Typ, sein Schema und/oder den Pfad) in einer Absicht abgleichen. 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 Absichtseigenschaften, nach denen Sie filtern können: em <action/em>, <em>data</em> und <em>categories</em>.<> Für jedes dieser Merkmale können Sie mehrere mögliche übereinstimmende Werte angeben (über #addAction, #addDataType, #addDataScheme, #addDataSchemeSpecificPart#addDataAuthority, #addDataPath, und #addCategory, bzw. ). Wenn bei Aktionen keine Datenmerkmale angegeben werden, entspricht der Filter nur Absichten, die keine Daten enthalten.

Das Datenmerkmal ist selbst in drei Attribute unterteilt: Typ, Schema, Autorität und Pfad. Alle angegebenen Müssen mit dem Inhalt der Absicht übereinstimmen. Wenn Sie ein Schema, aber keinen Typ angeben, stimmt nur Die Absicht, die keinen Typ aufweist (z. B. mailto:), überein. a content: URI wird nie übereinstimmen, da sie immer über einen MIME-Typ verfügen, der von ihrem Inhaltsanbieter bereitgestellt wird. Die Angabe eines Typs ohne Schema hat eine etwas besondere Bedeutung: Sie entspricht entweder einem Feld Absicht ohne URI oder einer Absicht mit einem Inhalt: oder Datei: URI. Wenn Sie keines angeben, stimmt nur eine Absicht ohne Daten oder Typ überein. Um eine Autorität anzugeben, müssen Sie auch mindestens ein Schema angeben, dem sie zugeordnet ist. Um einen Pfad anzugeben, müssen Sie auch eine oder mehrere Behörden und mindestens ein Schema angeben, dem sie zugeordnet ist.

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

Informationen zum Erstellen und Auflösen von Absichten finden Sie im Entwicklerhandbuch absichts- und absichtsfilter .

</Div>

<h3-Filterregeln></h3>

Eine Übereinstimmung basiert auf den folgenden Regeln. Beachten Sie, dass drei Bedingungen erfüllt sein müssen, damit ein IntentFilter mit einer Absicht übereinstimmt: die starke Aktion/stark> und <die starke>Kategorie</Stark> müssen übereinstimmen, und die Daten (sowohl der starke>Datentyp</strong> als <auch das <starke>Datenschema+Autorität+Pfad</stark>, falls angegeben) müssen übereinstimmen (weitere Details zur Übereinstimmung der Datenfelder finden Sie unter#match(ContentResolver, Intent, boolean, String)).<><

<Strong>Action</strong> stimmt überein, wenn einer der angegebenen Werte mit der Absichtsaktion übereinstimmt. Wenn der Filter keine Aktionen angibt, stimmt er nur mit Absichten überein, die keine Aktion enthalten.

<Strong>Data Type</strong> stimmt überein, wenn einer der angegebenen Werte mit dem Absichtstyp übereinstimmt. Der Absichtstyp wird durch Aufrufen Intent#resolveTypevon bestimmt. Ein Wildcard kann für den MIME-Untertyp sowohl in Intent als auch in IntentFilter verwendet werden, sodass der Typ "audio/*" mit "audio/mpeg", "audio/aiff", "audio/*" usw. übereinstimmt. <em>Beachten Sie, dass der MIME-Typ hier <die>Groß-/Kleinschreibung</b> beachtet, im Gegensatz zu formalen RFC MIME-Typen!</em> Sie sollten daher immer Kleinbuchstaben für Ihre MIME-Typen verwenden.

<Strong>Data Scheme</strong> stimmt überein, wenn einer der angegebenen Werte mit dem Schema der Absichtsdaten übereinstimmt. Das Absichtsschema wird durch Aufrufen Intent#getData von und android.net.Uri#getScheme für diesen URI bestimmt. <em>Beachten Sie, dass beim Schemaabgleich hier die>Groß-</Kleinschreibung/b> beachtet wird<, im Gegensatz zu formalen RFC-Schemas!</em> Sie sollten daher immer Kleinbuchstaben für Ihre Schemas verwenden.

<Strong>Data Scheme Specific Part</strong> matches if the given values match the Intent's data scheme specific part <em>and</em> one of the data scheme in the filter has matched the Intent, <em>or</em> no scheme specific parts were in the filter. Der spezifische Teil des Absichtsschemas wird durch Aufrufen Intent#getData von und android.net.Uri#getSchemeSpecificPart für diesen URI bestimmt. <em>Beachten Sie, dass der schemaspezifische Teilabgleich <die>Groß-/Kleinschreibung/b> beachtet<.</Em>

<Strong>Data Authority</strong> stimmt überein, wenn einer der angegebenen Werte mit der Datenautorität <der Absicht übereinstimmt em>und</em> eines der Datenschemas im Filter mit der Absicht übereinstimmt, <em>oder</em> keine Autoritäten im Filter angegeben wurden. Die Absichtsautorität wird durch Aufrufen Intent#getData von und android.net.Uri#getAuthority für diesen URI bestimmt. <em>Beachten Sie, dass bei autoritätsbezogenem Abgleich hier die>Groß-/Kleinschreibung</b> beachtet wird<, im Gegensatz zu formalen RFC-Hostnamen!</em> Sie sollten daher immer Kleinbuchstaben für Ihre Autorität verwenden.

<Strong>Data Path</strong> stimmt überein, wenn einer der angegebenen Werte mit dem Datenpfad <em>und</em> der Absicht übereinstimmt, sowohl ein Schema als auch eine Autorität im Filter mit der Absicht abgeglichen wurde, <em>oder</em> wurden keine Pfade im Filter angegeben. Die Absichtsautorität wird durch Aufrufen Intent#getData von und android.net.Uri#getPath für diesen URI bestimmt.

<strong>Categories</strong> match if <em>all</em> of the categories in the Intent match categories given in the filter. Zusätzliche Kategorien im Filter, die nicht in der Absicht enthalten sind, führen nicht dazu, dass die Übereinstimmung fehlschlägt. Beachten Sie, dass ein IntentFilter ohne Kategorien im Gegensatz zur Aktion nur mit einer Absicht ohne Kategorien übereinstimmt.

Java-Dokumentation für android.content.IntentFilter.

Teile dieser Seite sind Änderungen, die auf Arbeiten basieren, die vom Android Open Source Project erstellt und freigegeben wurden und gemäß den In Attribution License beschriebenen Begriffen verwendet werden.

Konstruktoren

IntentFilter()	Neuer leerer IntentFilter.
IntentFilter(IntentFilter)	Neuer IntentFilter mit einer Kopie eines vorhandenen Filters.
IntentFilter(IntPtr, JniHandleOwnership)	Ein Konstruktor, der beim Erstellen verwalteter Darstellungen von JNI-Objekten verwendet wird; wird von der Runtime 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 #setPriority , an dem Systemempfänger mit hoher Priorität platziert werden, d. h. Empfänger, die vor dem Anwendungscode ausgeführt werden sollen.
SystemLowPriority	Veraltet. Der Filterwert #setPriority , an dem Empfänger mit niedriger Priorität platziert werden, d. h. Empfänger, die nach Anwendungscode ausgeführt werden sollen.

Eigenschaften

Class	Gibt die Laufzeitklasse dieses Objectzurück. (Geerbt von Object)
Creator	Strukturierte Beschreibung der abzugleichenden Absichtswerte.
Handle	Das Handle zum zugrunde liegenden Android-instance. (Geerbt von Object)
JniIdentityHashCode	Strukturierte Beschreibung der abzugleichenden Absichtswerte. (Geerbt von Object)
JniPeerMembers	Strukturierte Beschreibung der abzugleichenden Absichtswerte.
PeerReference	Strukturierte Beschreibung der abzugleichenden Absichtswerte. (Geerbt von Object)
Priority	Gibt die Priorität dieses Filters zurück. - oder: Ändern Sie die Priorität dieses Filters.
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 Absichtsaktion hinzu, mit der abgeglichen werden soll.
AddCategory(String)	Fügen Sie eine neue Absichtskategorie hinzu, mit der abgeglichen werden soll.
AddDataAuthority(String, String)	Fügen Sie eine neue Absichtsdatenautorität hinzu, mit der abgeglichen werden soll.
AddDataPath(String, Pattern)	Fügen Sie einen neuen Absichtsdatenpfad hinzu, mit dem abgeglichen werden soll.
AddDataScheme(String)	Fügen Sie ein neues Absichtsdatenschema hinzu, mit dem abgeglichen werden soll.
AddDataSchemeSpecificPart(String, Pattern)	Fügen Sie eine neue Absichtsdaten "schemaspezifischer Teil" hinzu, mit der abgeglichen werden soll.
AddDataType(String)	Fügen Sie einen neuen Absichtsdatentyp hinzu, mit dem abgeglichen werden soll.
AsPredicate()	Gibt einen Predicate zurück, der testet, ob dieser Filter mit der angegebenen <var-Absicht></var> übereinstimmt.
AsPredicateWithTypeResolution(ContentResolver)	Gibt einen Predicate zurück, der testet, ob dieser Filter mit der angegebenen <var-Absicht></var> übereinstimmt.
AuthoritiesIterator()	Gibt einen Iterator über die Datenautoritäten des Filters zurück.
CategoriesIterator()	Gibt 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 Datenautoritäten 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-instance mit einer angegebenen Aktion und einem angegebenen MIME-Typ, bei dem Sie wissen, dass der MIME-Typ ordnungsgemäß formatiert ist.
DescribeContents()	Beschreiben Sie die Arten von speziellen Objekten, die in der Marshalldarstellung dieses Parcelable enthalten sind.
Dispose()	Strukturierte Beschreibung der abzugleichenden Absichtswerte. (Geerbt von Object)
Dispose(Boolean)	Strukturierte Beschreibung der abzugleichenden Absichtswerte. (Geerbt von Object)
Dump(IPrinter, String)	Strukturierte Beschreibung der abzugleichenden Absichtswerte.
Equals(Object)	Gibt an, ob ein anderes Objekt diesem "gleich" ist. (Geerbt von Object)
GetAction(Int32)	Gibt eine Aktion im Filter zurück.
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)	Gibt einen datenschemaspezifischen Teil im Filter zurück.
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? Beachten Sie, dass false immer/em> zurückgegeben wird<<>, wenn der Filter keine Aktionen enthält.
HasCategory(String)	Ist die angegebene Kategorie im Filter enthalten?
HasDataAuthority(Uri)	Ist die angegebene Datenautorität im Filter enthalten? Beachten Sie, dass false immer/em> zurückgegeben wird<<>, wenn der Filter keine Autoritäten enthält.
HasDataPath(String)	Ist der angegebene Datenpfad im Filter enthalten? Beachten Sie, dass false immer/em> zurückgegeben wird<<>, wenn der Filter keine Pfade enthält.
HasDataScheme(String)	Ist das angegebene Datenschema im Filter enthalten? Beachten Sie, dass false immer/em> zurückgegeben wird<<>, wenn der Filter kein Schema enthält.
HasDataSchemeSpecificPart(String)	Ist der bestimmte Teil des angegebenen Datenschemas im Filter enthalten? Beachten Sie, dass false em always</em> zurückgegeben wird<>, wenn der Filter keine schemaspezifischen Teile enthält.
HasDataType(String)	Ist der angegebene Datentyp im Filter enthalten? Beachten Sie, dass false em>always</em> zurückgegeben wird<, wenn der Filter keinen Typ enthält.
JavaFinalize()	Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection feststellt, dass keine Verweise mehr auf das Objekt vorhanden sind. (Geerbt von Object)
Match(ContentResolver, Intent, Boolean, String)	Testen Sie, ob dieser Filter mit der angegebenen <var-Absicht></var> übereinstimmt.
Match(String, String, String, Uri, ICollection<String>, String)	Testen Sie, ob dieser Filter mit den angegebenen Absichtsdaten übereinstimmt.
MatchAction(String)	Zuordnen sie diesen Filter mit der Aktion einer Absicht.
MatchCategories(ICollection<String>)	Zuordnen sie diesen Filter mit den Kategorien einer Absicht.
MatchData(String, String, Uri)	Passen Sie diesen Filter mit den Daten einer Absicht (Typ, Schema und Pfad) ab.
MatchDataAuthority(Uri)	Passen Sie diesen Absichtsfilter mit den angegebenen Absichtsdaten ab.
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 abzugleichenden Absichtswerte.
SchemesIterator()	Gibt einen Iterator für die Datenschemas des Filters zurück.
SchemeSpecificPartsIterator()	Gibt 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 abzugleichenden Absichtswerte. (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 abzugleichenden Absichtswerte. (Geerbt von Object)
Wait()	Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert wird, in der Regel durch em benachrichtigen/em> oder <em>interrupted</em>.<>< (Geerbt von Object)
Wait(Int64)	Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert wird, in der Regel, indem <er>benachrichtigt</em> oder <em>interrupted</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
Wait(Int64, Int32)	Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert wird, in der Regel, indem <er>benachrichtigt</em> oder <em>interrupted</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
WriteToParcel(Parcel, ParcelableWriteFlags)	Flachen Sie dieses Objekt in ein Paket ein.
WriteToXml(IXmlSerializer)	Schreiben Sie den Inhalt des IntentFilter als XML-Stream.

Explizite Schnittstellenimplementierungen

IJavaPeerable.Disposed()	Strukturierte Beschreibung der abzugleichenden Absichtswerte. (Geerbt von Object)
IJavaPeerable.DisposeUnlessReferenced()	Strukturierte Beschreibung der abzugleichenden Absichtswerte. (Geerbt von Object)
IJavaPeerable.Finalized()	Strukturierte Beschreibung der abzugleichenden Absichtswerte. (Geerbt von Object)
IJavaPeerable.JniManagedPeerState	Strukturierte Beschreibung der abzugleichenden Absichtswerte. (Geerbt von Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Strukturierte Beschreibung der abzugleichenden Absichtswerte. (Geerbt von Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Strukturierte Beschreibung der abzugleichenden Absichtswerte. (Geerbt von Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Strukturierte Beschreibung der abzugleichenden Absichtswerte. (Geerbt von Object)

Erweiterungsmethoden

JavaCast<TResult>(IJavaObject)	Führt eine Für Android-Runtime überprüfte Typkonvertierung aus.
JavaCast<TResult>(IJavaObject)	Strukturierte Beschreibung der abzugleichenden Absichtswerte.
GetJniTypeName(IJavaPeerable)	Strukturierte Beschreibung der abzugleichenden Absichtswerte.