IntentFilter Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Description structurée des valeurs d’intention à mettre en correspondance.
[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- Héritage
- Attributs
- Implémente
Remarques
Description structurée des valeurs d’intention à mettre en correspondance. Un IntentFilter peut correspondre à des actions, des catégories et des données (via son type, son schéma et/ou son chemin) dans une intention. Il inclut également une valeur de « priorité » utilisée pour commander plusieurs filtres correspondants.
Les objets IntentFilter sont souvent créés en XML dans le cadre du fichier d’un android.R.styleable#AndroidManifest AndroidManifest.xml package, à l’aide android.R.styleable#AndroidManifestIntentFilter intent-filter de balises.
Il existe trois caractéristiques d’intention sur lesquelles vous pouvez filtrer : l’action em/em>, <>les données< em/em> et <>les catégories< em/em.>><< Pour chacune de ces caractéristiques, vous pouvez fournir plusieurs valeurs de correspondance possibles (via #addAction, , #addDataScheme#addDataType, #addDataSchemeSpecificPart, #addDataAuthority, , #addDataPath, et #addCategory, respectivement). Pour les actions, si aucune caractéristique de données n’est spécifiée, le filtre correspond uniquement aux intentions qui ne contiennent aucune donnée.
La caractéristique des données est elle-même divisée en trois attributs : type, schéma, autorité et chemin d’accès. Les éléments spécifiés doivent correspondre au contenu de l’intention. Si vous spécifiez un schéma mais aucun type, seule l’intention qui n’a pas de type (par exemple mailto :) correspondra ; un contenu : l’URI ne correspond jamais, car ils ont toujours un type MIME fourni par leur fournisseur de contenu. La spécification d’un type sans schéma a une signification quelque peu spéciale : elle correspond à une intention sans champ d’URI ou à une intention avec un contenu : ou un URI de fichier. Si vous ne spécifiez ni l’un ni l’autre, seule une intention sans données ni type correspondra. Pour spécifier une autorité, vous devez également spécifier un ou plusieurs schémas auxquels il est associé. Pour spécifier un chemin d’accès, vous devez également spécifier une ou plusieurs autorités et un ou plusieurs schémas auxquels il est associé.
<div class="special reference"><h3>Developer Guides</h3>
Pour plus d’informations sur la création et la résolution des intentions, lisez le guide du développeur Intentions et Filtres d’intentions.
</Div>
<Règles< de filtre h3>/h3>
Une correspondance est basée sur les règles suivantes. Notez que pour qu’un IntentFilter corresponde à une intention, trois conditions doivent contenir : l’action forte/forte et <<>forte catégorie/>forte doit correspondre, ainsi que les données (le <type< de données fort>/>fort et <fort>data scheme+authority+path</strong> si spécifié) doit correspondre (pour #match(ContentResolver, Intent, boolean, String) plus d’informations sur la façon dont les champs de données correspondent).>><<
<>forte action</correspondance forte> si l’une des valeurs données correspond à l’action Intention ; si le filtre ne spécifie aucune action, il ne correspondra qu’aux intentions qui ne contiennent pas d’action.
<>strong Data Type</strong> correspond si l’une des valeurs données données correspond au type Intention. Le type Intention est déterminé par l’appel Intent#resolveType. Un caractère générique peut être utilisé pour le sous-type MIME, à la fois dans l’intention et l’intentionFilter, afin que le type « audio/* » corresponde à « audio/mpeg », « audio/aiff », « audio/* », etc. <em>Notez que le type MIME correspondant ici est <b>respectant< la casse/b>, contrairement aux types MIME RFC formels !</em> Vous devez donc toujours utiliser des lettres minuscules pour vos types MIME.
<>strong Data Scheme</strong> correspond si l’une des valeurs données donnée correspond au schéma des données d’intention. Le schéma d’intention est déterminé par l’appel Intent#getData et android.net.Uri#getScheme sur cet URI. <em>Notez que le schéma correspondant ici est <b>respectant< la casse/b>, contrairement aux schémas RFC formels !</em> Vous devez donc toujours utiliser des lettres minuscules pour vos schémas.
<des correspondances spécifiques>à un schéma de données fort</forte> si l’une des valeurs spécifiées correspond à la partie <spécifique du schéma de données de l’intention em>et</em> l’un des schémas de données du filtre a mis en correspondance l’intention, <em ou< em>> aucun composant spécifique du schéma n’a été fourni dans le filtre. La partie spécifique du schéma d’intention est déterminée par l’appel Intent#getData et android.net.Uri#getSchemeSpecificPart sur cet URI. <em>Notez que la correspondance de partie spécifique à un schéma est <b respectant< la>casse/b>.</Em>
<>forte autorité< de données/correspondance forte> si l’une des valeurs spécifiées correspond à l’autorité <de données de l’intention em>et</em> l’un des schémas de données du filtre a mis en correspondance l’intention, <em>ou</em> aucune autorité n’a été fournie dans le filtre. L’autorité d’intention est déterminée par l’appel Intent#getData et android.net.Uri#getAuthority sur cet URI. <em>Notez que la correspondance d’autorité ici est <b respectant< la>casse/b>, contrairement aux noms d’hôtes RFC formels !</em> Vous devez donc toujours utiliser des lettres minuscules pour votre autorité.
<>Fort Chemin de données</correspondances fortes> si l’une des valeurs spécifiées correspond au chemin d’accès <de données de l’intention em>et</em> à la fois un schéma et une autorité dans le filtre a été mis en correspondance avec l’intention, <em>ou< em> aucun chemin d’accès n’a été fourni dans le filtre. L’autorité d’intention est déterminée par l’appel Intent#getData et android.net.Uri#getPath sur cet URI.
<fortes catégories</correspondance forte>> si <em>all</em> des catégories dans les catégories de correspondance intention données dans le filtre. Les catégories supplémentaires du filtre qui ne figurent pas dans l’intention ne provoquent pas l’échec de la correspondance. Notez que contrairement à l’action, un IntentFilter sans catégorie ne correspond qu’à une intention qui n’a pas de catégories.
Documentation Java pour android.content.IntentFilter.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.
Constructeurs
| IntentFilter() |
Nouveau IntentFilter vide. |
| IntentFilter(IntentFilter) |
Nouveau IntentFilter contenant une copie d’un filtre existant. |
| IntentFilter(IntPtr, JniHandleOwnership) |
Constructeur utilisé lors de la création de représentations managées d’objets JNI ; appelée par le runtime. |
| IntentFilter(String) |
Nouveau IntentFilter qui correspond à une seule action sans données. |
| IntentFilter(String, String) |
Nouveau IntentFilter qui correspond à une seule action et type de données. |
Champs
| SystemHighPriority |
Obsolète.
Valeur de filtre |
| SystemLowPriority |
Obsolète.
Valeur de filtre |
Propriétés
| Class |
Retourne la classe runtime de ce |
| Creator |
Description structurée des valeurs d’intention à mettre en correspondance. |
| Handle |
Handle de l’instance Android sous-jacente. (Hérité de Object) |
| JniIdentityHashCode |
Description structurée des valeurs d’intention à mettre en correspondance. (Hérité de Object) |
| JniPeerMembers |
Description structurée des valeurs d’intention à mettre en correspondance. |
| PeerReference |
Description structurée des valeurs d’intention à mettre en correspondance. (Hérité de Object) |
| Priority |
Retourne la priorité de ce filtre. -ou- Modifier la priorité de ce filtre. |
| ThresholdClass |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. |
| ThresholdType |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. |
Méthodes
| ActionsIterator() |
Retourne un itérateur sur les actions du filtre. |
| AddAction(String) |
Ajoutez une nouvelle action Intention à mettre en correspondance. |
| AddCategory(String) |
Ajoutez une nouvelle catégorie Intention à mettre en correspondance. |
| AddDataAuthority(String, String) |
Ajoutez une nouvelle autorité de données Intention à mettre en correspondance. |
| AddDataPath(String, Pattern) |
Ajoutez un nouveau chemin de données Intention à mettre en correspondance. |
| AddDataScheme(String) |
Ajoutez un nouveau schéma de données Intention à mettre en correspondance. |
| AddDataSchemeSpecificPart(String, Pattern) |
Ajoutez une nouvelle « partie spécifique du schéma » de données d’intention à mettre en correspondance. |
| AddDataType(String) |
Ajoutez un nouveau type de données Intention à faire correspondre. |
| AsPredicate() |
Retourne une |
| AsPredicateWithTypeResolution(ContentResolver) |
Retourne une |
| AuthoritiesIterator() |
Retourne un itérateur sur les autorités de données du filtre. |
| CategoriesIterator() |
Retourne un itérateur sur les catégories du filtre. |
| Clone() |
Crée et retourne une copie de cet objet. (Hérité de Object) |
| CountActions() |
Retourne le nombre d’actions dans le filtre. |
| CountCategories() |
Retourne le nombre de catégories dans le filtre. |
| CountDataAuthorities() |
Retourne le nombre d’autorités de données dans le filtre. |
| CountDataPaths() |
Retourne le nombre de chemins de données dans le filtre. |
| CountDataSchemes() |
Retourne le nombre de schémas de données dans le filtre. |
| CountDataSchemeSpecificParts() |
Retourne le nombre de parties spécifiques du schéma de données dans le filtre. |
| CountDataTypes() |
Retourne le nombre de types de données dans le filtre. |
| Create(String, String) |
Créez une instance IntentFilter avec une action et un type MIME spécifiés, où vous savez que le type MIME est correctement mis en forme. |
| DescribeContents() |
Décrivez les types d’objets spéciaux contenus dans la représentation marshallée de ce Colisable. |
| Dispose() |
Description structurée des valeurs d’intention à mettre en correspondance. (Hérité de Object) |
| Dispose(Boolean) |
Description structurée des valeurs d’intention à mettre en correspondance. (Hérité de Object) |
| Dump(IPrinter, String) |
Description structurée des valeurs d’intention à mettre en correspondance. |
| Equals(Object) |
Indique si un autre objet est « égal à » celui-ci. (Hérité de Object) |
| GetAction(Int32) |
Retourne une action dans le filtre. |
| GetCategory(Int32) |
Retourne une catégorie dans le filtre. |
| GetDataAuthority(Int32) |
Retourne une autorité de données dans le filtre. |
| GetDataPath(Int32) |
Retourne un chemin d’accès aux données dans le filtre. |
| GetDataScheme(Int32) |
Retourne un schéma de données dans le filtre. |
| GetDataSchemeSpecificPart(Int32) |
Retourne une partie spécifique d’un schéma de données dans le filtre. |
| GetDataType(Int32) |
Retourne un type de données dans le filtre. |
| GetHashCode() |
Retourne une valeur de code de hachage pour l'objet. (Hérité de Object) |
| HasAction(String) |
L’action donnée est-elle incluse dans le filtre ? Notez que si le filtre n’inclut aucune action, false est <>toujours</em> retourné. |
| HasCategory(String) |
La catégorie donnée est-elle incluse dans le filtre ? |
| HasDataAuthority(Uri) |
L’autorité de données donnée est-elle incluse dans le filtre ? Notez que si le filtre n’inclut aucune autorité, false est <>toujours</em> retourné. |
| HasDataPath(String) |
Le chemin de données donné est-il inclus dans le filtre ? Notez que si le filtre n’inclut aucun chemin d’accès, false est <>toujours</em> retourné. |
| HasDataScheme(String) |
Le schéma de données donné est-il inclus dans le filtre ? Notez que si le filtre n’inclut aucun schéma, false est <>toujours</em> retourné. |
| HasDataSchemeSpecificPart(String) |
Le schéma de données donné est-il inclus dans le filtre ? Notez que si le filtre n’inclut pas de parties spécifiques à un schéma, false est <toujours< retourné par em>/em>. |
| HasDataType(String) |
Le type de données donné est-il inclus dans le filtre ? Notez que si le filtre n’inclut aucun type, false est <>toujours</em> retourné. |
| JavaFinalize() |
Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet. (Hérité de Object) |
| Match(ContentResolver, Intent, Boolean, String) |
Testez si ce filtre correspond à l’intention</var> var>donnée<. |
| Match(String, String, String, Uri, ICollection<String>, String) |
Testez si ce filtre correspond aux données d’intention données. |
| MatchAction(String) |
Mettre en correspondance ce filtre par rapport à l’action d’une intention. |
| MatchCategories(ICollection<String>) |
Mettre en correspondance ce filtre par rapport aux catégories d’une intention. |
| MatchData(String, String, Uri) |
Mettre en correspondance ce filtre par rapport aux données d’une intention (type, schéma et chemin d’accès). |
| MatchDataAuthority(Uri) |
Mettre en correspondance ce filtre d’intention par rapport aux données d’intention données. |
| Notify() |
Réveille un thread unique qui attend le moniteur de cet objet. (Hérité de Object) |
| NotifyAll() |
Réveille tous les threads qui attendent le moniteur de cet objet. (Hérité de Object) |
| PathsIterator() |
Retourne un itérateur sur les chemins de données du filtre. |
| ReadFromXml(XmlReader) |
Description structurée des valeurs d’intention à mettre en correspondance. |
| SchemesIterator() |
Retourne un itérateur sur les schémas de données du filtre. |
| SchemeSpecificPartsIterator() |
Retourne un itérateur sur les parties spécifiques du schéma de données du filtre. |
| SetHandle(IntPtr, JniHandleOwnership) |
Définit la propriété Handle. (Hérité de Object) |
| ToArray<T>() |
Description structurée des valeurs d’intention à mettre en correspondance. (Hérité de Object) |
| ToString() |
Retourne une représentation de chaîne de l'objet. (Hérité de Object) |
| TypesIterator() |
Retourne un itérateur sur les types de données du filtre. |
| UnregisterFromRuntime() |
Description structurée des valeurs d’intention à mettre en correspondance. (Hérité de Object) |
| Wait() |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou><em>interrompu</em>.<> (Hérité de Object) |
| Wait(Int64) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti< par> em>ou <em>interrompu/em>,< ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
| Wait(Int64, Int32) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti< par> em>ou <em>interrompu/em>,< ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
| WriteToParcel(Parcel, ParcelableWriteFlags) |
Aplatir cet objet dans un colis. |
| WriteToXml(IXmlSerializer) |
Écrivez le contenu du IntentFilter en tant que flux XML. |
Implémentations d’interfaces explicites
| IJavaPeerable.Disposed() |
Description structurée des valeurs d’intention à mettre en correspondance. (Hérité de Object) |
| IJavaPeerable.DisposeUnlessReferenced() |
Description structurée des valeurs d’intention à mettre en correspondance. (Hérité de Object) |
| IJavaPeerable.Finalized() |
Description structurée des valeurs d’intention à mettre en correspondance. (Hérité de Object) |
| IJavaPeerable.JniManagedPeerState |
Description structurée des valeurs d’intention à mettre en correspondance. (Hérité de Object) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Description structurée des valeurs d’intention à mettre en correspondance. (Hérité de Object) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Description structurée des valeurs d’intention à mettre en correspondance. (Hérité de Object) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Description structurée des valeurs d’intention à mettre en correspondance. (Hérité de Object) |
Méthodes d’extension
| JavaCast<TResult>(IJavaObject) |
Effectue une conversion de type vérifiée par le runtime Android. |
| JavaCast<TResult>(IJavaObject) |
Description structurée des valeurs d’intention à mettre en correspondance. |
| GetJniTypeName(IJavaPeerable) |
Description structurée des valeurs d’intention à mettre en correspondance. |