ContextWrapper.RegisterReceiver Metode

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.

Overload

Nama	Deskripsi
RegisterReceiver(BroadcastReceiver, IntentFilter, String, Handler, ActivityFlags)	Kedaluwarsa. Daftar untuk menerima siaran niat, untuk dijalankan dalam konteks penjadwal . Lihat registerReceiver(BroadcastReceiver,IntentFilter,int) dan registerReceiver(BroadcastReceiver,IntentFilter,String,Handler) untuk informasi selengkapnya. Lihat BroadcastReceiver untuk informasi selengkapnya tentang Siaran niat. Pada Build.VERSION_CODES. UPSIDE_DOWN_CAKE , sistem dapat menempatkan siaran terdaftar konteks dalam antrean saat aplikasi berada dalam status cache . Ketika aplikasi meninggalkan status cache, seperti kembali ke latar depan, sistem mengirimkan siaran antrean apa pun. Beberapa instans siaran tertentu mungkin digabungkan ke dalam satu siaran. Pada Build.VERSION_CODES. ICE_CREAM_SANDWICH , penerima yang terdaftar dengan metode ini akan dengan benar menghormati Intent.setPackage(String) yang ditentukan untuk Niat yang disiarkan. Sebelum itu, itu akan diabaikan dan dikirimkan ke semua penerima terdaftar yang cocok. Berhati-hatilah jika menggunakan ini untuk keamanan. Parameter penerima BroadcastReceiver : Nilai ini mungkin null .
RegisterReceiver(BroadcastReceiver, IntentFilter, String, Handler)	Daftar untuk menerima siaran niat, untuk dijalankan dalam konteks penjadwal<>/var<var>.
RegisterReceiver(BroadcastReceiver, IntentFilter)	Daftarkan BroadcastReceiver untuk dijalankan di utas aktivitas utama.
RegisterReceiver(BroadcastReceiver, IntentFilter, ActivityFlags)	Kedaluwarsa. Daftar untuk menerima siaran niat, dengan penerima secara opsional diekspos ke Aplikasi Instan. Lihat registerReceiver(BroadcastReceiver,IntentFilter) untuk informasi selengkapnya. Secara default, Aplikasi Instan tidak dapat berinteraksi dengan penerima di aplikasi lain, ini memungkinkan Anda mengekspos penerima yang dapat berinteraksi dengan Aplikasi Instan. Lihat BroadcastReceiver untuk informasi selengkapnya tentang Siaran niat. Pada Build.VERSION_CODES. UPSIDE_DOWN_CAKE , sistem dapat menempatkan siaran terdaftar konteks dalam antrean saat aplikasi berada dalam status cache . Ketika aplikasi meninggalkan status cache, seperti kembali ke latar depan, sistem mengirimkan siaran antrean apa pun. Beberapa instans siaran tertentu mungkin digabungkan ke dalam satu siaran. Pada Build.VERSION_CODES. ICE_CREAM_SANDWICH , penerima yang terdaftar dengan metode ini akan dengan benar menghormati Intent.setPackage(String) yang ditentukan untuk Niat yang disiarkan. Sebelum itu, itu akan diabaikan dan dikirimkan ke semua penerima terdaftar yang cocok. Berhati-hatilah jika menggunakan ini untuk keamanan. Parameter penerima BroadcastReceiver : Nilai ini mungkin null .

RegisterReceiver(BroadcastReceiver, IntentFilter, String, Handler, ActivityFlags)

Perhatian

This method has an incorrect enumeration type. Use the overload that takes ReceiverFlags instead.

Daftar untuk menerima siaran niat, untuk dijalankan dalam konteks penjadwal . Lihat registerReceiver(BroadcastReceiver,IntentFilter,int) dan registerReceiver(BroadcastReceiver,IntentFilter,String,Handler) untuk informasi selengkapnya. Lihat BroadcastReceiver untuk informasi selengkapnya tentang Siaran niat. Pada Build.VERSION_CODES. UPSIDE_DOWN_CAKE , sistem dapat menempatkan siaran terdaftar konteks dalam antrean saat aplikasi berada dalam status cache . Ketika aplikasi meninggalkan status cache, seperti kembali ke latar depan, sistem mengirimkan siaran antrean apa pun. Beberapa instans siaran tertentu mungkin digabungkan ke dalam satu siaran. Pada Build.VERSION_CODES. ICE_CREAM_SANDWICH , penerima yang terdaftar dengan metode ini akan dengan benar menghormati Intent.setPackage(String) yang ditentukan untuk Niat yang disiarkan. Sebelum itu, itu akan diabaikan dan dikirimkan ke semua penerima terdaftar yang cocok. Berhati-hatilah jika menggunakan ini untuk keamanan. Parameter penerima BroadcastReceiver : Nilai ini mungkin null .

[Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;Ljava/lang/String;Landroid/os/Handler;I)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_Ljava_lang_String_Landroid_os_Handler_IHandler", ApiSince=26)]
[System.Obsolete("This method has an incorrect enumeration type. Use the overload that takes ReceiverFlags instead.")]
public override Android.Content.Intent? RegisterReceiver(Android.Content.BroadcastReceiver? receiver, Android.Content.IntentFilter? filter, string? broadcastPermission, Android.OS.Handler? scheduler, Android.Content.ActivityFlags flags);

