DeviceInformation.CreateWatcher Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| CreateWatcher() |
Erstellt einen DeviceWatcher für alle Geräte. |
| CreateWatcher(String) |
Erstellt einen DeviceWatcher für Geräte, die der angegebenen AQS-Zeichenfolge (Advanced Query Syntax) entsprechen. |
| CreateWatcher(DeviceClass) |
Erstellt einen DeviceWatcher für Geräte, die der angegebenen DeviceClass entsprechen. |
| CreateWatcher(String, IIterable<String>) |
Erstellt einen DeviceWatcher für Geräte, die der angegebenen AQS-Zeichenfolge (Advanced Query Syntax) und der angegebenen Auflistung von Eigenschaften entsprechen. |
| CreateWatcher(String, IIterable<String>, DeviceInformationKind) |
Erstellt einen DeviceWatcher für Geräte, die der angegebenen AQS-Zeichenfolge (Advanced Query Syntax), der angegebenen Auflistung von Eigenschaften und der Art der Geräte entsprechen. |
| CreateWatcher(String, IIterable<String>, DeviceInformationKind, IDeviceEnumerationSettings) |
CreateWatcher()
Erstellt einen DeviceWatcher für alle Geräte.
public:
static DeviceWatcher ^ CreateWatcher();/// [Windows.Foundation.Metadata.Overload("CreateWatcher")]
static DeviceWatcher CreateWatcher();[Windows.Foundation.Metadata.Overload("CreateWatcher")]
public static DeviceWatcher CreateWatcher();function createWatcher()Public Shared Function CreateWatcher () As DeviceWatcherGibt zurück
Der erstellte DeviceWatcher.
- Attribute
Hinweise
DeviceWatcher führt zuerst eine anfängliche Enumeration von Geräten aus, ruft ein Added-Ereignis für jedes Gerät aus, das er findet, und ruft ein EnumerationCompleted-Ereignis aus, wenn die anfängliche Enumeration abgeschlossen ist. Nachdem die anfängliche Enumeration abgeschlossen ist, löst sie Ereignisse aus, wenn ein Gerät hinzugefügt, gelöscht oder aktualisiert wird.
Ein Beispiel finden Sie in der DeviceWatcher-Klasse .
Hinweis
Eine App muss alle hinzugefügten, entfernten und aktualisierten Ereignisse abonnieren, um benachrichtigt zu werden, wenn Gerätezugänge, Entfernungen oder Updates vorhanden sind. Wenn eine App nur das hinzugefügte Ereignis verarbeitet, erhält sie kein Update, wenn ein Gerät dem System hinzugefügt wird, nachdem die anfängliche Geräteaufzählung abgeschlossen ist.
Weitere Informationen
Gilt für:
CreateWatcher(String)
Erstellt einen DeviceWatcher für Geräte, die der angegebenen AQS-Zeichenfolge (Advanced Query Syntax) entsprechen.
public:
static DeviceWatcher ^ CreateWatcher(Platform::String ^ aqsFilter);/// [Windows.Foundation.Metadata.Overload("CreateWatcherAqsFilter")]
static DeviceWatcher CreateWatcher(winrt::hstring const& aqsFilter);[Windows.Foundation.Metadata.Overload("CreateWatcherAqsFilter")]
public static DeviceWatcher CreateWatcher(string aqsFilter);function createWatcher(aqsFilter)Public Shared Function CreateWatcher (aqsFilter As String) As DeviceWatcherParameter
- aqsFilter
-
String
Platform::String
winrt::hstring
Eine AQS-Zeichenfolge, die die DeviceInformation-Objekte filtert, um sie aufzulisten. In der Regel wird diese Zeichenfolge von der GetDeviceSelector-Methode einer Klasse abgerufen, die mit Geräten interagiert. Beispielsweise ruft GetDeviceSelector die Zeichenfolge für die StorageDevice-Klasse ab.
Gibt zurück
Der erstellte DeviceWatcher.
- Attribute
Hinweise
Hinweis
Diese Überladung ist in JavaScript nicht verfügbar. Um einen DeviceWatcher aus einer AQS-Zeichenfolge in JavaScript zu erstellen, verwenden Sie die CreateWatcher(String, IIterable_1) -Überladung, und übergeben Sie null als zweiter Parameter.
DeviceWatcher führt zuerst eine anfängliche Enumeration von Geräten aus, ruft ein Added-Ereignis für jedes Gerät aus, das er findet, und ruft ein EnumerationCompleted-Ereignis aus, wenn die anfängliche Enumeration abgeschlossen ist. Nachdem die anfängliche Enumeration abgeschlossen ist, löst sie Ereignisse aus, wenn ein Gerät hinzugefügt, gelöscht oder aktualisiert wird.
Hinweis
Eine App muss alle hinzugefügten, entfernten und aktualisierten Ereignisse abonnieren, um benachrichtigt zu werden, wenn Gerätezugänge, Entfernungen oder Updates vorhanden sind. Wenn eine App nur das hinzugefügte Ereignis verarbeitet, erhält sie kein Update, wenn ein Gerät dem System hinzugefügt wird, nachdem die anfängliche Geräteaufzählung abgeschlossen ist.
Ein Beispiel finden Sie in der DeviceWatcher-Klasse .
Weitere Informationen
Gilt für:
CreateWatcher(DeviceClass)
Erstellt einen DeviceWatcher für Geräte, die der angegebenen DeviceClass entsprechen.
public:
static DeviceWatcher ^ CreateWatcher(DeviceClass deviceClass);/// [Windows.Foundation.Metadata.DefaultOverload]
/// [Windows.Foundation.Metadata.Overload("CreateWatcherDeviceClass")]
static DeviceWatcher CreateWatcher(DeviceClass const& deviceClass);[Windows.Foundation.Metadata.DefaultOverload]
[Windows.Foundation.Metadata.Overload("CreateWatcherDeviceClass")]
public static DeviceWatcher CreateWatcher(DeviceClass deviceClass);function createWatcher(deviceClass)Public Shared Function CreateWatcher (deviceClass As DeviceClass) As DeviceWatcherParameter
- deviceClass
- DeviceClass
Die Klasse des Geräts, das mithilfe von DeviceWatcher aufgelistet werden soll.
Gibt zurück
Der erstellte DeviceWatcher.
- Attribute
Hinweise
DeviceWatcher führt zuerst eine anfängliche Enumeration von Geräten aus, ruft ein Added-Ereignis für jedes Gerät aus, das er findet, und ruft ein EnumerationCompleted-Ereignis aus, wenn die anfängliche Enumeration abgeschlossen ist. Nachdem die anfängliche Enumeration abgeschlossen ist, löst sie Ereignisse aus, wenn ein Gerät hinzugefügt, gelöscht oder aktualisiert wird.
Hinweis
Eine App muss alle hinzugefügten, entfernten und aktualisierten Ereignisse abonnieren, um benachrichtigt zu werden, wenn Gerätezugänge, Entfernungen oder Updates vorhanden sind. Wenn eine App nur das hinzugefügte Ereignis verarbeitet, erhält sie kein Update, wenn ein Gerät dem System hinzugefügt wird, nachdem die anfängliche Geräteaufzählung abgeschlossen ist.
Ein Beispiel finden Sie in der DeviceWatcher-Klasse .
Weitere Informationen
Gilt für:
CreateWatcher(String, IIterable<String>)
Erstellt einen DeviceWatcher für Geräte, die der angegebenen AQS-Zeichenfolge (Advanced Query Syntax) und der angegebenen Auflistung von Eigenschaften entsprechen.
public:
static DeviceWatcher ^ CreateWatcher(Platform::String ^ aqsFilter, IIterable<Platform::String ^> ^ additionalProperties);/// [Windows.Foundation.Metadata.Overload("CreateWatcherAqsFilterAndAdditionalProperties")]
static DeviceWatcher CreateWatcher(winrt::hstring const& aqsFilter, IIterable<winrt::hstring> const& additionalProperties);[Windows.Foundation.Metadata.Overload("CreateWatcherAqsFilterAndAdditionalProperties")]
public static DeviceWatcher CreateWatcher(string aqsFilter, IEnumerable<string> additionalProperties);function createWatcher(aqsFilter, additionalProperties)Public Shared Function CreateWatcher (aqsFilter As String, additionalProperties As IEnumerable(Of String)) As DeviceWatcherParameter
- aqsFilter
-
String
Platform::String
winrt::hstring
Eine AQS-Zeichenfolge, die die DeviceInformation-Objekte filtert, um sie aufzulisten. In der Regel wird diese Zeichenfolge von der GetDeviceSelector-Methode einer Klasse abgerufen, die mit Geräten interagiert. Beispielsweise ruft GetDeviceSelector die Zeichenfolge für die StorageDevice-Klasse ab.
Eine iterierbare Liste zusätzlicher Eigenschaften, die in die Properties-Eigenschaft der DeviceInformation-Objekte in die Enumerationsergebnisse aufgenommen werden sollen. Weitere Informationen dazu, was die Eigenschaften darstellen, finden Sie unter Geräteinformationseigenschaften.
Gibt zurück
Der erstellte DeviceWatcher.
- Attribute
Hinweise
DeviceWatcher führt zuerst eine anfängliche Enumeration von Geräten aus, ruft ein Added-Ereignis für jedes Gerät aus, das er findet, und ruft ein EnumerationCompleted-Ereignis aus, wenn die anfängliche Enumeration abgeschlossen ist. Nachdem die anfängliche Enumeration abgeschlossen ist, löst sie Ereignisse aus, wenn ein Gerät hinzugefügt, gelöscht oder aktualisiert wird.
Hinweis
Eine App muss alle hinzugefügten, entfernten und aktualisierten Ereignisse abonnieren, um benachrichtigt zu werden, wenn Gerätezugänge, Entfernungen oder Updates vorhanden sind. Wenn eine App nur das hinzugefügte Ereignis verarbeitet, erhält sie kein Update, wenn ein Gerät dem System hinzugefügt wird, nachdem die anfängliche Geräteaufzählung abgeschlossen ist.
Ein Beispiel finden Sie in der DeviceWatcher-Klasse .
Weitere Informationen
Gilt für:
CreateWatcher(String, IIterable<String>, DeviceInformationKind)
Erstellt einen DeviceWatcher für Geräte, die der angegebenen AQS-Zeichenfolge (Advanced Query Syntax), der angegebenen Auflistung von Eigenschaften und der Art der Geräte entsprechen.
public:
static DeviceWatcher ^ CreateWatcher(Platform::String ^ aqsFilter, IIterable<Platform::String ^> ^ additionalProperties, DeviceInformationKind kind);/// [Windows.Foundation.Metadata.Overload("CreateWatcherWithKindAqsFilterAndAdditionalProperties")]
static DeviceWatcher CreateWatcher(winrt::hstring const& aqsFilter, IIterable<winrt::hstring> const& additionalProperties, DeviceInformationKind const& kind);[Windows.Foundation.Metadata.Overload("CreateWatcherWithKindAqsFilterAndAdditionalProperties")]
public static DeviceWatcher CreateWatcher(string aqsFilter, IEnumerable<string> additionalProperties, DeviceInformationKind kind);function createWatcher(aqsFilter, additionalProperties, kind)Public Shared Function CreateWatcher (aqsFilter As String, additionalProperties As IEnumerable(Of String), kind As DeviceInformationKind) As DeviceWatcherParameter
- aqsFilter
-
String
Platform::String
winrt::hstring
Eine AQS-Zeichenfolge, die die DeviceInformation-Objekte filtert, um sie aufzulisten. In der Regel wird diese Zeichenfolge von der GetDeviceSelector-Methode einer Klasse abgerufen, die mit Geräten interagiert. Beispielsweise ruft GetDeviceSelector die Zeichenfolge für die StorageDevice-Klasse ab.
Eine iterierbare Liste zusätzlicher Eigenschaften, die in die Properties-Eigenschaft der DeviceInformation-Objekte in die Enumerationsergebnisse aufgenommen werden sollen. Weitere Informationen dazu, was die Eigenschaften darstellen, finden Sie unter Geräteinformationseigenschaften.
Die spezifischen Gerätetypen, für die DeviceWatcher interessiert ist.
Gibt zurück
Der erstellte DeviceWatcher.
- Attribute
Weitere Informationen
- CreateWatcher()
- CreateWatcher(DeviceClass)
- CreateWatcher(String)
- CreateWatcher(String, IIterable<String>)
Gilt für:
CreateWatcher(String, IIterable<String>, DeviceInformationKind, IDeviceEnumerationSettings)
public:
static DeviceWatcher ^ CreateWatcher(Platform::String ^ aqsFilter, IIterable<Platform::String ^> ^ additionalProperties, DeviceInformationKind kind, IDeviceEnumerationSettings ^ settings);/// [Windows.Foundation.Metadata.Overload("CreateWatcherWithAqsFilterAdditionalPropertiesKindAndSettings")]
static DeviceWatcher CreateWatcher(winrt::hstring const& aqsFilter, IIterable<winrt::hstring> const& additionalProperties, DeviceInformationKind const& kind, IDeviceEnumerationSettings const& settings);[Windows.Foundation.Metadata.Overload("CreateWatcherWithAqsFilterAdditionalPropertiesKindAndSettings")]
public static DeviceWatcher CreateWatcher(string aqsFilter, IEnumerable<string> additionalProperties, DeviceInformationKind kind, IDeviceEnumerationSettings settings);function createWatcher(aqsFilter, additionalProperties, kind, settings)Public Shared Function CreateWatcher (aqsFilter As String, additionalProperties As IEnumerable(Of String), kind As DeviceInformationKind, settings As IDeviceEnumerationSettings) As DeviceWatcherParameter
- aqsFilter
-
String
Platform::String
winrt::hstring
- settings
- IDeviceEnumerationSettings
Gibt zurück
- Attribute
Gilt für:
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für