IntentFilter Classe

Definição

Namespace:: Android.Content

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Descrição estruturada dos valores de intenção a serem correspondidos.

[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

Herança: Object

Object
IntentFilter

Atributos: RegisterAttribute

Implementações: IParcelable IJavaObject IJavaPeerable IDisposable

Comentários

Descrição estruturada dos valores de intenção a serem correspondidos. Um IntentFilter pode corresponder a ações, categorias e dados (por meio de seu tipo, esquema e/ou caminho) em uma Intenção. Ele também inclui um valor de "prioridade" que é usado para ordenar vários filtros correspondentes.

Objetos IntentFilter geralmente são criados em XML como parte do arquivo de android.R.styleable#AndroidManifest AndroidManifest.xml um pacote, usando android.R.styleable#AndroidManifestIntentFilter intent-filter marcas.

Há três características de intenção nas quais você pode filtrar: em <action/em>, data e categories.<> Para cada uma dessas características, você pode fornecer vários valores correspondentes possíveis (via#addAction, #addDataType, , #addDataScheme#addDataSchemeSpecificPart, , #addDataAuthoritye #addDataPath#addCategory, respectivamente). Para ações, se nenhuma característica de dados for especificada, o filtro corresponderá apenas às intenções que não contêm dados.

A característica de dados é dividida em três atributos: tipo, esquema, autoridade e caminho. Qualquer um especificado deve corresponder ao conteúdo da Intenção. Se você especificar um esquema, mas nenhum tipo, somente a Intenção que não tiver um tipo (como mailto:) corresponderá; um conteúdo: o URI nunca corresponderá porque eles sempre têm um tipo MIME fornecido pelo provedor de conteúdo. Especificar um tipo sem esquema tem um significado um pouco especial: ele corresponderá a uma Intenção sem um campo de URI ou uma Intenção com um conteúdo: ou arquivo: URI. Se você não especificar nenhum dos dois, apenas uma Intenção sem dados ou tipo corresponderá. Para especificar uma autoridade, você também deve especificar um ou mais esquemas aos quais ela está associada. Para especificar um caminho, você também deve especificar uma ou mais autoridades e um ou mais esquemas aos quais ele está associado.

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

Para obter informações sobre como criar e resolver intenções, leia o guia do desenvolvedor de Intenções e Filtros de Intenção .

</div>

<Regras< de filtro h3>/h3>

Uma correspondência é baseada nas regras a seguir. Observe que, para um IntentFilter corresponder a uma Intenção, três condições devem conter: a ação forte/forte> e <a categoria< forte>/forte> devem corresponder e os dados (tanto o <tipo< de dados forte>/forte> quanto <>o forte esquema de dados+autoridade+caminho</forte>, se especificado) devem corresponder (consulte #match(ContentResolver, Intent, boolean, String) mais detalhes sobre como os campos de dados correspondem).><<

<Ação< forte>/correspondências fortes> se qualquer um dos valores fornecidos corresponder à ação Intenção; se o filtro não especificar nenhuma ação, ele corresponderá apenas a Intenções que não contêm uma ação.

<tipo< de dados forte>/correspondências fortes> se qualquer um dos valores fornecidos corresponder ao tipo de intenção. O tipo de intenção é determinado chamando Intent#resolveType. Um curinga pode ser usado para o subtipo MIME, tanto no Intent quanto no IntentFilter, para que o tipo "audio/*" corresponda a "audio/mpeg", "audio/aiff", "audio/*", etc. Observe que o tipo MIME correspondente aqui é <diferencial<> de maiúsculas de minúsculas/b>, ao contrário dos tipos formais de MIME RFC! Assim, você deve sempre usar letras minúsculas para seus tipos MIME.

Data Scheme matches if any of the given values match the Intent data's scheme. O esquema de intenção é determinado chamando Intent#getData e android.net.Uri#getScheme nesse URI. Observe que o esquema correspondente aqui diferencia maiúsculas <<>de minúsculas/b>, ao contrário de esquemas RFC formais! Assim, você deve sempre usar letras minúsculas para seus esquemas.

< >strong Data Scheme Specific Part matches if any of the given values match the Intent's data scheme specific part and one of the data schemes in the filter has matched the Intent, or no scheme specific parts were supplied in the filter. A parte específica do esquema de intenção é determinada por meio da chamada Intent#getData e android.net.Uri#getSchemeSpecificPart desse URI. Observe que a correspondência de partes específicas do esquema diferencia maiúsculas <<>de minúsculas/b.<>/em>

< >strong Data Authority matches if any of the given values match the Intent's data authority and one of the data schemes in the filter has matched the Intent, or no authorities were supplied in the filter. A autoridade de intenção é determinada chamando Intent#getData e android.net.Uri#getAuthority sobre esse URI. Observe que a correspondência de autoridade aqui diferencia maiúsculas <<>de minúsculas/b>, ao contrário dos nomes formais de host RFC! Você deve, portanto, sempre usar letras minúsculas para sua autoridade.

< >strong Data Path matches if any of the given values match the Intent's data path and both a scheme and authority in the filter has matched against the Intent, or no paths were supplied in the filter. A autoridade de intenção é determinada chamando Intent#getData e android.net.Uri#getPath sobre esse URI.

< >strong Categories match if all of the categories in the Intent match categories given in the filter. Categorias extras no filtro que não estão na Intenção não causarão falha na correspondência. Observe que, ao contrário da ação, um IntentFilter sem categorias corresponderá apenas a uma Intenção que não tenha nenhuma categoria.

Java documentação para android.content.IntentFilter.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Construtores

Nome	Description
IntentFilter()	Novo IntentFilter vazio.
IntentFilter(IntentFilter)	Novo IntentFilter que contém uma cópia de um filtro existente.
IntentFilter(IntPtr, JniHandleOwnership)	Um construtor usado ao criar representações gerenciadas de objetos JNI; chamado pelo runtime.
IntentFilter(String, String)	Novo IntentFilter que corresponde a uma única ação e tipo de dados.
IntentFilter(String)	Novo IntentFilter que corresponde a uma única ação sem dados.

Campos

Nome	Description
SystemHighPriority	Obsoleto. O valor do filtro `#setPriority` no qual os receptores de alta prioridade do sistema são colocados; ou seja, receptores que devem ser executados antes do código do aplicativo.
SystemLowPriority	Obsoleto. O valor do filtro `#setPriority` no qual os receptores de baixa prioridade do sistema são colocados; ou seja, receptores que devem ser executados após o código do aplicativo.

Propriedades

Nome	Description
Class	Retorna a classe de runtime deste `Object`. (Herdado de Object)
Creator
Handle	O identificador para a instância subjacente do Android. (Herdado de Object)
JniIdentityHashCode	Descrição estruturada dos valores de intenção a serem correspondidos. (Herdado de Object)
JniPeerMembers	Descrição estruturada dos valores de intenção a serem correspondidos.
PeerReference	Descrição estruturada dos valores de intenção a serem correspondidos. (Herdado de Object)
Priority	Retorne a prioridade desse filtro. -ou- Modifique a prioridade desse filtro.
ThresholdClass	Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código.
ThresholdType	Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código.

Métodos

Nome	Description
ActionsIterator()	Retorne um iterador sobre as ações do filtro.
AddAction(String)	Adicione uma nova ação de intenção para corresponder.
AddCategory(String)	Adicione uma nova categoria de Intenção à qual corresponder.
AddDataAuthority(String, String)	Adicione uma nova autoridade de dados de intenção para corresponder.
AddDataPath(String, Pattern)	Adicione um novo caminho de dados de intenção para corresponder.
AddDataScheme(String)	Adicione um novo esquema de dados de intenção com o qual corresponder.
AddDataSchemeSpecificPart(String, Pattern)	Adicione uma nova "parte específica do esquema" de dados de intenção para corresponder.
AddDataType(String)	Adicione um novo tipo de dados intent para corresponder.
AddUriRelativeFilterGroup(UriRelativeFilterGroup)	Adicione um novo grupo de filtros relativos de URI para corresponder aos dados de Intenção.
AsPredicate()	Retornar um `Predicate` teste que testa se esse filtro corresponde à intenção< de var>/var> fornecida<.
AsPredicateWithTypeResolution(ContentResolver)	Retornar um `Predicate` teste que testa se esse filtro corresponde à intenção< de var>/var> fornecida<.
AuthoritiesIterator()	Retorne um iterador sobre as autoridades de dados do filtro.
CategoriesIterator()	Retorne um iterador sobre as categorias do filtro.
ClearUriRelativeFilterGroups()	Remove todos os grupos de filtros relativos de URI existentes no filtro de intenção.
Clone()	Cria e retorna uma cópia desse objeto. (Herdado de Object)
CountActions()	Retorne o número de ações no filtro.
CountCategories()	Retorne o número de categorias no filtro.
CountDataAuthorities()	Retorne o número de autoridades de dados no filtro.
CountDataPaths()	Retorne o número de caminhos de dados no filtro.
CountDataSchemes()	Retorne o número de esquemas de dados no filtro.
CountDataSchemeSpecificParts()	Retorne o número de partes específicas do esquema de dados no filtro.
CountDataTypes()	Retorne o número de tipos de dados no filtro.
CountUriRelativeFilterGroups()	Retorne o número de grupos de filtros relativos de URI no filtro de intenção.
Create(String, String)	Crie uma nova instância IntentFilter com uma ação especificada e um tipo MIME, em que você sabe que o tipo MIME está formatado corretamente.
DescribeContents()	Descreva os tipos de objetos especiais contidos na representação marshalled deste Parcelable.
Dispose()	Descrição estruturada dos valores de intenção a serem correspondidos. (Herdado de Object)
Dispose(Boolean)	Descrição estruturada dos valores de intenção a serem correspondidos. (Herdado de Object)
Dump(IPrinter, String)
Equals(Object)	Indica se algum outro objeto é "igual a" este. (Herdado de Object)
GetAction(Int32)	Retornar uma ação no filtro.
GetCategory(Int32)	Retornar uma categoria no filtro.
GetDataAuthority(Int32)	Retornar uma autoridade de dados no filtro.
GetDataPath(Int32)	Retornar um caminho de dados no filtro.
GetDataScheme(Int32)	Retornar um esquema de dados no filtro.
GetDataSchemeSpecificPart(Int32)	Retornar uma parte específica do esquema de dados no filtro.
GetDataType(Int32)	Retornar um tipo de dados no filtro.
GetHashCode()	Retorna um valor de código hash para o objeto. (Herdado de Object)
GetUriRelativeFilterGroup(Int32)	Retornar um grupo de filtro relativo de URI no filtro de intenção.
HasAction(String)	A ação fornecida está incluída no filtro? Observe que, se o filtro não incluir nenhuma ação, false <será>retornado sempre</em.>
HasCategory(String)	A categoria fornecida está incluída no filtro?
HasDataAuthority(Uri)	A autoridade de dados fornecida está incluída no filtro? Observe que, se o filtro não incluir nenhuma autoridade, false <será>sempre</em> retornado.
HasDataPath(String)	O caminho de dados fornecido está incluído no filtro? Observe que, se o filtro não incluir nenhum caminho, false <será>retornado sempre</em.>
HasDataScheme(String)	O esquema de dados especificado está incluído no filtro? Observe que, se o filtro não incluir nenhum esquema, o false será <>sempre</em> retornado.
HasDataSchemeSpecificPart(String)	A parte específica do esquema de dados fornecida está incluída no filtro? Observe que, se o filtro não incluir partes específicas do esquema, false <será>sempre< retornado/em> .
HasDataType(String)	O tipo de dados fornecido está incluído no filtro? Observe que, se o filtro não incluir nenhum tipo, false <será>retornado sempre</em.>
JavaFinalize()	Chamado pelo coletor de lixo em um objeto quando a coleta de lixo determina que não há mais referências ao objeto. (Herdado de Object)
Match(ContentResolver, Intent, Boolean, String)	Teste se esse filtro corresponde à intenção< de var>/var> fornecida<.
Match(String, String, String, Uri, ICollection<String>, String)	Teste se esse filtro corresponde aos dados de intenção especificados.
MatchAction(String)	Corresponda a esse filtro com a ação de uma Intenção.
MatchCategories(ICollection<String>)	Corresponda a esse filtro em relação às categorias de uma Intenção.
MatchData(String, String, Uri)	Corresponda a esse filtro com os dados de uma intenção (tipo, esquema e caminho).
MatchDataAuthority(Uri)	Corresponda a esse filtro de intenção com os dados de Intenção especificados.
Notify()	Ativa um único thread que está aguardando no monitor deste objeto. (Herdado de Object)
NotifyAll()	Ativa todos os threads que estão aguardando no monitor deste objeto. (Herdado de Object)
PathsIterator()	Retorne um iterador sobre os caminhos de dados do filtro.
ReadFromXml(XmlReader)
SchemesIterator()	Retorne um iterador sobre os esquemas de dados do filtro.
SchemeSpecificPartsIterator()	Retorne um iterador sobre partes específicas do esquema de dados do filtro.
SetHandle(IntPtr, JniHandleOwnership)	Define a propriedade Handle (Herdado de Object)
ToArray<T>()	Descrição estruturada dos valores de intenção a serem correspondidos. (Herdado de Object)
ToString()	Retorna uma representação de cadeia de caracteres do objeto. (Herdado de Object)
TypesIterator()	Retorne um iterador sobre os tipos de dados do filtro.
UnregisterFromRuntime()	Descrição estruturada dos valores de intenção a serem correspondidos. (Herdado de Object)
Wait()	Faz com que o thread atual aguarde até ser despertado, normalmente por ser <notificado/em> ou <em>interrompido</em>.<> (Herdado de Object)
Wait(Int64, Int32)	Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object)
Wait(Int64)	Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object)
WriteToParcel(Parcel, ParcelableWriteFlags)	Nivele esse objeto em um Pacote.
WriteToXml(IXmlSerializer)	Escreva o conteúdo do IntentFilter como um fluxo XML.

Implantações explícitas de interface

Nome	Description
IJavaPeerable.Disposed()	Descrição estruturada dos valores de intenção a serem correspondidos. (Herdado de Object)
IJavaPeerable.DisposeUnlessReferenced()	Descrição estruturada dos valores de intenção a serem correspondidos. (Herdado de Object)
IJavaPeerable.Finalized()	Descrição estruturada dos valores de intenção a serem correspondidos. (Herdado de Object)
IJavaPeerable.JniManagedPeerState	Descrição estruturada dos valores de intenção a serem correspondidos. (Herdado de Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Descrição estruturada dos valores de intenção a serem correspondidos. (Herdado de Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Descrição estruturada dos valores de intenção a serem correspondidos. (Herdado de Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Descrição estruturada dos valores de intenção a serem correspondidos. (Herdado de Object)

Métodos de Extensão

Nome	Description
GetJniTypeName(IJavaPeerable)	Obtém o nome JNI do tipo da instância `self`.
JavaAs<TResult>(IJavaPeerable)	Tente coagir a digitar `selfTResult`, verificando se a coerção é válida no lado Java.
JavaCast<TResult>(IJavaObject)	Executa uma conversão de tipo marcada por runtime do Android.
JavaCast<TResult>(IJavaObject)	Descrição estruturada dos valores de intenção a serem correspondidos.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Tente coagir a digitar `selfTResult`, verificando se a coerção é válida no lado Java.

Aplica-se a