IntentFilter Kelas

Definisi

Ruang nama:: Android.Content

Rakitan:: Mono.Android.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Deskripsi terstruktur tentang nilai Niat yang akan dicocokkan.

[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

Warisan: Object

JavaObject

Object
IntentFilter

Atribut: RegisterAttribute

Penerapan: IParcelable IJavaObject IJavaPeerable IDisposable

Keterangan

Deskripsi terstruktur tentang nilai Niat yang akan dicocokkan. IntentFilter dapat cocok dengan tindakan, kategori, dan data (baik melalui jenis, skema, dan/atau jalurnya) dalam Niat. Ini juga mencakup nilai "prioritas" yang digunakan untuk memesan beberapa filter yang cocok.

Objek IntentFilter sering dibuat di XML sebagai bagian dari file paket android.R.styleable#AndroidManifest AndroidManifest.xml , menggunakan android.R.styleable#AndroidManifestIntentFilter intent-filter tag.

Ada tiga karakteristik Niat yang dapat Anda filter: <>em action, data, dan categories/em<.> Untuk setiap karakteristik ini, Anda dapat memberikan beberapa kemungkinan nilai yang cocok (melalui #addAction, , #addDataType#addDataScheme, #addDataSchemeSpecificPart, #addDataAuthority#addDataPath, dan #addCategory, masing-masing). Untuk tindakan, jika tidak ada karakteristik data yang ditentukan, filter hanya akan cocok dengan niat yang tidak berisi data.

Karakteristik data itu sendiri dibagi menjadi tiga atribut: jenis, skema, otoritas, dan jalur. Apa pun yang ditentukan harus cocok dengan konten Niat. Jika Anda menentukan skema tetapi tidak ada jenis, hanya Niat yang tidak memiliki jenis (seperti mailto:) yang akan cocok; konten: URI tidak akan pernah cocok karena mereka selalu memiliki jenis MIME yang disediakan oleh penyedia konten mereka. Menentukan jenis tanpa skema memiliki arti yang agak khusus: ini akan cocok dengan Niat tanpa bidang URI, atau Niat dengan konten: atau file: URI. Jika Anda tidak menentukan keduanya, maka hanya Niat tanpa data atau jenis yang akan cocok. Untuk menentukan otoritas, Anda juga harus menentukan satu atau beberapa skema yang terkait dengannya. Untuk menentukan jalur, Anda juga harus menentukan satu atau beberapa otoritas dan satu atau beberapa skema yang terkait dengannya.

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

Untuk informasi tentang cara membuat dan menyelesaikan niat, baca panduan pengembang Niat dan Filter Niat .

</div>

<h3>Aturan< Filter/h3>

Kecocokan didasarkan pada aturan berikut. Perhatikan bahwa agar IntentFilter sesuai dengan Niat, tiga kondisi harus ditahan: <tindakan yang kuat></kuat dan ><kategori>/kuat< harus cocok, dan data (jenis>< data yang kuat>/skema data yang kuat dan <kuat>< +otoritas+jalur>/kuat< jika ditentukan) harus cocok (lihat > untuk detail selengkapnya tentang bagaimana bidang data cocok).#match(ContentResolver, Intent, boolean, String)

<Tindakan> yang kuat</kuat> cocok jika salah satu nilai yang diberikan cocok dengan tindakan Niat; jika filter tidak menentukan tindakan, maka hanya akan cocok dengan Niat yang tidak berisi tindakan.

<Jenis> Data yang kuat</kuat> cocok jika salah satu nilai yang diberikan cocok dengan jenis Niat. Jenis Niat ditentukan dengan memanggil Intent#resolveType. Wildcard dapat digunakan untuk sub-jenis MIME, baik di Intent dan IntentFilter, sehingga jenis "audio/*" akan cocok dengan "audio/mpeg", "audio/aiff", "audio/*", dll. Perhatikan bahwa jenis MIME yang cocok di sini adalah peka huruf besar/, tidak seperti jenis RFC MIME formal! Anda harus selalu menggunakan huruf kecil untuk jenis MIME Anda.

<Skema> Data yang kuat</kecocokan kuat> jika salah satu nilai yang diberikan cocok dengan skema data Niat. Skema Niat ditentukan dengan memanggil Intent#getData dan android.net.Uri#getScheme pada URI tersebut. Perhatikan bahwa pencocokan skema di sini adalah peka huruf besar/, tidak seperti skema RFC formal!<> Dengan demikian, Anda harus selalu menggunakan huruf kecil untuk skema Anda.

<Skema Data yang kuat>Bagian< Spesifik/kecocokan kuat> jika salah satu nilai yang diberikan cocok dengan bagian tertentu <skema data Niat em>dan salah satu skema data dalam filter telah cocok dengan Niat, em<atau> tidak ada bagian spesifik skema yang disediakan dalam filter. Bagian spesifik skema Niat ditentukan dengan memanggil Intent#getData dan android.net.Uri#getSchemeSpecificPart pada URI tersebut. Perhatikan bahwa pencocokan bagian spesifik skema adalah peka huruf besar/.

<Otoritas> Data yang kuat</kuat> cocok jika salah satu nilai yang diberikan cocok dengan otoritas <data Niat em>dan salah satu skema data dalam filter telah cocok dengan Niat, em<atau> tidak ada otoritas yang disediakan dalam filter. Otoritas Niat ditentukan dengan memanggil Intent#getData dan android.net.Uri#getAuthority pada URI tersebut. Perhatikan bahwa otoritas yang cocok di sini adalah peka huruf besar/, tidak seperti nama host RFC formal!<> Dengan demikian, Anda harus selalu menggunakan huruf kecil untuk otoritas Anda.

<Jalur> Data yang kuat</kecocokan yang kuat> jika salah satu nilai yang diberikan cocok dengan jalur <data Niat em>dan baik skema dan otoritas dalam filter telah cocok dengan Niat, em<atau> tidak ada jalur yang disediakan dalam filter. Otoritas Niat ditentukan dengan memanggil Intent#getData dan android.net.Uri#getPath pada URI tersebut.

<Kategori> kuat</kecocokan kuat> jika <mereka>semua dari kategori dalam kategori Kecocokan niat yang diberikan dalam filter. Kategori tambahan dalam filter yang tidak ada dalam Niat tidak akan menyebabkan kecocokan gagal. Perhatikan bahwa tidak seperti tindakan, IntentFilter tanpa kategori hanya akan cocok dengan Niat yang tidak memiliki kategori apa pun.

Java dokumentasi untuk android.content.IntentFilter.

Bagian dari halaman ini adalah modifikasi berdasarkan pekerjaan yang dibuat dan dibagikan oleh Android Open Source Project dan digunakan sesuai dengan istilah yang dijelaskan dalam Lisensi Creative Commons 2.5 Lisensi Atribusi.

Konstruktor

Nama	Deskripsi
IntentFilter()	IntentFilter kosong baru.
IntentFilter(IntentFilter)	IntentFilter baru yang berisi salinan filter yang sudah ada.
IntentFilter(IntPtr, JniHandleOwnership)	Konstruktor yang digunakan saat membuat representasi terkelola objek JNI; dipanggil oleh runtime.
IntentFilter(String, String)	IntentFilter baru yang cocok dengan satu tindakan dan jenis data.
IntentFilter(String)	IntentFilter baru yang cocok dengan satu tindakan tanpa data.

Bidang

Nama	Deskripsi
SystemHighPriority	Kedaluwarsa. Nilai filter `#setPriority` tempat penerima prioritas tinggi sistem ditempatkan; yaitu penerima yang harus dijalankan sebelum kode aplikasi.
SystemLowPriority	Kedaluwarsa. Nilai filter `#setPriority` tempat penerima berprioritas rendah sistem ditempatkan; yaitu penerima yang harus dijalankan setelah kode aplikasi.

Properti

Nama	Deskripsi
Class	Mengembalikan kelas runtime dari .`Object` (Diperoleh dari Object)
Creator
Handle	Handel ke instans Android yang mendasar. (Diperoleh dari Object)
JniIdentityHashCode	Mendapatkan kode hash identitas yang ditetapkan ke Java peer ini oleh runtime interop. (Diperoleh dari Object)
JniManagedPeerState	Deskripsi terstruktur tentang nilai Niat yang akan dicocokkan. (Diperoleh dari JavaObject)
JniPeerMembers	Mendapatkan metadata JNI yang digunakan untuk memanggil anggota peer Java ini.
PeerReference	Mendapatkan referensi objek JNI untuk peer Java ini. (Diperoleh dari Object)
Priority	Mengembalikan prioritas filter ini. -or- Ubah prioritas filter ini.
ThresholdClass	API ini mendukung infrastruktur Mono untuk Android dan tidak dimaksudkan untuk digunakan langsung dari kode Anda.
ThresholdType	API ini mendukung infrastruktur Mono untuk Android dan tidak dimaksudkan untuk digunakan langsung dari kode Anda.

Metode

Nama	Deskripsi
ActionsIterator()	Mengembalikan iterator atas tindakan filter.
AddAction(String)	Tambahkan tindakan Niat baru untuk dicocokkan.
AddCategory(String)	Tambahkan kategori Niat baru untuk dicocokkan.
AddDataAuthority(String, String)	Tambahkan otoritas data Niat baru untuk dicocokkan.
AddDataPath(String, Pattern)	Tambahkan jalur data Niat baru untuk dicocokkan.
AddDataScheme(String)	Tambahkan skema data Niat baru untuk dicocokkan.
AddDataSchemeSpecificPart(String, Pattern)	Tambahkan "bagian spesifik skema" data Niat baru untuk dicocokkan.
AddDataType(String)	Tambahkan jenis data Niat baru untuk dicocokkan.
AddUriRelativeFilterGroup(UriRelativeFilterGroup)	Tambahkan grup filter relatif URI baru untuk dicocokkan dengan data Niat.
AsPredicate()	`Predicate` Mengembalikan pengujian mana yang menguji apakah filter ini cocok dengan niat</var>< yang diberikan>.
AsPredicateWithTypeResolution(ContentResolver)	`Predicate` Mengembalikan pengujian mana yang menguji apakah filter ini cocok dengan niat</var>< yang diberikan>.
AuthoritiesIterator()	Mengembalikan iterator melalui otoritas data filter.
CategoriesIterator()	Mengembalikan iterator di atas kategori filter.
ClearUriRelativeFilterGroups()	Menghapus semua grup filter relatif URI yang ada di filter niat.
Clone()	Membuat dan mengembalikan salinan objek ini. (Diperoleh dari Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	Deskripsi terstruktur tentang nilai Niat yang akan dicocokkan. (Diperoleh dari JavaObject)
CountActions()	Mengembalikan jumlah tindakan dalam filter.
CountCategories()	Mengembalikan jumlah kategori dalam filter.
CountDataAuthorities()	Mengembalikan jumlah otoritas data dalam filter.
CountDataPaths()	Mengembalikan jumlah jalur data dalam filter.
CountDataSchemes()	Mengembalikan jumlah skema data dalam filter.
CountDataSchemeSpecificParts()	Mengembalikan jumlah bagian tertentu skema data dalam filter.
CountDataTypes()	Mengembalikan jumlah jenis data dalam filter.
CountUriRelativeFilterGroups()	Mengembalikan jumlah grup filter relatif URI di filter niat.
Create(String, String)	Buat instans IntentFilter baru dengan tindakan tertentu dan jenis MIME, di mana Anda tahu jenis MIME diformat dengan benar.
DescribeContents()	Jelaskan jenis objek khusus yang terkandung dalam representasi marshalable Parcelable ini.
Dispose()	Merilis sumber daya yang dipegang oleh rekan Java ini. (Diperoleh dari Object)
Dispose(Boolean)	Merilis sumber daya yang dipegang oleh rekan Java ini. (Diperoleh dari Object)
DisposeUnlessReferenced()	Deskripsi terstruktur tentang nilai Niat yang akan dicocokkan. (Diperoleh dari JavaObject)
Dump(IPrinter, String)
Equals(Object)	Deskripsi terstruktur tentang nilai Niat yang akan dicocokkan. (Diperoleh dari JavaObject)
Equals(Object)	Menunjukkan apakah beberapa objek lain "sama dengan" yang satu ini. (Diperoleh dari Object)
GetAction(Int32)	Mengembalikan tindakan dalam filter.
GetCategory(Int32)	Mengembalikan kategori dalam filter.
GetDataAuthority(Int32)	Mengembalikan otoritas data dalam filter.
GetDataPath(Int32)	Mengembalikan jalur data dalam filter.
GetDataScheme(Int32)	Mengembalikan skema data dalam filter.
GetDataSchemeSpecificPart(Int32)	Mengembalikan bagian spesifik skema data dalam filter.
GetDataType(Int32)	Mengembalikan jenis data dalam filter.
GetHashCode()	Mengembalikan nilai kode hash untuk objek . (Diperoleh dari Object)
GetUriRelativeFilterGroup(Int32)	Mengembalikan grup filter relatif URI di filter niat.
HasAction(String)	Apakah tindakan yang diberikan disertakan dalam filter? Perhatikan bahwa jika filter tidak menyertakan tindakan apa pun, salah akan <selalu></em> akan dikembalikan.
HasCategory(String)	Apakah kategori yang diberikan disertakan dalam filter?
HasDataAuthority(Uri)	Apakah otoritas data yang diberikan disertakan dalam filter? Perhatikan bahwa jika filter tidak menyertakan otoritas apa pun, salah akan <selalu></em> akan dikembalikan.
HasDataPath(String)	Apakah jalur data yang diberikan disertakan dalam filter? Perhatikan bahwa jika filter tidak menyertakan jalur apa pun, salah akan <selalu></em> akan dikembalikan.
HasDataScheme(String)	Apakah skema data yang diberikan disertakan dalam filter? Perhatikan bahwa jika filter tidak menyertakan skema apa pun, salah akan <>selalu</em> akan dikembalikan.
HasDataSchemeSpecificPart(String)	Apakah bagian spesifik skema data yang diberikan disertakan dalam filter? Perhatikan bahwa jika filter tidak menyertakan bagian tertentu skema apa pun, salah akan <>selalu</em> akan dikembalikan.
HasDataType(String)	Apakah jenis data yang diberikan disertakan dalam filter? Perhatikan bahwa jika filter tidak menyertakan jenis apa pun, salah akan <selalu></em> akan dikembalikan.
JavaFinalize()	Dipanggil oleh pengumpul sampah pada objek ketika pengumpulan sampah menentukan bahwa tidak ada lagi referensi ke objek. (Diperoleh dari Object)
Match(ContentResolver, Intent, Boolean, String)	Uji apakah filter ini cocok dengan niat</var var>< yang diberikan>.
Match(String, String, String, Uri, ICollection<String>, String)	Uji apakah filter ini cocok dengan data niat yang diberikan.
MatchAction(String)	Cocokkan filter ini dengan tindakan Niat.
MatchCategories(ICollection<String>)	Cocokkan filter ini dengan kategori Niat.
MatchData(String, String, Uri)	Cocokkan filter ini dengan data Niat (jenis, skema, dan jalur).
MatchDataAuthority(Uri)	Cocokkan filter niat ini dengan data Niat yang diberikan.
Notify()	Membangunkan satu utas yang menunggu monitor objek ini. (Diperoleh dari Object)
NotifyAll()	Membangunkan semua utas yang menunggu monitor objek ini. (Diperoleh dari Object)
PathsIterator()	Mengembalikan iterator di atas jalur data filter.
ReadFromXml(XmlReader)
SchemesIterator()	Mengembalikan iterator melalui skema data filter.
SchemeSpecificPartsIterator()	Mengembalikan iterator di atas bagian tertentu skema data filter.
SetHandle(IntPtr, JniHandleOwnership)	Mengatur properti Handle. (Diperoleh dari Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Deskripsi terstruktur tentang nilai Niat yang akan dicocokkan. (Diperoleh dari JavaObject)
ToArray<T>()	Membuat array terkelola dari pembungkus array Java ini. (Diperoleh dari Object)
ToString()	Mengembalikan representasi string objek. (Diperoleh dari Object)
TypesIterator()	Mengembalikan iterator di atas jenis data filter.
UnregisterFromRuntime()	Membatalkan pendaftaran peer Java ini dari runtime interop. (Diperoleh dari Object)
Wait()	Menyebabkan utas saat ini menunggu sampai terbangun, biasanya dengan <diberitahu></em> atau <em>terganggu</em>. (Diperoleh dari Object)
Wait(Int64, Int32)	Menyebabkan utas saat ini menunggu sampai terbangun, biasanya dengan <>diberitahu</em> atau <em>terganggu</em>, atau sampai sejumlah waktu nyata berlalu. (Diperoleh dari Object)
Wait(Int64)	Menyebabkan utas saat ini menunggu sampai terbangun, biasanya dengan <>diberitahu</em> atau <em>terganggu</em>, atau sampai sejumlah waktu nyata berlalu. (Diperoleh dari Object)
WriteToParcel(Parcel, ParcelableWriteFlags)	Ratakan objek ini ke Parcel.
WriteToXml(IXmlSerializer)	Tulis konten IntentFilter sebagai aliran XML.

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
IJavaPeerable.Disposed()	Deskripsi terstruktur tentang nilai Niat yang akan dicocokkan. (Diperoleh dari JavaObject)
IJavaPeerable.Finalized()	Deskripsi terstruktur tentang nilai Niat yang akan dicocokkan. (Diperoleh dari JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Deskripsi terstruktur tentang nilai Niat yang akan dicocokkan. (Diperoleh dari JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Deskripsi terstruktur tentang nilai Niat yang akan dicocokkan. (Diperoleh dari JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Deskripsi terstruktur tentang nilai Niat yang akan dicocokkan. (Diperoleh dari JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Deskripsi terstruktur tentang nilai Niat yang akan dicocokkan. (Diperoleh dari JavaObject)
IJavaPeerable.UnregisterFromRuntime()	Deskripsi terstruktur tentang nilai Niat yang akan dicocokkan.

Metode Ekstensi

Nama	Deskripsi
GetJniTypeName(IJavaPeerable)	Mendapatkan nama JNI dari jenis instans `self`.
JavaAs<TResult>(IJavaPeerable)	Cobalah untuk memaksa `self` untuk mengetik `TResult`, memeriksa bahwa paksaan valid di sisi Java.
JavaCast<TResult>(IJavaObject)	Melakukan konversi jenis yang diperiksa runtime Android.
JavaCast<TResult>(IJavaObject)	Deskripsi terstruktur tentang nilai Niat yang akan dicocokkan.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Cobalah untuk memaksa `self` untuk mengetik `TResult`, memeriksa bahwa paksaan valid di sisi Java.

Berlaku untuk