IntentFilter Clase

Definición

Espacio de nombres:

Android.Content

Ensamblado:

Mono.Android.dll

Descripción estructurada de los valores de intención que se van a buscar coincidencias.

[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

Herencia

Object

Object

IntentFilter

Atributos

RegisterAttribute

Implementaciones

IParcelable IJavaObject IJavaPeerable IDisposable

Comentarios

Descripción estructurada de los valores de intención que se van a buscar coincidencias. Un IntentFilter puede coincidir con acciones, categorías y datos (ya sea a través de su tipo, esquema o ruta de acceso) en una intención. También incluye un valor de "prioridad" que se usa para ordenar varios filtros coincidentes.

Los objetos IntentFilter se suelen crear en XML como parte del archivo de android.R.styleable#AndroidManifest AndroidManifest.xml un paquete, mediante android.R.styleable#AndroidManifestIntentFilter intent-filter etiquetas.

Hay tres características de intención en las que puede filtrar: las <categorías em>action</em>, <em>data</em> y <em>categories</em>. Para cada una de estas características, puede proporcionar varios valores coincidentes posibles (a través #addActionde , #addDataType, #addDataScheme#addDataSchemeSpecificPart, #addDataAuthority, , #addDataPathy #addCategory, respectivamente). En el caso de las acciones, si no se especifican características de datos, el filtro solo coincidirá con las intenciones que no contienen datos.

La característica de datos se divide en tres atributos: tipo, esquema, autoridad y ruta de acceso. Cualquiera que se especifique debe coincidir con el contenido de la intención. Si especifica un esquema pero ningún tipo, solo la intención que no tiene un tipo (como mailto:) coincidirá; un contenido: el URI nunca coincidirá porque siempre tienen un tipo MIME proporcionado por su proveedor de contenido. Especificar un tipo sin esquema tiene un significado algo especial: coincidirá con un campo Intención sin URI o una Intención con un contenido: o un archivo: URI. Si no especifica ninguno, solo coincidirá una intención sin datos o tipo. Para especificar una autoridad, también debe especificar uno o varios esquemas a los que está asociado. Para especificar una ruta de acceso, también debe especificar una o varias autoridades y uno o varios esquemas a los que está asociado.

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

Para obtener información sobre cómo crear y resolver intenciones, lea la guía para desarrolladores Intents and Intent Filters (Intenciones y filtros de intención ).

</Div>

<h3>Filter Rules</h3>

Una coincidencia se basa en las siguientes reglas. Tenga en cuenta que, para que un IntentFilter coincida con una intención, deben contener tres condiciones: la <acción fuerte,> la categoría<< fuerte>y <>fuerte> debe coincidir y los datos (tanto el <>tipo< de datos seguro/fuerte como <el esquema de datos seguro>>+autoridad+ruta< de acceso/fuerte> si se especifica) deben coincidir (consulte #match(ContentResolver, Intent, boolean, String) para obtener más detalles sobre cómo coinciden los campos de datos).

<>strong Action</strong> matches if any of the given values match the Intent action; if the filter specifies no actions, it will only match Intents that do not contain an action.

<strong>Data Type</strong> matches if any of the given values match the Intent type. El tipo de intención se determina mediante una llamada a Intent#resolveType. Se puede usar un carácter comodín para el subtipo MIME, tanto en intent como en IntentFilter, de modo que el tipo "audio/*" coincida con "audio/mpeg", "audio/aiff", "audio/*", etc. <em Tenga en>cuenta que el tipo MIME que coincide aquí es <b>distingue mayúsculas de minúsculas</b>, a diferencia de los tipos MIME DE RFC formales.</em> Por lo tanto, siempre debe usar letras minúsculas para los tipos MIME.

<>strong Data Scheme</strong> matches if any of the given values match the Intent data's scheme. El esquema intent se determina mediante una llamada Intent#getData a y android.net.Uri#getScheme en ese URI. <em Tenga en>cuenta que la coincidencia de esquema aquí es <b>distingue mayúsculas de minúsculas</b>, a diferencia de los esquemas RFC formales!</em> Por lo tanto, siempre debe usar letras minúsculas para sus esquemas.

<>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 scheme in the filter has matched the Intent, <em>or</em> no scheme specific parts were supplied in the filter. La parte específica del esquema de intención se determina mediante una llamada Intent#getData a y android.net.Uri#getSchemeSpecificPart en ese URI. <em Tenga en>cuenta que la coincidencia de partes específicas del esquema es <b>distingue< mayúsculas de minúsculas/b>.</em>

<>strong Data Authority/strong> match if any of the given values match the Intent's data <authority< em>and</em> one of the data schemes in the filter has matched the Intent, <em>or</em> no authority were supplied in the filter. La autoridad de intención se determina mediante una llamada Intent#getData a y android.net.Uri#getAuthority en ese URI. <em Tenga en>cuenta que la coincidencia de autoridad aquí es <b>distingue mayúsculas< de minúsculas/b>, a diferencia de los nombres de host RFC formales.</em> Por lo tanto, siempre debe usar letras minúsculas para su autoridad.

<>strong Data Path</strong> match 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. La autoridad de intención se determina mediante una llamada Intent#getData a y android.net.Uri#getPath en ese URI.

<strong>Categories</strong> match if <em>all</em> of the categories in the Intent match categories given in the filter. Las categorías adicionales del filtro que no están en la intención no harán que se produzca un error en la coincidencia. Tenga en cuenta que, a diferencia de la acción, un IntentFilter sin categorías solo coincidirá con una intención que no tenga ninguna categoría.

Documentación de Java para android.content.IntentFilter.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código y se usan según los términos descritos en la creative Commons 2.5.

Constructores

IntentFilter()	Nuevo IntentFilter vacío.
IntentFilter(IntentFilter)	Nuevo IntentFilter que contiene una copia de un filtro existente.
IntentFilter(IntPtr, JniHandleOwnership)	Constructor utilizado al crear representaciones administradas de objetos JNI; llamado por el entorno de ejecución.
IntentFilter(String)	Nuevo IntentFilter que coincide con una sola acción sin datos.
IntentFilter(String, String)	Nuevo IntentFilter que coincide con una sola acción y un tipo de datos.

Campos

SystemHighPriority	Obsoletos. Valor de filtro #setPriority en el que se colocan receptores de alta prioridad del sistema; es decir, receptores que se deben ejecutar antes del código de la aplicación.
SystemLowPriority	Obsoletos. Valor de filtro #setPriority en el que se colocan receptores de prioridad baja del sistema; es decir, receptores que deben ejecutarse después del código de la aplicación.

Propiedades

Class	Devuelve la clase en tiempo de ejecución de este Objectobjeto . (Heredado de Object)
Creator	Descripción estructurada de los valores de intención que se van a buscar coincidencias.
Handle	Identificador de la instancia de Android subyacente. (Heredado de Object)
JniIdentityHashCode	Descripción estructurada de los valores de intención que se van a buscar coincidencias. (Heredado de Object)
JniPeerMembers	Descripción estructurada de los valores de intención que se van a buscar coincidencias.
PeerReference	Descripción estructurada de los valores de intención que se van a buscar coincidencias. (Heredado de Object)
Priority	Devuelve la prioridad de este filtro. -o bien- Modifique la prioridad de este filtro.
ThresholdClass	Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código.
ThresholdType	Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código.

Métodos

ActionsIterator()	Devuelve un iterador sobre las acciones del filtro.
AddAction(String)	Agregue una nueva acción Intención con la que buscar coincidencias.
AddCategory(String)	Agregue una nueva categoría Intención con la que buscar coincidencias.
AddDataAuthority(String, String)	Agregue una nueva entidad de datos intent para que coincida con.
AddDataPath(String, Pattern)	Agregue una nueva ruta de acceso de datos de intención con la que coincidir.
AddDataScheme(String)	Agregue un nuevo esquema de datos intent para que coincida con.
AddDataSchemeSpecificPart(String, Pattern)	Agregue un nuevo elemento específico de datos de intención para que coincida con.
AddDataType(String)	Agregue un nuevo tipo de datos Intent con el que coincidir.
AsPredicate()	Devuelve un objeto Predicate que comprueba si este filtro coincide con la intención</>var> especificada<.
AsPredicateWithTypeResolution(ContentResolver)	Devuelve un objeto Predicate que comprueba si este filtro coincide con la intención</>var> especificada<.
AuthoritiesIterator()	Devuelve un iterador a través de las autoridades de datos del filtro.
CategoriesIterator()	Devuelve un iterador sobre las categorías del filtro.
Clone()	Crea y devuelve una copia de este objeto. (Heredado de Object)
CountActions()	Devuelve el número de acciones del filtro.
CountCategories()	Devuelve el número de categorías del filtro.
CountDataAuthorities()	Devuelve el número de autoridades de datos en el filtro.
CountDataPaths()	Devuelve el número de rutas de acceso de datos en el filtro.
CountDataSchemes()	Devuelve el número de esquemas de datos en el filtro.
CountDataSchemeSpecificParts()	Devuelve el número de partes específicas del esquema de datos en el filtro.
CountDataTypes()	Devuelve el número de tipos de datos del filtro.
Create(String, String)	Cree una nueva instancia de IntentFilter con una acción especificada y un tipo MIME, donde sabe que el tipo MIME tiene el formato correcto.
DescribeContents()	Describir los tipos de objetos especiales contenidos en la representación serializado de este Parcelable.
Dispose()	Descripción estructurada de los valores de intención que se van a buscar coincidencias. (Heredado de Object)
Dispose(Boolean)	Descripción estructurada de los valores de intención que se van a buscar coincidencias. (Heredado de Object)
Dump(IPrinter, String)	Descripción estructurada de los valores de intención que se van a buscar coincidencias.
Equals(Object)	Indica si algún otro objeto es "igual a" este. (Heredado de Object)
GetAction(Int32)	Devuelve una acción en el filtro.
GetCategory(Int32)	Devuelve una categoría en el filtro.
GetDataAuthority(Int32)	Devuelve una entidad de datos en el filtro.
GetDataPath(Int32)	Devuelve una ruta de acceso de datos en el filtro.
GetDataScheme(Int32)	Devuelve un esquema de datos en el filtro.
GetDataSchemeSpecificPart(Int32)	Devuelve una parte específica del esquema de datos en el filtro.
GetDataType(Int32)	Devuelve un tipo de datos en el filtro.
GetHashCode()	Devuelve un valor de código hash del objeto. (Heredado de Object)
HasAction(String)	¿Se incluye la acción dada en el filtro? Tenga en cuenta que si el filtro no incluye ninguna acción, se devolverá false <>always</em>.
HasCategory(String)	¿Se incluye la categoría especificada en el filtro?
HasDataAuthority(Uri)	¿Se incluye la autoridad de datos especificada en el filtro? Tenga en cuenta que si el filtro no incluye ninguna autoridad, se devolverá false <>siempre</em>.
HasDataPath(String)	¿Se incluye la ruta de acceso de datos especificada en el filtro? Tenga en cuenta que si el filtro no incluye ninguna ruta de acceso, se devolverá siempre/em> false<>.<
HasDataScheme(String)	¿Se incluye el esquema de datos especificado en el filtro? Tenga en cuenta que si el filtro no incluye ningún esquema, se devolverá false <>always</em>.
HasDataSchemeSpecificPart(String)	¿Se incluye la parte específica del esquema de datos especificado en el filtro? Tenga en cuenta que si el filtro no incluye ninguna parte específica del esquema, se devolverá false <>always</em>.
HasDataType(String)	¿Se incluye el tipo de datos especificado en el filtro? Tenga en cuenta que si el filtro no incluye ningún tipo, se devolverá false <>always</em>.
JavaFinalize()	Llamado por el recolector de elementos no utilizados en un objeto cuando la recolección de elementos no utilizados determina que no hay más referencias al objeto. (Heredado de Object)
Match(ContentResolver, Intent, Boolean, String)	Compruebe si este filtro coincide con la intención</>var> especificada<.
Match(String, String, String, Uri, ICollection<String>, String)	Compruebe si este filtro coincide con los datos de intención especificados.
MatchAction(String)	Haga coincidir este filtro con la acción de una intención.
MatchCategories(ICollection<String>)	Haga coincidir este filtro con las categorías de una intención.
MatchData(String, String, Uri)	Haga coincidir este filtro con los datos de una intención (tipo, esquema y ruta de acceso).
MatchDataAuthority(Uri)	Haga coincidir este filtro de intención con los datos de intención especificados.
Notify()	Activa un único subproceso que está esperando en el monitor de este objeto. (Heredado de Object)
NotifyAll()	Activa todos los subprocesos que están esperando en el monitor de este objeto. (Heredado de Object)
PathsIterator()	Devuelve un iterador sobre las rutas de acceso de datos del filtro.
ReadFromXml(XmlReader)	Descripción estructurada de los valores de intención que se van a buscar coincidencias.
SchemesIterator()	Devuelve un iterador sobre los esquemas de datos del filtro.
SchemeSpecificPartsIterator()	Devuelve un iterador sobre las partes específicas del esquema de datos del filtro.
SetHandle(IntPtr, JniHandleOwnership)	Establece la propiedad Handle. (Heredado de Object)
ToArray<T>()	Descripción estructurada de los valores de intención que se van a buscar coincidencias. (Heredado de Object)
ToString()	Devuelve una representación de cadena del objeto. (Heredado de Object)
TypesIterator()	Devuelve un iterador sobre los tipos de datos del filtro.
UnregisterFromRuntime()	Descripción estructurada de los valores de intención que se van a buscar coincidencias. (Heredado de Object)
Wait()	Hace que el subproceso actual espere hasta que se despierte, normalmente por ser em notificado/em> o <em>interrumpido</em>.<>< (Heredado de Object)
Wait(Int64)	Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <notificado<>/em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object)
Wait(Int64, Int32)	Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <notificado<>/em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object)
WriteToParcel(Parcel, ParcelableWriteFlags)	Aplane este objeto en un paquete.
WriteToXml(IXmlSerializer)	Escriba el contenido de IntentFilter como una secuencia XML.

Implementaciones de interfaz explícitas

IJavaPeerable.Disposed()	Descripción estructurada de los valores de intención que se van a buscar coincidencias. (Heredado de Object)
IJavaPeerable.DisposeUnlessReferenced()	Descripción estructurada de los valores de intención que se van a buscar coincidencias. (Heredado de Object)
IJavaPeerable.Finalized()	Descripción estructurada de los valores de intención que se van a buscar coincidencias. (Heredado de Object)
IJavaPeerable.JniManagedPeerState	Descripción estructurada de los valores de intención que se van a buscar coincidencias. (Heredado de Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Descripción estructurada de los valores de intención que se van a buscar coincidencias. (Heredado de Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Descripción estructurada de los valores de intención que se van a buscar coincidencias. (Heredado de Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Descripción estructurada de los valores de intención que se van a buscar coincidencias. (Heredado de Object)

Métodos de extensión

JavaCast<TResult>(IJavaObject)	Realiza una conversión de tipos comprobados en tiempo de ejecución de Android.
JavaCast<TResult>(IJavaObject)	Descripción estructurada de los valores de intención que se van a buscar coincidencias.
GetJniTypeName(IJavaPeerable)	Descripción estructurada de los valores de intención que se van a buscar coincidencias.