DeviceInformation.CreateWatcher Methode

Definition

Namespace:

Windows.Devices.Enumeration

Ü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()

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 DeviceWatcher

Gibt zurück

DeviceWatcher

Der erstellte DeviceWatcher.

Attribute

OverloadAttribute

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

• CreateWatcher(DeviceClass)
• CreateWatcher(String)
• CreateWatcher(String, IIterable<String>)

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 DeviceWatcher

Parameter

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

DeviceWatcher

Der erstellte DeviceWatcher.

Attribute

OverloadAttribute

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

• CreateWatcher()
• CreateWatcher(DeviceClass)
• CreateWatcher(String, IIterable<String>)

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 DeviceWatcher

Parameter

deviceClass

DeviceClass

Die Klasse des Geräts, das mithilfe von DeviceWatcher aufgelistet werden soll.

Gibt zurück

DeviceWatcher

Der erstellte DeviceWatcher.

Attribute

DefaultOverloadAttribute OverloadAttribute

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

• CreateWatcher()
• CreateWatcher(String)
• CreateWatcher(String, IIterable<String>)

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 DeviceWatcher

Parameter

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.

additionalProperties

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

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

DeviceWatcher

Der erstellte DeviceWatcher.

Attribute

OverloadAttribute

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

• CreateWatcher()
• CreateWatcher(DeviceClass)
• CreateWatcher(String)

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 DeviceWatcher

Parameter

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.

additionalProperties

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

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.

kind

DeviceInformationKind

Die spezifischen Gerätetypen, für die DeviceWatcher interessiert ist.

Gibt zurück

DeviceWatcher

Der erstellte DeviceWatcher.

Attribute

OverloadAttribute

Weitere Informationen

• CreateWatcher()
• CreateWatcher(DeviceClass)
• CreateWatcher(String)
• CreateWatcher(String, IIterable<String>)