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
継承
IntentFilter
属性
実装

注釈

照合する意図値の構造化された説明。 IntentFilter は、意図内のアクション、カテゴリ、およびデータ (型、スキーム、パスを介して) と照合できます。 また、複数の一致するフィルターを並べ替えるために使用される "priority" 値も含まれます。

IntentFilter オブジェクトは、多くの場合、android.R.styleable#AndroidManifestIntentFilter intent-filter タグを使用して、パッケージのandroid.R.styleable#AndroidManifest AndroidManifest.xml ファイルの一部として XML で作成されます。

フィルター処理できるインテント特性には、 <em>action</em>、 <em>data</em>、および <em>categories</em> の 3 つがあります。 これらの特性ごとに、複数の一致する値を指定できます (それぞれ、 #addAction#addDataType#addDataScheme#addDataSchemeSpecificPart#addDataAuthority#addDataPath、および #addCategory)。 アクションの場合、データ特性が指定されていない場合、フィルターはデータを含まない意図にのみ一致します。

データ特性自体は、型、スキーム、権限、パスの 3 つの属性に分かれています。 指定された内容は、意図の内容と一致する必要があります。 スキームを指定しても型を指定しない場合は、型を持たない意図 (mailto:など) のみが一致します。コンテンツ: URI は常にコンテンツ プロバイダーによって提供される MIME の種類を持っているため、一致しません。 スキームのない型を指定する場合は、URI フィールドのない意図と一致するか、コンテンツ URI または file: URI を持つ意図のいずれかと一致します。 どちらも指定しない場合は、データまたは型を持たない意図のみが一致します。 権限を指定するには、関連付けられている 1 つ以上のスキームも指定する必要があります。 パスを指定するには、1 つ以上の権限と、それに関連付けられている 1 つ以上のスキームの両方も指定する必要があります。

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

意図を作成して解決する方法については、 意図と意図フィルター の開発者ガイドを参照してください。

</部>

<h3>Filter Rules</h3>

一致は、次の規則に基づいています。 IntentFilter が意図と一致するには、3 つの条件 ( <strong>action</strong> と <strong>category</strong> が一致する必要があることに注意してください。 とデータ ( <strong>data 型</strong> と <strong>data scheme+authority+path</strong> が一致する必要があります (データ フィールドの一致の詳細については、 #match(ContentResolver, Intent, boolean, String) を参照してください)。

<strong>Action</strong> は、指定された値のいずれかが意図アクションと一致する場合に一致します。フィルターでアクションが指定されていない場合は、アクションを含まない意図にのみ一致します。

<strong>Data Type</strong> は、指定された値のいずれかが意図の種類と一致する場合に一致します。 意図の種類は、 Intent#resolveTypeを呼び出すことによって決定されます。 Intent と IntentFilter の両方で MIME サブタイプにワイルドカードを使用して、"audio/*" 型が "audio/mpeg"、"audio/aiff"、"audio/*" などに一致するようにすることができます <em>ここで一致する MIME タイプは、正式な RFC MIME の種類とは異なり、 <b>case sensitive</b> です。!</em> MIME の種類には常に小文字を使用する必要があります。

<strong>Data Scheme</strong> は、指定された値のいずれかが意図データのスキームと一致する場合に一致します。 意図スキームは、その URI で Intent#getDataandroid.net.Uri#getScheme を呼び出すことによって決定されます。 <em>ここで一致するスキームは、正式な RFC スキームとは異なり、 <b>case sensitive</b> です。<!/em> スキームには常に小文字を使用する必要があります。

<strong>Data Scheme Specific Part</strong> は、指定された値のいずれかが意図のデータ スキーム固有の部分と一致 <em>and</em> フィルター内のデータ スキームの 1 つが意図、 <em>or</em と一致した場合> スキーム固有の部分がフィルターで指定されなかった場合に一致します。 意図スキーム固有の部分は、その URI で Intent#getDataandroid.net.Uri#getSchemeSpecificPart を呼び出すことによって決定されます。 <em>パターン固有のパーツマッチングが <b>case sensitive</b>.</em>

<strong>Data Authority</strong> は、指定された値のいずれかが意図のデータ機関 <em>and</em> 1 つのデータ スキームが意図 ( <em>or</em) と一致した場合に一致します> フィルターで権限が指定されていません。 インテント権限は、 Intent#getData を呼び出し、その URI に対して android.net.Uri#getAuthority することによって決定されます。 <em>正式な RFC ホスト名とは異なり、ここで一致する権限は <b>case sensitive</b> です。!</em> 権限には常に小文字を使用する必要があります。

<strong>Data Path</strong> は、指定された値のいずれかが意図のデータ パス <em>and</em> フィルター内のスキームと権限の両方が Intent、 <em>or</em> に一致した場合に一致しますフィルターにパスが指定されていません。 インテント権限は、 Intent#getData を呼び出し、その URI に対して android.net.Uri#getPath することによって決定されます。

<strong>Categories</strong><em>all</em> の場合は、フィルターで指定された意図の一致カテゴリに一致します。 意図に含まれていないフィルター内の追加のカテゴリでは、一致が失敗することはありません。 アクションとは異なり、カテゴリのない IntentFilter は、カテゴリを持たない意図にのみ一致します。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

コンストラクター

名前 説明
IntentFilter()

新しい空の IntentFilter。

IntentFilter(IntentFilter)

既存のフィルターのコピーを含む新しい IntentFilter。

IntentFilter(IntPtr, JniHandleOwnership)

JNI オブジェクトのマネージド表現を作成するときに使用されるコンストラクター。ランタイムによって呼び出されます。

IntentFilter(String, String)

1 つのアクションとデータ型に一致する新しい IntentFilter。

IntentFilter(String)

データのない単一のアクションに一致する新しい IntentFilter。

フィールド

名前 説明
SystemHighPriority
古い.

フィルター #setPriority システムの優先度の高いレシーバーが配置される値、つまりアプリケーション コードの前に実行する必要があるレシーバーです。

SystemLowPriority
古い.

フィルター #setPriority システムの優先順位の低いレシーバーが配置される値、つまりアプリケーション コードの後に実行する必要があるレシーバーです。

プロパティ

名前 説明
Class

この Objectのランタイム クラスを返します。

(継承元 Object)
Creator
Handle

基になる Android インスタンスへのハンドル。

(継承元 Object)
JniIdentityHashCode

照合する意図値の構造化された説明。

(継承元 Object)
JniPeerMembers

照合する意図値の構造化された説明。

PeerReference

照合する意図値の構造化された説明。

(継承元 Object)
Priority

このフィルターの優先順位を返します。 または、このフィルターの優先度を変更します。

ThresholdClass

この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。

ThresholdType

この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。

メソッド

名前 説明
ActionsIterator()

フィルターのアクションに対する反復子を返します。

AddAction(String)

照合する新しい意図アクションを追加します。

AddCategory(String)

照合する新しい意図カテゴリを追加します。

AddDataAuthority(String, String)

照合する新しい意図データ機関を追加します。

AddDataPath(String, Pattern)

照合する新しい意図データ パスを追加します。

AddDataScheme(String)

照合する新しい意図データスキームを追加します。

AddDataSchemeSpecificPart(String, Pattern)

照合する新しい意図データ "スキーム固有の部分" を追加します。

AddDataType(String)

照合する新しい意図データ型を追加します。

AddUriRelativeFilterGroup(UriRelativeFilterGroup)

意図データと照合する新しい URI 相対フィルター グループを追加します。

AsPredicate()

このフィルターが指定された<var>intent</var>と一致するかどうかをテストするPredicateを返します。

AsPredicateWithTypeResolution(ContentResolver)

このフィルターが指定された<var>intent</var>と一致するかどうかをテストするPredicateを返します。

AuthoritiesIterator()

フィルターのデータ機関に対する反復子を返します。

CategoriesIterator()

フィルターのカテゴリに対する反復子を返します。

ClearUriRelativeFilterGroups()

意図フィルター内の既存の URI 相対フィルター グループをすべて削除します。

Clone()

このオブジェクトのコピーを作成して返します。

(継承元 Object)
CountActions()

フィルター内のアクションの数を返します。

CountCategories()

フィルター内のカテゴリの数を返します。

CountDataAuthorities()

フィルター内のデータ機関の数を返します。

CountDataPaths()

フィルター内のデータ パスの数を返します。

CountDataSchemes()

フィルター内のデータ スキームの数を返します。

CountDataSchemeSpecificParts()

フィルター内のデータ スキーム固有の部分の数を返します。

CountDataTypes()

フィルター内のデータ型の数を返します。

CountUriRelativeFilterGroups()

意図フィルター内の URI 相対フィルター グループの数を返します。

Create(String, String)

指定したアクションと MIME の種類を使用して、新しい IntentFilter インスタンスを作成します。MIME の種類が正しく書式設定されていることがわかります。

DescribeContents()

このパーセルのマーシャリング表現に含まれる特殊なオブジェクトの種類について説明します。

Dispose()

照合する意図値の構造化された説明。

(継承元 Object)
Dispose(Boolean)

照合する意図値の構造化された説明。

(継承元 Object)
Dump(IPrinter, String)
Equals(Object)

他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。

(継承元 Object)
GetAction(Int32)

フィルター内のアクションを返します。

GetCategory(Int32)

フィルター内のカテゴリを返します。

GetDataAuthority(Int32)

フィルター内のデータ権限を返します。

GetDataPath(Int32)

フィルター内のデータ パスを返します。

GetDataScheme(Int32)

フィルター内のデータスキームを返します。

GetDataSchemeSpecificPart(Int32)

フィルター内のデータ スキーム固有の部分を返します。

GetDataType(Int32)

フィルター内のデータ型を返します。

GetHashCode()

オブジェクトのハッシュ コード値を返します。

(継承元 Object)
GetUriRelativeFilterGroup(Int32)

意図フィルター内の URI 相対フィルター グループを返します。

HasAction(String)

指定されたアクションはフィルターに含まれていますか? フィルターにアクションが含まれていない場合、false は <em>always</em> 返されることに注意してください。

HasCategory(String)

指定されたカテゴリはフィルターに含まれていますか?

HasDataAuthority(Uri)

指定されたデータ機関はフィルターに含まれていますか? フィルターに権限が含まれていない場合、false は <em>always</em> 返されることに注意してください。

HasDataPath(String)

指定されたデータ パスはフィルターに含まれていますか? フィルターにパスが含まれていない場合、false は <em>always</em> 返されることに注意してください。

HasDataScheme(String)

指定されたデータスキームはフィルターに含まれていますか? フィルターにスキームが含まれていない場合、false は <em>always</em> 返されることに注意してください。

HasDataSchemeSpecificPart(String)

特定のデータ スキーム固有の部分はフィルターに含まれていますか? フィルターにスキーム固有の部分が含まれていない場合、false は <em>always</em> 返されることに注意してください。

HasDataType(String)

指定されたデータ型はフィルターに含まれていますか? フィルターに型が含まれていない場合、false は <em>always</em> 返されることに注意してください。

JavaFinalize()

オブジェクトへの参照がなくなったとガベージ コレクションによって判断されたときに、オブジェクトのガベージ コレクターによって呼び出されます。

(継承元 Object)
Match(ContentResolver, Intent, Boolean, String)

このフィルターが指定された <var>intent</var>と一致するかどうかをテストします。

Match(String, String, String, Uri, ICollection<String>, String)

このフィルターが特定の意図データと一致するかどうかをテストします。

MatchAction(String)

このフィルターを意図のアクションと照合します。

MatchCategories(ICollection<String>)

このフィルターを意図のカテゴリと照合します。

MatchData(String, String, Uri)

このフィルターを意図のデータ (型、スキーム、パス) と照合します。

MatchDataAuthority(Uri)

この意図フィルターを特定の意図データと照合します。

Notify()

このオブジェクトのモニターで待機している 1 つのスレッドを起動します。

(継承元 Object)
NotifyAll()

このオブジェクトのモニターで待機しているすべてのスレッドを起動します。

(継承元 Object)
PathsIterator()

フィルターのデータ パスに対する反復子を返します。

ReadFromXml(XmlReader)
SchemesIterator()

フィルターのデータスキームに対する反復子を返します。

SchemeSpecificPartsIterator()

フィルターのデータ スキーム固有の部分に対する反復子を返します。

SetHandle(IntPtr, JniHandleOwnership)

Handle プロパティを設定します。

(継承元 Object)
ToArray<T>()

照合する意図値の構造化された説明。

(継承元 Object)
ToString()

オブジェクトの文字列形式を返します。

(継承元 Object)
TypesIterator()

フィルターのデータ型に対する反復子を返します。

UnregisterFromRuntime()

照合する意図値の構造化された説明。

(継承元 Object)
Wait()

現在のスレッドが起動するまで待機します。通常は、 <em>notified</em> または <em>interrupted</em>。

(継承元 Object)
Wait(Int64, Int32)

現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。

(継承元 Object)
Wait(Int64)

現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。

(継承元 Object)
WriteToParcel(Parcel, ParcelableWriteFlags)

このオブジェクトをパーセルにフラット化します。

WriteToXml(IXmlSerializer)

IntentFilter の内容を XML ストリームとして書き込みます。

明示的なインターフェイスの実装

名前 説明
IJavaPeerable.Disposed()

照合する意図値の構造化された説明。

(継承元 Object)
IJavaPeerable.DisposeUnlessReferenced()

照合する意図値の構造化された説明。

(継承元 Object)
IJavaPeerable.Finalized()

照合する意図値の構造化された説明。

(継承元 Object)
IJavaPeerable.JniManagedPeerState

照合する意図値の構造化された説明。

(継承元 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)

照合する意図値の構造化された説明。

(継承元 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

照合する意図値の構造化された説明。

(継承元 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)

照合する意図値の構造化された説明。

(継承元 Object)

拡張メソッド

名前 説明
GetJniTypeName(IJavaPeerable)

インスタンス selfの型の JNI 名を取得します。

JavaAs<TResult>(IJavaPeerable)

selfを強制的にTResult入力し、強制型がJava側で有効であることを確認します。

JavaCast<TResult>(IJavaObject)

Android ランタイムチェック型変換を実行します。

JavaCast<TResult>(IJavaObject)

照合する意図値の構造化された説明。

TryJavaCast<TResult>(IJavaPeerable, TResult)

selfを強制的にTResult入力し、強制型がJava側で有効であることを確認します。

適用対象