Compartir a través de


IntentFilter Clase

Definición

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
IntentFilter
Atributos
Implementaciones

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: la <acción< em>/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#addDataAuthority#addDataSchemeSpecificPart, , , #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 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>Reglas< de filtro/h3>

Una coincidencia se basa en las reglas siguientes. 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>como el <esquema de datos seguro y <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 IntentFilter, para que el tipo "audio/*" coincida con "audio/mpeg", "audio/aiff", "audio/*", etc. <em Tenga en>cuenta que la coincidencia de tipos MIME aquí es <b>distingue mayúsculas de minúsculas</b>, a diferencia de los tipos MIME DE RFC formales!</em> Debe usar siempre letras minúsculas para los tipos MIME.

<strong>Data Scheme</strong> match 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 esquemas aquí es <b>distingue mayúsculas< de minúsculas/b>, a diferencia de los esquemas RFC formales.</em> Debe usar siempre letras minúsculas para sus esquemas.

<strong>Data Scheme Specific Part</strong> match 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> matches 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 autoridad que coincide aquí es <b>distingue mayúsculas de minúsculas</b>, a diferencia de los nombres de host RFC formales.</em> Debe usar siempre letras minúsculas para su autoridad.

<>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 se proporcionó ninguna ruta de acceso en el filtro. 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 abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.

Constructores

IntentFilter()

Nuevo IntentFilter vacío.

IntentFilter(IntentFilter)

New IntentFilter que contiene una copia de un filtro existente.

IntentFilter(IntPtr, JniHandleOwnership)

Constructor utilizado al crear representaciones administradas de objetos JNI; llamado por el tiempo de ejecución.

IntentFilter(String)

New IntentFilter que coincide con una sola acción sin datos.

IntentFilter(String, String)

New 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 los receptores de alta prioridad del sistema; es decir, receptores que deben ejecutarse 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 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 para que coincida con.

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.

AddDataPath(String, Pattern)

Agregue una nueva ruta de acceso de datos intent para que coincida.

AddDataScheme(String)

Agregue un nuevo esquema de datos Intent para que coincida.

AddDataSchemeSpecificPart(String, Pattern)

Agregue un nuevo "elemento específico del esquema" de datos de intención para que coincida.

AddDataType(String)

Agregue un nuevo tipo de datos Intent para que coincida.

AsPredicate()

Devuelve un Predicate objeto que comprueba si este filtro coincide con la intención</>var> especificada<.

AsPredicateWithTypeResolution(ContentResolver)

Devuelve un Predicate objeto 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 del 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 y un tipo MIME especificados, 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 <>siempre</em>.

HasCategory(String)

¿Se incluye la categoría especificada en el filtro?

HasDataAuthority(Uri)

¿Se incluye la entidad 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á false <>siempre</em>.

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 <>siempre</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 <>siempre</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 <>siempre</em>.

JavaFinalize()

Lo llama 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)

Coincide con este filtro con los datos de una intención (tipo, esquema y ruta de acceso).

MatchDataAuthority(Uri)

Coincide con 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 a través de 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 despierta, 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 <em>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 <em>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.

Se aplica a