DeviceInformation.CreateWatcher Método

Definição

Namespace:

Windows.Devices.Enumeration

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

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 DeviceWatcher

Retornos

DeviceWatcher

O DeviceWatcher criado.

Atributos

OverloadAttribute

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

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

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 DeviceWatcher

Parâ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

DeviceWatcher

O DeviceWatcher criado.

Atributos

OverloadAttribute

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

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

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 DeviceWatcher

Parâmetros

deviceClass

DeviceClass

A classe de dispositivo a ser enumerada usando o DeviceWatcher.

Retornos

DeviceWatcher

O DeviceWatcher criado.

Atributos

DefaultOverloadAttribute OverloadAttribute

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

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

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 DeviceWatcher

Parâ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 .

additionalProperties

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

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

DeviceWatcher

O DeviceWatcher criado.

Atributos

OverloadAttribute

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

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

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 DeviceWatcher

Parâ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 .

additionalProperties

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

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.

kind

DeviceInformationKind

Os tipos específicos de dispositivos nos quais o DeviceWatcher está interessado.

Retornos

DeviceWatcher

O DeviceWatcher criado.

Atributos

OverloadAttribute

Confira também

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