DeviceWatcher Kelas

  • Referensi

Definisi

Ruang nama:
Windows.Devices.Enumeration
Edit

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 .

diagram status status DeviceWatcher

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.

Berlaku untuk

Lihat juga