[<Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;Ljava/lang/String;Landroid/os/Handler;I)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_Ljava_lang_String_Landroid_os_Handler_IHandler", ApiSince=26)>]
[<System.Obsolete("This method has an incorrect enumeration type. Use the overload that takes ReceiverFlags instead.")>]
override this.RegisterReceiver : Android.Content.BroadcastReceiver * Android.Content.IntentFilter * string * Android.OS.Handler * Android.Content.ActivityFlags -> Android.Content.Intent

Parameter

receiver: BroadcastReceiver

Penerima siaran untuk mendaftar.

filter: IntentFilter

Filter niat yang memilih siaran yang akan diterima.

broadcastPermission: String

Nama izin yang harus ditahan penyiar untuk mengirim Niat ke penerima ini. Jika null, tidak diperlukan izin.

scheduler: Handler

Handler tempat panggilan balik penerima berjalan.

flags: ActivityFlags

Bendera yang mengontrol operasi ini.

Mengembalikan

Intent

Niat lengket pertama ditemukan yang cocok dengan filter , atau null jika tidak ada.

Atribut: RegisterAttribute ObsoleteAttribute

Keterangan

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.

Java dokumentasi untuk android.content.ContextWrapper.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter, java.lang.String, android.os.Handler, int).

Berlaku untuk

RegisterReceiver(BroadcastReceiver, IntentFilter, String, Handler)

Daftar untuk menerima siaran niat, untuk dijalankan dalam konteks penjadwal<>/var<var>.

[Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;Ljava/lang/String;Landroid/os/Handler;)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_Ljava_lang_String_Landroid_os_Handler_Handler")]
public override Android.Content.Intent? RegisterReceiver(Android.Content.BroadcastReceiver? receiver, Android.Content.IntentFilter? filter, string? broadcastPermission, Android.OS.Handler? scheduler);

[<Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;Ljava/lang/String;Landroid/os/Handler;)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_Ljava_lang_String_Landroid_os_Handler_Handler")>]
override this.RegisterReceiver : Android.Content.BroadcastReceiver * Android.Content.IntentFilter * string * Android.OS.Handler -> Android.Content.Intent

Parameter

receiver: BroadcastReceiver

BroadcastReceiver untuk menangani siaran.

filter: IntentFilter

Memilih siaran Niat yang akan diterima.

broadcastPermission: String

Nama izin yang harus ditahan penyiar untuk mengirim Niat ke penerima ini. Jika null, tidak diperlukan izin.

scheduler: Handler

Handler yang mengidentifikasi utas yang akan menerima Niat. Jika null, alur utama proses akan digunakan.

Mengembalikan

Intent

Niat lengket pertama ditemukan yang cocok dengan filter , atau null jika tidak ada.

Atribut: RegisterAttribute

Keterangan

Java dokumentasi untuk android.content.ContextWrapper.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter, java.lang.String, android.os.Handler).

Berlaku untuk

RegisterReceiver(BroadcastReceiver, IntentFilter)

Daftarkan BroadcastReceiver untuk dijalankan di utas aktivitas utama.

[Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_Handler")]
public override Android.Content.Intent? RegisterReceiver(Android.Content.BroadcastReceiver? receiver, Android.Content.IntentFilter? filter);

[<Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_Handler")>]
override this.RegisterReceiver : Android.Content.BroadcastReceiver * Android.Content.IntentFilter -> Android.Content.Intent

Parameter

receiver: BroadcastReceiver

BroadcastReceiver untuk menangani siaran.

filter: IntentFilter

Memilih siaran Niat yang akan diterima.

Mengembalikan

Intent

Daftarkan BroadcastReceiver untuk dijalankan di utas aktivitas utama. Penerima akan dipanggil dengan niat siaran apa pun yang cocok dengan filter , di utas aplikasi utama. Sistem dapat menyiarkan Niat yang "lengket" - ini tetap ada setelah siaran selesai, untuk dikirim ke pendaftaran nanti. Jika IntentFilter Anda cocok dengan salah satu Niat lengket ini, Niat tersebut akan dikembalikan oleh fungsi ini dan dikirim ke penerima Anda seolah-olah baru saja disiarkan. Mungkin ada beberapa Niat lengket yang cocok dengan filter , dalam hal ini masing-masing akan dikirim ke penerima . Dalam hal ini, hanya satu dari ini yang dapat dikembalikan langsung oleh fungsi; mana dari ini yang dikembalikan secara sewenang-wenang diputuskan oleh sistem. Jika Anda tahu Niat yang Anda daftarkan lengket, Anda dapat menyediakan null untuk penerima Anda. Dalam hal ini, tidak ada penerima yang terdaftar -- fungsi hanya mengembalikan Niat lengket yang cocok dengan filter . Dalam kasus beberapa kecocokan, aturan yang sama seperti yang dijelaskan di atas berlaku. Lihat BroadcastReceiver untuk informasi selengkapnya tentang Siaran niat. Pada Build.VERSION_CODES. UPSIDE_DOWN_CAKE , sistem dapat menempatkan siaran terdaftar konteks dalam antrean saat aplikasi berada dalam status cache . Ketika aplikasi meninggalkan status cache, seperti kembali ke latar depan, sistem mengirimkan siaran antrean apa pun. Beberapa instans siaran tertentu mungkin digabungkan ke dalam satu siaran. Pada Build.VERSION_CODES. ICE_CREAM_SANDWICH , penerima yang terdaftar dengan metode ini akan dengan benar menghormati Intent.setPackage(String) yang ditentukan untuk Niat yang disiarkan. Sebelum itu, itu akan diabaikan dan dikirimkan ke semua penerima terdaftar yang cocok. Berhati-hatilah jika menggunakan ini untuk keamanan. Untuk aplikasi yang menargetkan Build.VERSION_CODES. UPSIDE_DOWN_CAKE , baik RECEIVER_EXPORTED atau RECEIVER_NOT_EXPORTED harus ditentukan jika penerima tidak terdaftar untuk siaran sistem atau SecurityException akan dilemparkan. Lihat registerReceiver(BroadcastReceiver,IntentFilter,int) untuk mendaftarkan penerima dengan bendera. Catatan: metode ini tidak dapat dipanggil dari komponen BroadcastReceiver; yaitu, dari BroadcastReceiver yang dideklarasikan dalam manifes aplikasi. Namun, tidak apa-apa, untuk memanggil metode ini dari BroadcastReceiver lain yang telah terdaftar pada waktu proses dengan registerReceiver(BroadcastReceiver, IntentFilter) , karena masa pakai BroadcastReceiver terdaftar tersebut terikat dengan objek yang mendaftarkannya. Parameter penerima BroadcastReceiver : Nilai ini mungkin null . filter IntentFilter : Memilih siaran Niat yang akan diterima. Mengembalikan Niat Niat lengket pertama yang ditemukan yang cocok dengan filter , atau null jika tidak ada.

Atribut: RegisterAttribute

Keterangan

Java dokumentasi untuk android.content.ContextWrapper.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter).

Berlaku untuk

RegisterReceiver(BroadcastReceiver, IntentFilter, ActivityFlags)

Perhatian

This method has an incorrect enumeration type. Use the overload that takes ReceiverFlags instead.

Daftar untuk menerima siaran niat, dengan penerima secara opsional diekspos ke Aplikasi Instan. Lihat registerReceiver(BroadcastReceiver,IntentFilter) untuk informasi selengkapnya. Secara default, Aplikasi Instan tidak dapat berinteraksi dengan penerima di aplikasi lain, ini memungkinkan Anda mengekspos penerima yang dapat berinteraksi dengan Aplikasi Instan. Lihat BroadcastReceiver untuk informasi selengkapnya tentang Siaran niat. Pada Build.VERSION_CODES. UPSIDE_DOWN_CAKE , sistem dapat menempatkan siaran terdaftar konteks dalam antrean saat aplikasi berada dalam status cache . Ketika aplikasi meninggalkan status cache, seperti kembali ke latar depan, sistem mengirimkan siaran antrean apa pun. Beberapa instans siaran tertentu mungkin digabungkan ke dalam satu siaran. Pada Build.VERSION_CODES. ICE_CREAM_SANDWICH , penerima yang terdaftar dengan metode ini akan dengan benar menghormati Intent.setPackage(String) yang ditentukan untuk Niat yang disiarkan. Sebelum itu, itu akan diabaikan dan dikirimkan ke semua penerima terdaftar yang cocok. Berhati-hatilah jika menggunakan ini untuk keamanan. Parameter penerima BroadcastReceiver : Nilai ini mungkin null .

[Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;I)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_IHandler", ApiSince=26)]
[System.Obsolete("This method has an incorrect enumeration type. Use the overload that takes ReceiverFlags instead.")]
public override Android.Content.Intent? RegisterReceiver(Android.Content.BroadcastReceiver? receiver, Android.Content.IntentFilter? filter, Android.Content.ActivityFlags flags);

[<Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;I)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_IHandler", ApiSince=26)>]
[<System.Obsolete("This method has an incorrect enumeration type. Use the overload that takes ReceiverFlags instead.")>]
override this.RegisterReceiver : Android.Content.BroadcastReceiver * Android.Content.IntentFilter * Android.Content.ActivityFlags -> Android.Content.Intent

Parameter

receiver: BroadcastReceiver

Penerima siaran untuk mendaftar.

filter: IntentFilter

Filter niat yang memilih siaran yang akan diterima.

flags: ActivityFlags

Bendera yang mengontrol operasi ini.

Mengembalikan

Intent

Niat lengket pertama ditemukan yang cocok dengan filter , atau null jika tidak ada.

Atribut: RegisterAttribute ObsoleteAttribute

Keterangan

Java dokumentasi untuk android.content.ContextWrapper.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter, int).

Berlaku untuk