DeviceInformation.CreateWatcher Metodo

Definizione

Spazio dei nomi:

Windows.Devices.Enumeration

Overload

CreateWatcher()	Crea un DeviceWatcher per tutti i dispositivi.
CreateWatcher(String)	Crea un DeviceWatcher per i dispositivi che corrispondono alla stringa AQS (Advanced Query Syntax) specificata.
CreateWatcher(DeviceClass)	Crea un DeviceWatcher per i dispositivi corrispondenti a DeviceClass specificato.
CreateWatcher(String, IIterable<String>)	Crea un DeviceWatcher per i dispositivi che corrispondono alla stringa AQS (Advanced Query Syntax) specificata e alla raccolta specificata di proprietà.
CreateWatcher(String, IIterable<String>, DeviceInformationKind)	Crea un DeviceWatcher per i dispositivi che corrispondono alla stringa AQS (Advanced Query Syntax) specificata, alla raccolta specificata di proprietà e al tipo di dispositivi.

CreateWatcher()

Crea un DeviceWatcher per tutti i dispositivi.

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

Restituisce

DeviceWatcher

DeviceWatcher creato.

Attributi

OverloadAttribute

Commenti

DeviceWatcher esegue prima un'enumerazione iniziale dei dispositivi, generando un evento Aggiunto per ogni dispositivo trovato e generando un evento EnumerationCompleted al termine dell'enumerazione iniziale. Al termine dell'enumerazione iniziale, genera eventi quando un dispositivo viene aggiunto, eliminato o aggiornato.

Per un esempio, vedere la classe DeviceWatcher .

Nota

Un'app deve sottoscrivere tutti gli eventi aggiunti, rimossi e aggiornati per ricevere una notifica quando sono presenti aggiunte, rimozione o aggiornamenti dei dispositivi. Se un'app gestisce solo l'evento aggiunto , non riceverà un aggiornamento se un dispositivo viene aggiunto al sistema dopo il completamento dell'enumerazione iniziale del dispositivo.

Vedi anche

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

CreateWatcher(String)

Crea un DeviceWatcher per i dispositivi che corrispondono alla stringa AQS (Advanced Query Syntax) specificata.

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

Parametri

aqsFilter

String

Platform::String

winrt::hstring

Stringa AQS che filtra gli oggetti DeviceInformation da enumerare. In genere questa stringa viene recuperata dal metodo GetDeviceSelector di una classe che interagisce con i dispositivi. Ad esempio, GetDeviceSelector recupera la stringa per la classe StorageDevice .

Restituisce

DeviceWatcher

DeviceWatcher creato.

Attributi

OverloadAttribute

Commenti

Nota

Questo overload non è disponibile da JavaScript. Per creare un DeviceWatcher da una stringa AQS in JavaScript, usare l'overload CreateWatcher(String, IIterable_1) e passare null come secondo parametro.

DeviceWatcher esegue prima un'enumerazione iniziale dei dispositivi, generando un evento Aggiunto per ogni dispositivo trovato e generando un evento EnumerationCompleted al termine dell'enumerazione iniziale. Al termine dell'enumerazione iniziale, genera eventi quando un dispositivo viene aggiunto, eliminato o aggiornato.

Nota

Un'app deve sottoscrivere tutti gli eventi aggiunti, rimossi e aggiornati per ricevere una notifica quando sono presenti aggiunte, rimozione o aggiornamenti dei dispositivi. Se un'app gestisce solo l'evento aggiunto , non riceverà un aggiornamento se un dispositivo viene aggiunto al sistema dopo il completamento dell'enumerazione iniziale del dispositivo.

Per un esempio, vedere la classe DeviceWatcher .

Vedi anche

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

CreateWatcher(DeviceClass)

Crea un DeviceWatcher per i dispositivi corrispondenti a DeviceClass specificato.

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

Parametri

deviceClass

DeviceClass

Classe di dispositivo da enumerare usando DeviceWatcher.

