語言

IntentFilter 類別

定義

結構化描述待匹配的意圖值。

[Android.Runtime.Register("android/content/IntentFilter", DoNotGenerateAcw=true)]
public class IntentFilter : Java.Lang.Object, Android.OS.IParcelable, IDisposable
[<Android.Runtime.Register("android/content/IntentFilter", DoNotGenerateAcw=true)>]
type IntentFilter = class
    inherit Object
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
繼承
IntentFilter
屬性
實作

備註

結構化描述待匹配的意圖值。 IntentFilter 可以與 Intent 中的動作、類別和資料(透過其型別、方案和/或路徑)進行匹配。 它還包含一個「優先權」值,用來訂購多個匹配的濾波器。

IntentFilter 物件通常以 XML 作為套件 android.R.styleable#AndroidManifest AndroidManifest.xml 檔案的一部分,並使用 android.R.styleable#AndroidManifestIntentFilter intent-filter 標籤建立。

您可以篩選三種意圖特徵: 動作、 資料和 類別。 對於這些特徵,你可以提供多個可能的匹配值(分別透過 #addAction、 #addDataType、 #addDataScheme#addDataSchemeSpecificPart#addDataAuthority#addDataPath#addCategory, )。 對於動作,若未指定資料特徵,過濾器只會匹配不包含資料的意圖。

資料特徵本身分為三個屬性:類型、方案、權威與路徑。 所指定的任何內容必須與意圖內容相符。 如果你指定一個方案但沒有類型,只有沒有型別的意圖(例如 mailto:)才會匹配;A 內容:URI 永遠無法匹配,因為他們總是有由內容提供者提供的 MIME 類型。 指定一個沒有 scheme 的型別具有特殊意義:它會匹配一個沒有 URI 欄位的 Intent,或是 INTENT 有內容:或檔案:URI。 如果你兩者都不指定,那麼只有沒有資料或類型的意圖才會匹配。 要指定一個權威,你也必須指定它所關聯的一個或多個方案。 要指定一條路徑,你還必須同時指定一個或多個權威以及它所關聯的一個或多個方案。

<div class=“特殊參考”><h3>開發者指南</h3>

如需了解如何建立與解析意圖,請參閱《 意圖與意圖過濾器 》開發者指南。

</div>

<h3>篩選規則</h3>

比賽依據以下規則進行。 請注意,要讓 IntentFilter 與 Intent 相符,必須符合三個條件: 動作 與 類別 必須相符,且資料(資料 型態 與 資料方案+權限+路徑 (若指定時)必須相符(有關資料欄位如何匹配的詳細資訊,請參閱相關 #match(ContentResolver, Intent, boolean, String) 細節)。

動作匹配,若任一給定值符合意圖動作;如果篩選器指定沒有動作,則它只會匹配不包含動作的意圖。

若任一給定值符合意圖類型,則資料類型相符。 意圖類型是透過呼叫 Intent#resolveType來決定的。 MIME 子類型可在 Intent 與 IntentFilter 中使用通配符,使「audio/*」類型與「audio/mpeg」、「audio/aiff」、「audio/*」等相符。 <em>請注意,這裡的 MIME 類型匹配是 區分大小寫的,與正式的 RFC MIME 類型不同!</em> 因此,你的 MIME 類型應始終使用小寫字母。

若任一給定值與意圖資料的方案相符,則「資料方案」相符。 意圖方案是透過呼叫 Intent#getData 該 android.net.Uri#getScheme URI 來決定的。 <em>請注意,這裡的結構匹配是 區分大小寫的,與正式的 RFC 格式不同!</em> 因此,您的方案應始終使用小寫字母。

若任一值符合意圖資料方案特定部分,且篩選器中的某一資料方案符合意圖,或篩選器中未提供方案特定部分,則匹配資料方案特定部分。 意圖方案的特定部分是透過呼叫 Intent#getData 該 android.net.Uri#getSchemeSpecificPart URI 來決定的。 <em>請注意,方案特定的零件匹配區 分大小寫。</em>

若任一給定值與意圖的資料權限相符,且篩選器中的某一資料方案符合意圖,或篩選器中未提供授權,則資料權限匹配。 意圖權限是透過呼叫 Intent#getData 該 android.net.Uri#getAuthority URI 來決定的。 <em>請注意,這裡的權威匹配是 區分大小寫的,這與正式的 RFC 主機名稱不同!</em> 因此,您應始終使用小寫字母表示您的權限。

若任一給定值與意圖的資料路徑相符,且篩選器中的方案與權限都與意圖相符,或篩選器中未提供路徑,則資料路徑匹配。 意圖權限是透過呼叫 Intent#getData 該 android.net.Uri#getPath URI 來決定的。

若「意圖」中的所有類別都符合篩選條件中所給的類別,則該類別符合。 篩選中不在意圖範圍內的額外類別不會導致配對失敗。 請注意,與動作不同,沒有類別的 IntentFilter 只會匹配到沒有任何類別的 Intent。

Java 文件 android.content.IntentFilter。

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

建構函式

名稱 Description
IntentFilter()

新的空 IntentFilter。

IntentFilter(IntentFilter)

新 IntentFilter 包含現有過濾器的副本。

IntentFilter(IntPtr, JniHandleOwnership)

用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。

IntentFilter(String, String)

新的 IntentFilter 可以匹配單一動作和資料型態。

IntentFilter(String)

新的 IntentFilter 能匹配一個沒有資料的單一動作。

欄位

名稱 Description
SystemHighPriority
已淘汰.

系統高優先接收器放置的濾波 #setPriority 值;也就是應在應用程式碼之前執行的接收器。

SystemLowPriority
已淘汰.

系統低優先權接收器放置的濾波 #setPriority 器值;也就是應在應用程式程式碼後執行的接收器。

屬性

名稱 Description
Class

回傳此 Object的執行時類別。

(繼承來源 Object)
Creator

取得用來重建意圖篩選器的 parcel factory。

Handle

底層 Android 實例的帳號。

(繼承來源 Object)
JniIdentityHashCode

取得由互通執行時指派給此 Java 對等端的身份雜湊碼。

(繼承來源 Object)
JniManagedPeerState

取得執行時最後指派的狀態旗標。

(繼承來源 JavaObject)
JniPeerMembers

取得用於調用此 Java 節點成員的 JNI 元資料。

PeerReference

取得這個 Java 節點的 JNI 物件參考。

(繼承來源 Object)
Priority

回傳這個過濾器的優先權。 -或者- 修改這個過濾器的優先順序。

ThresholdClass

此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。

ThresholdType

此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。

方法

名稱 Description
ActionsIterator()

回傳一個迭代器,檢視過濾器的動作。

AddAction(String)

新增一個意圖動作來配對。

AddCategory(String)

新增一個意圖類別來對戰。

AddDataAuthority(String, String)

新增一個意圖資料權限來比對。

AddDataPath(String, Pattern)

新增一條意圖資料路徑來比對。

AddDataScheme(String)

新增一個新的意圖資料方案來比對。

AddDataSchemeSpecificPart(String, Pattern)

新增一個意圖資料「方案特定部分」來比對。

AddDataType(String)

新增一個新的意圖資料類型來比對。

AddUriRelativeFilterGroup(UriRelativeFilterGroup)

新增一個 URI 相對濾波器群組,以與意圖資料相符。

AsPredicate()

回傳 a Predicate ,以測試此篩選器是否符合指定的 意圖。

AsPredicateWithTypeResolution(ContentResolver)

回傳 a Predicate ,以測試此篩選器是否符合指定的 意圖。

AuthoritiesIterator()

回傳一個迭代器,對過濾器的資料權限。

CategoriesIterator()

回傳過濾器類別的迭代器。

ClearUriRelativeFilterGroups()

移除意圖過濾器中所有現有的 URI 相對濾波器群組。

Clone()

建立並回傳此物件的副本。

(繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)

將此對等節點的建置委派給執行時的值管理器。

(繼承來源 JavaObject)
CountActions()

回傳篩選器中的動作數量。

CountCategories()

回傳篩選器中的分類數量。

CountDataAuthorities()

在篩選器中回傳資料權威的數量。

CountDataPaths()

回傳濾波器中的資料路徑數量。

CountDataSchemes()

回傳篩選器中的資料方案數量。

CountDataSchemeSpecificParts()

在篩選器中回傳資料方案特定部分的數量。

CountDataTypes()

回傳篩選器中的資料類型數量。

CountUriRelativeFilterGroups()

在意圖過濾器中回傳 URI 相對濾波器群組的數量。

Create(String, String)

建立一個新的 IntentFilter 實例,設定指定的動作和 MIME 類型,並且你知道 MIME 類型格式正確。

DescribeContents()

描述此 Parcelable 的組建表示中包含的特殊物件種類。

Dispose()

釋放該 Java 節點所持有的資源。

(繼承來源 Object)
Dispose(Boolean)

釋放該 Java 節點所持有的資源。

(繼承來源 Object)
DisposeUnlessReferenced()

請求值管理器處置此對等節點,除非其映射保留該受管理實例。

(繼承來源 JavaObject)
Dump(IPrinter, String)

將此篩選器的診斷細節寫入附帶的印表機,並附帶該行前綴。

Equals(Object)

測試另一個受管理節點是否參考相同的 Java 物件。

(繼承來源 JavaObject)
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 將會永遠 回傳。

HasCategory(String)

該分類是否包含在篩選條件中?

HasDataAuthority(Uri)

該資料權威是否包含在篩選中? 請注意,如果篩選器不包含任何權威,false 會一直 回傳。

HasDataPath(String)

給定的資料路徑是否包含在過濾器中? 請注意,如果篩選器不包含任何路徑,false 會一直 回傳。

HasDataScheme(String)

給定的資料方案是否包含在篩選器中? 請注意,如果濾波器不包含任何方案,false 將永遠 回傳。

HasDataSchemeSpecificPart(String)

該資料方案是否包含在篩選器中? 請注意,如果濾波器不包含任何特定方案的部分,false 將永遠 回傳。

HasDataType(String)

這個給定的資料型別是否包含在篩選器中? 請注意,如果篩選器不包含任何類型,false 會一直 回傳。

JavaFinalize()
已淘汰.

當垃圾回收判定該物件不再有相關參考時,由垃圾回收器呼叫。

(繼承來源 Object)
Match(ContentResolver, Intent, Boolean, String)

測試此篩選器是否符合給定 的意圖。

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

測試此過濾器是否與給定的意圖資料相符。

MatchAction(String)

將此過濾器與意圖的行動相匹配。

MatchCategories(ICollection<String>)

將此篩選器與意圖的分類進行比對。

MatchData(String, String, Uri)

將此篩選器與意圖的資料(類型、方案與路徑)比對。

MatchDataAuthority(Uri)

將這個意圖過濾器與給定的意圖資料比對。

Notify()

喚醒一個正在該物件監視器上等待的執行緒。

(繼承來源 Object)
NotifyAll()

喚醒所有等待該物件監視器的執行緒。

(繼承來源 Object)
PathsIterator()

回傳一個對過濾器資料路徑的迭代器。

ReadFromXml(XmlReader)

從所附的 XML 解析器讀取篩選條件與驗證狀態。

SchemesIterator()

回傳一個對濾波器資料方案的迭代器。

SchemeSpecificPartsIterator()

回傳濾波器資料方案特定部分的迭代器。

SetHandle(IntPtr, JniHandleOwnership)

設定 Handle 屬性。

(繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

在控制區塊中儲存參考值,但不建立 JNI 參考副本。

(繼承來源 JavaObject)
ToArray<T>()

從這個 Java 陣列包裝器建立一個受管理陣列。

(繼承來源 Object)
ToString()

回傳物件的字串表示。

(繼承來源 Object)
TypesIterator()

回傳過濾器資料型態的迭代器。

UnregisterFromRuntime()

將此 Java 節點從互通執行時中取消註冊。

(繼承來源 Object)
Wait()

使目前執行緒等待被喚醒,通常是透過 通知 或 中斷。

(繼承來源 Object)
Wait(Int64, Int32)

使目前執行緒等待被喚醒(通常是透過 通知 或 中斷),或等待一定的實際時間過去。

(繼承來源 Object)
Wait(Int64)

使目前執行緒等待被喚醒(通常是透過 通知 或 中斷),或等待一定的實際時間過去。

(繼承來源 Object)
WriteToParcel(Parcel, ParcelableWriteFlags)

把這個物體壓扁成一個包裹。

WriteToXml(IXmlSerializer)

將 IntentFilter 的內容寫成 XML 串流。

明確介面實作

名稱 Description
IJavaPeerable.Disposed()

標記此節點為處置,並以disposing設定為 true的呼叫Dispose。

(繼承來源 JavaObject)
IJavaPeerable.Finalized()

標記此節點為處置,並以disposing設定為 false的呼叫Dispose。

(繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

取得此對等端使用的原生控制區塊指標。

(繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

儲存執行時提供的身份雜湊碼。

(繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

取代儲存的受管理對等狀態旗標。

(繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

當引用無效時,更新對等節點並釋放已拋棄節點的控制區塊。

(繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()

將此實例從執行時的 Java 物件查詢中移除。

擴充方法

名稱 Description
GetJniTypeName(IJavaPeerable)

取得實例 self類型的 JNI 名稱。

JavaAs<TResult>(IJavaPeerable)

試著強制self輸入 TResult,檢查 強制在 Java 端是否有效。

JavaCast<TResult>(IJavaObject)

執行 Android 執行時檢查型別轉換。

JavaCast<TResult>(IJavaObject)

重用相容的受管理對等端或取得請求型態的包裝器。

TryJavaCast<TResult>(IJavaPeerable, TResult)

試著強制self輸入 TResult,檢查 強制在 Java 端是否有效。

適用於