DeviceWatcher Kelas

Definisi

Ruang nama:

Windows.Devices.Enumeration

Menghitung perangkat secara dinamis, sehingga aplikasi menerima pemberitahuan jika perangkat ditambahkan, dihapus, atau diubah setelah enumerasi awal selesai.

public ref class DeviceWatcher sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DeviceWatcher final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DeviceWatcher

Public NotInheritable Class DeviceWatcher

Warisan

Object Platform::Object IInspectable DeviceWatcher

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

Untuk contoh lengkap dalam C# dan C++, lihat Sampel enumerasi dan pemasangan perangkat.

Keterangan

Aplikasi memanggil Mulai untuk memulai pencarian perangkat. Selama enumerasi awal ini, DeviceWatcher menaikkan Peristiwa tambahan untuk setiap perangkat yang ditemukan, hingga semua perangkat ditemukan. DeviceWatcher menaikkan peristiwa EnumerationCompleted saat enumerasi awal selesai, dan terus menaikkan peristiwa jika perangkat ditambahkan, diperbarui, atau dihapus.

Diagram berikut menunjukkan bagaimana Transisi DeviceWatcher antara status yang diwakili oleh enumerasi DeviceWatcherStatus .

Metode Mulai hanya dapat dipanggil ketika DeviceWatcher berada dalam status Dibuat, Dihentikan , atau Dibatalkan . Properti Status menunjukkan status DeviceWatcher. Saat memulai kembali pengamat, tunggu peristiwa Dihentikan sebelum memanggil Mulai.

Menghentikan transisi DeviceWatcher ke status Berhenti dan segera selesai. Pengamat akan beralih ke status Dihentikan setelah semua peristiwa yang sudah dalam proses dinaikkan telah selesai.

Aplikasi mungkin menunggu peristiwa Dihentikan jika perlu mengetahui kapan DeviceWatcher telah berhenti. Penelepon harus menunggu peristiwa Dihentikan sebelum mereka dapat memanggil Mulai untuk memulai ulang pengamat. Penelepon mungkin berhenti berlangganan dari peristiwa jika mereka tidak ingin menerima peristiwa tambahan setelah Berhenti tetapi tidak ingin menunggu peristiwa Dihentikan .

Catatan

Aplikasi harus berlangganan semua peristiwa yang ditambahkan, dihapus, dan diperbarui untuk diberi tahu saat ada penambahan, penghapusan, atau pembaruan perangkat. Jika aplikasi hanya menangani peristiwa yang ditambahkan , aplikasi tidak akan menerima pembaruan jika perangkat ditambahkan ke sistem setelah enumerasi perangkat awal selesai.

Properti

Status

Status DeviceWatcher.

Metode

GetBackgroundTrigger(IIterable<DeviceWatcherEventKind>)	Mendapatkan pemantauan objek DeviceWatcherTrigger untuk perubahan pada daftar perangkat.
Start()	Memulai pencarian perangkat, dan berlangganan peristiwa enumerasi perangkat.
Stop()	Berhenti menaikkan peristiwa yang menambahkan, memperbarui, dan menghapus hasil enumerasi.

Acara

Added	Peristiwa yang dinaikkan saat perangkat ditambahkan ke koleksi yang dijumlahkan oleh DeviceWatcher.
EnumerationCompleted	Peristiwa yang dimunculkan saat enumerasi perangkat selesai.
Removed	Peristiwa yang dinaikkan saat perangkat dihapus dari kumpulan perangkat yang dijumlahkan.
Stopped	Peristiwa yang dimunculkan ketika operasi enumerasi telah dihentikan.
Updated	Peristiwa yang dinaikkan saat perangkat diperbarui dalam kumpulan perangkat yang dijumlahkan.

Lihat juga

• Sampel enumerasi dan pemasangan perangkat