DeviceInformation.CreateWatcher Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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(String, IIterable<String>, DeviceInformationKind, IDeviceEnumerationSettings) |
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 DeviceWatcherDevoluciones
DeviceWatcher creado.
- Atributos
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
Se aplica a
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 DeviceWatcherPará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 creado.
- Atributos
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
Se aplica a
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 DeviceWatcherParámetros
- deviceClass
- DeviceClass
Clase de dispositivo que se va a enumerar mediante DeviceWatcher.
Devoluciones
DeviceWatcher creado.
- Atributos
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
Se aplica a
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 DeviceWatcherPará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 .
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 creado.
- Atributos
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
Se aplica a
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 DeviceWatcherPará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 .
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.
Los tipos específicos de dispositivos en los que deviceWatcher está interesado.
Devoluciones
DeviceWatcher creado.
- Atributos
Consulte también
- CreateWatcher()
- CreateWatcher(DeviceClass)
- CreateWatcher(String)
- CreateWatcher(String, IIterable<String>)
Se aplica a
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 DeviceWatcherParámetros
- aqsFilter
-
String
Platform::String
winrt::hstring
- settings
- IDeviceEnumerationSettings
Devoluciones
- Atributos
Se aplica a
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de