DeviceInformation.CreateWatcher Méthode

Définition

Espace de noms:

Windows.Devices.Enumeration

Surcharges

CreateWatcher()	Crée un DeviceWatcher pour tous les appareils.
CreateWatcher(String)	Crée un DeviceWatcher pour les appareils correspondant à la chaîne AQS (Advanced Query Syntax) spécifiée.
CreateWatcher(DeviceClass)	Crée un DeviceWatcher pour les appareils correspondant à la classe DeviceClass spécifiée.
CreateWatcher(String, IIterable<String>)	Crée un DeviceWatcher pour les appareils correspondant à la chaîne AQS (Advanced Query Syntax) spécifiée et à la collection de propriétés spécifiée.
CreateWatcher(String, IIterable<String>, DeviceInformationKind)	Crée un DeviceWatcher pour les appareils correspondant à la chaîne AQS (Advanced Query Syntax) spécifiée, à la collection de propriétés spécifiée et au type d’appareils.

CreateWatcher()

Crée un DeviceWatcher pour tous les appareils.

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

Retours

DeviceWatcher

DeviceWatcher créé.

Attributs

OverloadAttribute

Remarques

DeviceWatcher effectue d’abord une énumération initiale des appareils, déclenche un événement Added pour chaque appareil qu’il trouve et déclenche un événement EnumerationCompleted une fois l’énumération initiale terminée. Une fois l’énumération initiale terminée, elle déclenche des événements lorsqu’un appareil est ajouté, supprimé ou mis à jour.

Pour obtenir un exemple, consultez la classe DeviceWatcher .

Notes

Une application doit s’abonner à tous les événements ajoutés, supprimés et mis à jour pour être avertie en cas d’ajouts, de suppressions ou de mises à jour d’appareils. Si une application gère uniquement l’événement ajouté , elle ne reçoit pas de mise à jour si un appareil est ajouté au système une fois l’énumération initiale de l’appareil terminée.

Voir aussi

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

CreateWatcher(String)

Crée un DeviceWatcher pour les appareils correspondant à la chaîne AQS (Advanced Query Syntax) spécifiée.

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

Paramètres

aqsFilter

String

Platform::String

winrt::hstring

Chaîne AQS qui filtre les objets DeviceInformation à énumérer. En règle générale, cette chaîne est récupérée à partir de la méthode GetDeviceSelector d’une classe qui interagit avec les appareils. Par exemple, GetDeviceSelector récupère la chaîne de la classe StorageDevice .

Retours

DeviceWatcher

DeviceWatcher créé.

Attributs

OverloadAttribute

Remarques

Notes

Cette surcharge n’est pas disponible à partir de JavaScript. Pour créer un DeviceWatcher à partir d’une chaîne AQS en JavaScript, utilisez la surcharge CreateWatcher(String, IIterable_1) et passez null comme deuxième paramètre.

DeviceWatcher effectue d’abord une énumération initiale des appareils, déclenche un événement Added pour chaque appareil qu’il trouve et déclenche un événement EnumerationCompleted une fois l’énumération initiale terminée. Une fois l’énumération initiale terminée, elle déclenche des événements lorsqu’un appareil est ajouté, supprimé ou mis à jour.

Notes

Une application doit s’abonner à tous les événements ajoutés, supprimés et mis à jour pour être avertie en cas d’ajouts, de suppressions ou de mises à jour d’appareils. Si une application gère uniquement l’événement ajouté , elle ne reçoit pas de mise à jour si un appareil est ajouté au système une fois l’énumération initiale de l’appareil terminée.

Pour obtenir un exemple, consultez la classe DeviceWatcher .

Voir aussi

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

CreateWatcher(DeviceClass)

Crée un DeviceWatcher pour les appareils correspondant à la classe DeviceClass spécifiée.

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

Paramètres

deviceClass

DeviceClass

Classe d’appareil à énumérer à l’aide de DeviceWatcher.

Retours

DeviceWatcher

DeviceWatcher créé.

Attributs

DefaultOverloadAttribute OverloadAttribute

Remarques

DeviceWatcher effectue d’abord une énumération initiale des appareils, déclenche un événement Added pour chaque appareil qu’il trouve et déclenche un événement EnumerationCompleted une fois l’énumération initiale terminée. Une fois l’énumération initiale terminée, elle déclenche des événements lorsqu’un appareil est ajouté, supprimé ou mis à jour.

Notes

Une application doit s’abonner à tous les événements ajoutés, supprimés et mis à jour pour être avertie en cas d’ajouts, de suppressions ou de mises à jour d’appareils. Si une application gère uniquement l’événement ajouté , elle ne reçoit pas de mise à jour si un appareil est ajouté au système une fois l’énumération initiale de l’appareil terminée.

Pour obtenir un exemple, consultez la classe DeviceWatcher .

Voir aussi

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

CreateWatcher(String, IIterable<String>)

Crée un DeviceWatcher pour les appareils correspondant à la chaîne AQS (Advanced Query Syntax) spécifiée et à la collection de propriétés spécifiée.

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

Paramètres

aqsFilter

String

Platform::String

winrt::hstring

Chaîne AQS qui filtre les objets DeviceInformation à énumérer. En règle générale, cette chaîne est récupérée à partir de la méthode GetDeviceSelector d’une classe qui interagit avec les appareils. Par exemple, GetDeviceSelector récupère la chaîne de la classe StorageDevice .

additionalProperties

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Liste itérable de propriétés supplémentaires à inclure dans la propriété Properties des objets DeviceInformation dans les résultats de l’énumération. Pour plus d’informations sur ce que représentent les propriétés, consultez Propriétés des informations sur l’appareil.

Retours

DeviceWatcher

DeviceWatcher créé.

Attributs

OverloadAttribute

Remarques

DeviceWatcher effectue d’abord une énumération initiale des appareils, déclenche un événement Added pour chaque appareil qu’il trouve et déclenche un événement EnumerationCompleted une fois l’énumération initiale terminée. Une fois l’énumération initiale terminée, elle déclenche des événements lorsqu’un appareil est ajouté, supprimé ou mis à jour.

Notes

Une application doit s’abonner à tous les événements ajoutés, supprimés et mis à jour pour être avertie en cas d’ajouts, de suppressions ou de mises à jour d’appareils. Si une application gère uniquement l’événement ajouté , elle ne reçoit pas de mise à jour si un appareil est ajouté au système une fois l’énumération initiale de l’appareil terminée.

Pour obtenir un exemple, consultez la classe DeviceWatcher .

Voir aussi

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

CreateWatcher(String, IIterable<String>, DeviceInformationKind)

Crée un DeviceWatcher pour les appareils correspondant à la chaîne AQS (Advanced Query Syntax) spécifiée, à la collection de propriétés spécifiée et au type d’appareils.

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

Paramètres

aqsFilter

String

Platform::String

winrt::hstring

Chaîne AQS qui filtre les objets DeviceInformation à énumérer. En règle générale, cette chaîne est récupérée à partir de la méthode GetDeviceSelector d’une classe qui interagit avec les appareils. Par exemple, GetDeviceSelector récupère la chaîne de la classe StorageDevice .

additionalProperties

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Liste itérable de propriétés supplémentaires à inclure dans la propriété Properties des objets DeviceInformation dans les résultats de l’énumération. Pour plus d’informations sur ce que représentent les propriétés, consultez Propriétés des informations sur l’appareil.

kind

DeviceInformationKind

Les types spécifiques d’appareils qui intéressent DeviceWatcher .

Retours

DeviceWatcher

DeviceWatcher créé.

Attributs

OverloadAttribute

Voir aussi

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