DeviceInformation.CreateWatcher Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| CreateWatcher() |
Cria um DeviceWatcher para todos os dispositivos. |
| CreateWatcher(String) |
Cria um DeviceWatcher para dispositivos que correspondem à cadeia de caracteres AQS (Sintaxe de Consulta Avançada) especificada. |
| CreateWatcher(DeviceClass) |
Cria um DeviceWatcher para dispositivos que correspondem ao DeviceClass especificado. |
| CreateWatcher(String, IIterable<String>) |
Cria um DeviceWatcher para dispositivos que correspondem à cadeia de caracteres AQS (Sintaxe de Consulta Avançada) especificada e à coleção de propriedades especificada. |
| CreateWatcher(String, IIterable<String>, DeviceInformationKind) |
Cria um DeviceWatcher para dispositivos que correspondem à cadeia de caracteres AQS (Sintaxe de Consulta Avançada) especificada, à coleção especificada de propriedades e ao tipo de dispositivos. |
| CreateWatcher(String, IIterable<String>, DeviceInformationKind, IDeviceEnumerationSettings) |
CreateWatcher()
Cria um DeviceWatcher para todos os 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 DeviceWatcherRetornos
O DeviceWatcher criado.
- Atributos
Comentários
O DeviceWatcher primeiro executa uma enumeração inicial de dispositivos, gerando um evento adicionado para cada dispositivo encontrado e gerando um evento EnumerationCompleted quando a enumeração inicial é concluída. Depois que a enumeração inicial é concluída, ela gera eventos quando um dispositivo é adicionado, excluído ou atualizado.
Consulte a classe DeviceWatcher para obter um exemplo.
Observação
Um aplicativo deve assinar todos os eventos adicionados, removidos e atualizados para serem notificados quando houver adições, remoções ou atualizações do dispositivo. Se um aplicativo manipular apenas o evento adicionado , ele não receberá uma atualização se um dispositivo for adicionado ao sistema após a conclusão da enumeração inicial do dispositivo.
Confira também
Aplica-se a
CreateWatcher(String)
Cria um DeviceWatcher para dispositivos que correspondem à cadeia de caracteres AQS (Sintaxe de Consulta Avançada) 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
Uma cadeia de caracteres AQS que filtra os objetos DeviceInformation para enumerar. Normalmente, essa cadeia de caracteres é recuperada do método GetDeviceSelector de uma classe que interage com dispositivos. Por exemplo, GetDeviceSelector recupera a cadeia de caracteres para a classe StorageDevice .
Retornos
O DeviceWatcher criado.
- Atributos
Comentários
Observação
Essa sobrecarga não está disponível no JavaScript. Para criar um DeviceWatcher de uma cadeia de caracteres AQS em JavaScript, use a sobrecarga CreateWatcher(String, IIterable_1) e passe null como o segundo parâmetro.
O DeviceWatcher primeiro executa uma enumeração inicial de dispositivos, gerando um evento adicionado para cada dispositivo encontrado e gerando um evento EnumerationCompleted quando a enumeração inicial é concluída. Depois que a enumeração inicial é concluída, ela gera eventos quando um dispositivo é adicionado, excluído ou atualizado.
Observação
Um aplicativo deve assinar todos os eventos adicionados, removidos e atualizados para serem notificados quando houver adições, remoções ou atualizações do dispositivo. Se um aplicativo manipular apenas o evento adicionado , ele não receberá uma atualização se um dispositivo for adicionado ao sistema após a conclusão da enumeração inicial do dispositivo.
Consulte a classe DeviceWatcher para obter um exemplo.
Confira também
Aplica-se a
CreateWatcher(DeviceClass)
Cria um DeviceWatcher para dispositivos que correspondem ao DeviceClass especificado.
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
A classe de dispositivo a ser enumerada usando o DeviceWatcher.
Retornos
O DeviceWatcher criado.
- Atributos
Comentários
O DeviceWatcher primeiro executa uma enumeração inicial de dispositivos, gerando um evento adicionado para cada dispositivo encontrado e gerando um evento EnumerationCompleted quando a enumeração inicial é concluída. Depois que a enumeração inicial é concluída, ela gera eventos quando um dispositivo é adicionado, excluído ou atualizado.
Observação
Um aplicativo deve assinar todos os eventos adicionados, removidos e atualizados para serem notificados quando houver adições, remoções ou atualizações do dispositivo. Se um aplicativo manipular apenas o evento adicionado , ele não receberá uma atualização se um dispositivo for adicionado ao sistema após a conclusão da enumeração inicial do dispositivo.
Consulte a classe DeviceWatcher para obter um exemplo.
Confira também
Aplica-se a
CreateWatcher(String, IIterable<String>)
Cria um DeviceWatcher para dispositivos que correspondem à cadeia de caracteres AQS (Sintaxe de Consulta Avançada) especificada e à coleção de propriedades 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
Uma cadeia de caracteres AQS que filtra os objetos DeviceInformation para enumerar. Normalmente, essa cadeia de caracteres é recuperada do método GetDeviceSelector de uma classe que interage com dispositivos. Por exemplo, GetDeviceSelector recupera a cadeia de caracteres para a classe StorageDevice .
Uma lista iterável de propriedades adicionais a serem incluídas na propriedade Properties dos objetos DeviceInformation nos resultados da enumeração. Para obter mais informações sobre o que as propriedades representam, consulte Propriedades de informações do dispositivo.
Retornos
O DeviceWatcher criado.
- Atributos
Comentários
O DeviceWatcher primeiro executa uma enumeração inicial de dispositivos, gerando um evento adicionado para cada dispositivo encontrado e gerando um evento EnumerationCompleted quando a enumeração inicial é concluída. Depois que a enumeração inicial é concluída, ela gera eventos quando um dispositivo é adicionado, excluído ou atualizado.
Observação
Um aplicativo deve assinar todos os eventos adicionados, removidos e atualizados para serem notificados quando houver adições, remoções ou atualizações do dispositivo. Se um aplicativo manipular apenas o evento adicionado , ele não receberá uma atualização se um dispositivo for adicionado ao sistema após a conclusão da enumeração inicial do dispositivo.
Consulte a classe DeviceWatcher para obter um exemplo.
Confira também
Aplica-se a
CreateWatcher(String, IIterable<String>, DeviceInformationKind)
Cria um DeviceWatcher para dispositivos que correspondem à cadeia de caracteres AQS (Sintaxe de Consulta Avançada) especificada, à coleção especificada de propriedades e ao 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
Uma cadeia de caracteres AQS que filtra os objetos DeviceInformation para enumerar. Normalmente, essa cadeia de caracteres é recuperada do método GetDeviceSelector de uma classe que interage com dispositivos. Por exemplo, GetDeviceSelector recupera a cadeia de caracteres para a classe StorageDevice .
Uma lista iterável de propriedades adicionais a serem incluídas na propriedade Properties dos objetos DeviceInformation nos resultados da enumeração. Para obter mais informações sobre o que as propriedades representam, consulte Propriedades de informações do dispositivo.
Os tipos específicos de dispositivos nos quais o DeviceWatcher está interessado.
Retornos
O DeviceWatcher criado.
- Atributos
Confira também
- CreateWatcher()
- CreateWatcher(DeviceClass)
- CreateWatcher(String)
- CreateWatcher(String, IIterable<String>)
Aplica-se 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
Retornos
- Atributos
Aplica-se a
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de