Restituisce

DeviceWatcher

DeviceWatcher creato.

Attributi

DefaultOverloadAttribute OverloadAttribute

Commenti

DeviceWatcher esegue prima un'enumerazione iniziale dei dispositivi, generando un evento Aggiunto per ogni dispositivo trovato e generando un evento EnumerationCompleted al termine dell'enumerazione iniziale. Al termine dell'enumerazione iniziale, genera eventi quando un dispositivo viene aggiunto, eliminato o aggiornato.

Nota

Un'app deve sottoscrivere tutti gli eventi aggiunti, rimossi e aggiornati per ricevere una notifica quando sono presenti aggiunte, rimozione o aggiornamenti dei dispositivi. Se un'app gestisce solo l'evento aggiunto , non riceverà un aggiornamento se un dispositivo viene aggiunto al sistema dopo il completamento dell'enumerazione iniziale del dispositivo.

Per un esempio, vedere la classe DeviceWatcher .

Vedi anche

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

CreateWatcher(String, IIterable<String>)

Crea un DeviceWatcher per i dispositivi che corrispondono alla stringa AQS (Advanced Query Syntax) specificata e alla raccolta specificata di proprietà.

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

Parametri

aqsFilter

String

Platform::String

winrt::hstring

Stringa AQS che filtra gli oggetti DeviceInformation da enumerare. In genere questa stringa viene recuperata dal metodo GetDeviceSelector di una classe che interagisce con i dispositivi. Ad esempio, GetDeviceSelector recupera la stringa per la classe StorageDevice .

additionalProperties

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Elenco iterabile di proprietà aggiuntive da includere nella proprietà Proprietà degli oggetti DeviceInformation nei risultati dell'enumerazione. Per altre informazioni sulle proprietà rappresentate, vedere Proprietà delle informazioni sul dispositivo.

Restituisce

DeviceWatcher

DeviceWatcher creato.

Attributi

OverloadAttribute

Commenti

DeviceWatcher esegue prima un'enumerazione iniziale dei dispositivi, generando un evento Aggiunto per ogni dispositivo trovato e generando un evento EnumerationCompleted al termine dell'enumerazione iniziale. Al termine dell'enumerazione iniziale, genera eventi quando un dispositivo viene aggiunto, eliminato o aggiornato.

Nota

Un'app deve sottoscrivere tutti gli eventi aggiunti, rimossi e aggiornati per ricevere una notifica quando sono presenti aggiunte, rimozione o aggiornamenti dei dispositivi. Se un'app gestisce solo l'evento aggiunto , non riceverà un aggiornamento se un dispositivo viene aggiunto al sistema dopo il completamento dell'enumerazione iniziale del dispositivo.

Per un esempio, vedere la classe DeviceWatcher .

Vedi anche

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

CreateWatcher(String, IIterable<String>, DeviceInformationKind)

Crea un DeviceWatcher per i dispositivi che corrispondono alla stringa AQS (Advanced Query Syntax) specificata, alla raccolta specificata di proprietà e al tipo di dispositivi.

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

Parametri

aqsFilter

String

Platform::String

winrt::hstring

Stringa AQS che filtra gli oggetti DeviceInformation da enumerare. In genere questa stringa viene recuperata dal metodo GetDeviceSelector di una classe che interagisce con i dispositivi. Ad esempio, GetDeviceSelector recupera la stringa per la classe StorageDevice .

additionalProperties

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Elenco iterabile di proprietà aggiuntive da includere nella proprietà Proprietà degli oggetti DeviceInformation nei risultati dell'enumerazione. Per altre informazioni sulle proprietà rappresentate, vedere Proprietà delle informazioni sul dispositivo.

kind

DeviceInformationKind

I tipi specifici di dispositivi deviceWatcher sono interessati.

Restituisce

DeviceWatcher

DeviceWatcher creato.

Attributi

OverloadAttribute

Vedi anche

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