DeviceInformation.CreateWatcher Método

Definición

Espacio de nombres:

Windows.Devices.Enumeration

Sobrecargas

CreateWatcher()	Crea un DeviceWatcher para todos los dispositivos.
CreateWatcher(String)	Crea un DeviceWatcher para dispositivos que coinciden con la cadena de sintaxis de consulta avanzada (AQS) especificada.
CreateWatcher(DeviceClass)	Crea un DeviceWatcher para dispositivos que coincidan con la clase DeviceClass especificada.
CreateWatcher(String, IIterable<String>)	Crea un DeviceWatcher para dispositivos que coinciden con la cadena de sintaxis de consulta avanzada (AQS) especificada y la colección de propiedades especificada.
CreateWatcher(String, IIterable<String>, DeviceInformationKind)	Crea un DeviceWatcher para dispositivos que coinciden con la cadena de sintaxis avanzada de consulta (AQS) especificada, la colección de propiedades especificada y el tipo de dispositivos.

CreateWatcher()

Crea un DeviceWatcher para todos los dispositivos.

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

Devoluciones

DeviceWatcher

DeviceWatcher creado.

Atributos

OverloadAttribute

Comentarios

El DeviceWatcher realiza primero una enumeración inicial de dispositivos, genera un evento Added para cada dispositivo que encuentra y genera un evento EnumerationCompleted cuando se completa la enumeración inicial. Una vez completada la enumeración inicial, genera eventos cuando se agrega, elimina o actualiza un dispositivo.

Consulta la clase DeviceWatcher para obtener un ejemplo.

Nota

Una aplicación debe suscribirse a todos los eventos agregados, quitados y actualizados para recibir notificaciones cuando haya adiciones, eliminaciones o actualizaciones de dispositivos. Si una aplicación controla solo el evento agregado , no recibirá una actualización si se agrega un dispositivo al sistema una vez completada la enumeración inicial del dispositivo.

Consulte también

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

CreateWatcher(String)

Crea un DeviceWatcher para dispositivos que coinciden con la cadena de sintaxis de consulta avanzada (AQS) especificada.

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

Parámetros

aqsFilter

String

Platform::String

winrt::hstring

Cadena de AQS que filtra los objetos DeviceInformation que se van a enumerar. Normalmente, esta cadena se recupera del método GetDeviceSelector de una clase que interactúa con los dispositivos. Por ejemplo, GetDeviceSelector recupera la cadena de la clase StorageDevice .

Devoluciones

DeviceWatcher

DeviceWatcher creado.

Atributos

OverloadAttribute

Comentarios

Nota

Esta sobrecarga no está disponible en JavaScript. Para crear un DeviceWatcher a partir de una cadena de AQS en JavaScript, use la sobrecarga CreateWatcher(String, IIterable_1) y pase null como segundo parámetro.

El DeviceWatcher realiza primero una enumeración inicial de dispositivos, genera un evento Added para cada dispositivo que encuentra y genera un evento EnumerationCompleted cuando se completa la enumeración inicial. Una vez completada la enumeración inicial, genera eventos cuando se agrega, elimina o actualiza un dispositivo.

Nota

Una aplicación debe suscribirse a todos los eventos agregados, quitados y actualizados para recibir notificaciones cuando haya adiciones, eliminaciones o actualizaciones de dispositivos. Si una aplicación controla solo el evento agregado , no recibirá una actualización si se agrega un dispositivo al sistema una vez completada la enumeración inicial del dispositivo.

Consulta la clase DeviceWatcher para obtener un ejemplo.

Consulte también

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

CreateWatcher(DeviceClass)

Crea un DeviceWatcher para dispositivos que coincidan con la clase DeviceClass especificada.

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

Parámetros

deviceClass

DeviceClass

Clase de dispositivo que se va a enumerar mediante DeviceWatcher.

Devoluciones

DeviceWatcher

DeviceWatcher creado.

Atributos

DefaultOverloadAttribute OverloadAttribute

Comentarios

El DeviceWatcher realiza primero una enumeración inicial de dispositivos, genera un evento Added para cada dispositivo que encuentra y genera un evento EnumerationCompleted cuando se completa la enumeración inicial. Una vez completada la enumeración inicial, genera eventos cuando se agrega, elimina o actualiza un dispositivo.

Nota

Una aplicación debe suscribirse a todos los eventos agregados, quitados y actualizados para recibir notificaciones cuando haya adiciones, eliminaciones o actualizaciones de dispositivos. Si una aplicación controla solo el evento agregado , no recibirá una actualización si se agrega un dispositivo al sistema una vez completada la enumeración inicial del dispositivo.

Consulta la clase DeviceWatcher para obtener un ejemplo.

Consulte también

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

CreateWatcher(String, IIterable<String>)

Crea un DeviceWatcher para dispositivos que coinciden con la cadena de sintaxis de consulta avanzada (AQS) especificada y la colección de propiedades especificada.

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

Parámetros

aqsFilter

String

Platform::String

winrt::hstring

Cadena de AQS que filtra los objetos DeviceInformation que se van a enumerar. Normalmente, esta cadena se recupera del método GetDeviceSelector de una clase que interactúa con los dispositivos. Por ejemplo, GetDeviceSelector recupera la cadena de la clase StorageDevice .

additionalProperties

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Lista iterable de propiedades adicionales que se van a incluir en la propiedad Properties de los objetos DeviceInformation en los resultados de la enumeración. Para obtener más información sobre lo que representan las propiedades, consulta Propiedades de información del dispositivo.

Devoluciones

DeviceWatcher

DeviceWatcher creado.

Atributos

OverloadAttribute

Comentarios

El DeviceWatcher realiza primero una enumeración inicial de dispositivos, genera un evento Added para cada dispositivo que encuentra y genera un evento EnumerationCompleted cuando se completa la enumeración inicial. Una vez completada la enumeración inicial, genera eventos cuando se agrega, elimina o actualiza un dispositivo.

Nota

Una aplicación debe suscribirse a todos los eventos agregados, quitados y actualizados para recibir notificaciones cuando haya adiciones, eliminaciones o actualizaciones de dispositivos. Si una aplicación controla solo el evento agregado , no recibirá una actualización si se agrega un dispositivo al sistema una vez completada la enumeración inicial del dispositivo.

Consulta la clase DeviceWatcher para obtener un ejemplo.

Consulte también

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

CreateWatcher(String, IIterable<String>, DeviceInformationKind)

Crea un DeviceWatcher para dispositivos que coinciden con la cadena de sintaxis avanzada de consulta (AQS) especificada, la colección de propiedades especificada y el tipo de dispositivos.

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

Parámetros

aqsFilter

String

Platform::String

winrt::hstring

Cadena de AQS que filtra los objetos DeviceInformation que se van a enumerar. Normalmente, esta cadena se recupera del método GetDeviceSelector de una clase que interactúa con los dispositivos. Por ejemplo, GetDeviceSelector recupera la cadena de la clase StorageDevice .

additionalProperties

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Lista iterable de propiedades adicionales que se van a incluir en la propiedad Properties de los objetos DeviceInformation en los resultados de la enumeración. Para obtener más información sobre lo que representan las propiedades, consulta Propiedades de información del dispositivo.

kind

DeviceInformationKind

Los tipos específicos de dispositivos en los que deviceWatcher está interesado.

Devoluciones

DeviceWatcher

DeviceWatcher creado.

Atributos

OverloadAttribute

Consulte también

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