IntentFilter 类

定义

[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

继承

Object

Object

IntentFilter

属性

RegisterAttribute

实现

IParcelable IJavaObject IJavaPeerable IDisposable

注解

要匹配的意向值的结构化说明。 IntentFilter 可以匹配意向中的操作、类别和数据（通过其类型、方案和/或路径）。 它还包括用于对多个匹配筛选器进行排序的“优先级”值。

IntentFilter 对象通常使用android.R.styleable#AndroidManifestIntentFilter intent-filter标记在 XML 中创建，作为包android.R.styleable#AndroidManifest AndroidManifest.xml文件的一部分。

可以筛选三个意向特征：em action/em>、<em>data</em> 和 <em>categories</em>。<>< 对于每个特征，可以分别提供多个可能的匹配值（通过#addAction、、#addDataType、#addDataScheme#addDataSchemeSpecificPart、#addDataAuthority、#addDataPath和#addCategory）。 对于操作，如果未指定任何数据特征，则筛选器将仅匹配不包含数据的意向。

数据特征本身分为三个属性：类型、方案、权威和路径。 指定的任何内容都必须与意向的内容匹配。 如果指定方案但没有类型，则只有没有类型（如 mailto：）的意向才会匹配;内容：URI 永远不会匹配，因为它们始终具有内容提供程序提供的 MIME 类型。 指定没有方案的类型具有一些特殊含义：它将匹配没有 URI 字段的意向，或者包含内容或文件：URI 的意向。 如果两者均未指定，则只有没有数据或类型的意向匹配。 若要指定颁发机构，还必须指定与其关联的一个或多个方案。 若要指定路径，还必须同时指定一个或多个颁发机构及其关联的一个或多个方案。

<div class=“special reference”><h3>Developer Guides</h3>

有关如何创建和解决意向的信息，请阅读 意向和意向筛选器 开发人员指南。

</Div>

<h3>筛选器规则</h3>

匹配基于以下规则。 请注意，对于 IntentFilter 匹配意向，必须保留三个条件：强操作/强>和<强>类别</>强必须匹配，并且数据（<强>数据类型</强>和<强>数据方案+权限+路径</强>）必须匹配（请参阅#match(ContentResolver, Intent, boolean, String)有关数据字段匹配方式的更多详细信息）。<><

<如果任一给定值与意向操作匹配，则强>操作</强> 匹配;如果筛选器未指定任何操作，则只会匹配不包含操作的意向。

<如果任何给定值与意向类型匹配，则强>数据类型</强> 匹配。 意向类型通过调用 Intent#resolveType确定。 通配符可用于意向和 IntentFilter 中的 MIME 子类型，以便类型“audio/*”与“audio/mpeg”、“audio/aiff”、“audio/*”等匹配。 <em>请注意，此处匹配的 MIME 类型区分<<大小>写/b>，与正式 RFC MIME 类型不同！</em> 因此，应始终对 MIME 类型使用小写字母。

<如果任何给定值与意向数据方案匹配，则强>数据方案</强> 匹配。 意向方案通过调用 Intent#getData 和 android.net.Uri#getScheme 基于该 URI 来确定。 <em>请注意，此处匹配的方案区分<<大小>写/b>，与正式 RFC 方案不同！</em> 应始终对方案使用小写字母。

<如果任何给定值与意向的数据方案特定部分 em 和/em> 中的某个数据方案匹配，则强>数据方案特定部件<</强>匹配项与筛选器中的意向、<em>或</em> 未在筛选器中提供任何方案特定部分匹配。<> 特定意向方案部分由调用 Intent#getData 和 android.net.Uri#getSchemeSpecificPart 基于该 URI 确定。 <em>请注意，方案特定的部分匹配是 <b>区分大小写</b>。</em>

<如果任何给定值与意向的数据颁发机构 em 和/em> 中的某个数据方案匹配，则强>数据颁发机构/强>匹配，并且筛选器中未提供引文，<则>强数据颁发机构</<强>匹配。<>< 意向颁发机构通过调用 Intent#getData 和 android.net.Uri#getAuthority 基于该 URI 来确定。 <em>请注意，此处匹配的颁发机构区分<<>大小写/b>，与正式 RFC 主机名不同！</em> 因此，应始终为颁发机构使用小写字母。

<如果任何给定值匹配意向的数据路径 em 和/em> 筛选器中的方案和颁发机构都与意向匹配，则强>数据路径</强>匹配，<em>或</em> 未在筛选器中提供路径。<>< 意向颁发机构通过调用 Intent#getData 和 android.net.Uri#getPath 基于该 URI 来确定。

<如果意向匹配类别中给定的类别的所有/em，则强>类别</强>匹配><。>< 不在意向中的筛选器中的额外类别将导致匹配失败。 请注意，与操作不同，没有类别的 IntentFilter 将仅匹配不包含任何类别的意向。

Java文档android.content.IntentFilter。

本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。