DeviceInformation.CreateFromIdAsync Méthode

Référence

Définition

Espace de noms:: Windows.Devices.Enumeration

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Surcharges

CreateFromIdAsync(String)	Crée un objet DeviceInformation à partir d’un ID DeviceInformation .
CreateFromIdAsync(String, IIterable<String>)	Crée un objet DeviceInformation à partir d’un ID DeviceInformation et d’une liste de propriétés supplémentaires.
CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind)	Crée un objet DeviceInformation à partir d’un ID DeviceInformation , d’une liste de propriétés supplémentaires et d’un paramètre DeviceInformationKind .
CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind, IDeviceEnumerationSettings)	Crée de manière asynchrone un objet DeviceInformation à partir d’un ID DeviceInformation , d’une liste de propriétés supplémentaires, d’un DeviceInformationKind et d’un objet settings.

CreateFromIdAsync(String)

Modifier

Crée un objet DeviceInformation à partir d’un ID DeviceInformation .

public:
 static IAsyncOperation<DeviceInformation ^> ^ CreateFromIdAsync(Platform::String ^ deviceId);

/// [Windows.Foundation.Metadata.Overload("CreateFromIdAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<DeviceInformation> CreateFromIdAsync(winrt::hstring const& deviceId);

[Windows.Foundation.Metadata.Overload("CreateFromIdAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<DeviceInformation> CreateFromIdAsync(string deviceId);

function createFromIdAsync(deviceId)

Public Shared Function CreateFromIdAsync (deviceId As String) As IAsyncOperation(Of DeviceInformation)

Paramètres

deviceId: String
Platform::String

winrt::hstring

L’ID de l’appareil.

Retours

IAsyncOperation<DeviceInformation>

Objet permettant de démarrer et de gérer la création asynchrone de l’objet DeviceInformation .

Attributs: OverloadAttribute RemoteAsyncAttribute

Exemples

La variable savedId dans cet exemple est un ID DeviceInformation précédemment enregistré par l’application, obtenu à partir de la propriété id du dernier objet DeviceInformation utilisé.

// Create a DeviceInformation object from a saved ID
var Enum = Windows.Devices.Enumeration;
var DevInf = Enum.DeviceInformation;
DevInf.createFromIdAsync(savedId).then(
    function(devinfo) {
        // Use the created DeviceInformation object
        printMessage("Created DeviceInformation. Name: " + devinfo.name);
    },
    function (e) {
        displayError("Failed to create DeviceInformation: " + e.message);
    });

Voir aussi

CreateFromIdAsync(String, IIterable<String>)

S’applique à

CreateFromIdAsync(String, IIterable<String>)

Modifier

Crée un objet DeviceInformation à partir d’un ID DeviceInformation et d’une liste de propriétés supplémentaires.

public:
 static IAsyncOperation<DeviceInformation ^> ^ CreateFromIdAsync(Platform::String ^ deviceId, IIterable<Platform::String ^> ^ additionalProperties);

/// [Windows.Foundation.Metadata.Overload("CreateFromIdAsyncAdditionalProperties")]
 static IAsyncOperation<DeviceInformation> CreateFromIdAsync(winrt::hstring const& deviceId, IIterable<winrt::hstring> const& additionalProperties);

[Windows.Foundation.Metadata.Overload("CreateFromIdAsyncAdditionalProperties")]
public static IAsyncOperation<DeviceInformation> CreateFromIdAsync(string deviceId, IEnumerable<string> additionalProperties);

function createFromIdAsync(deviceId, additionalProperties)

Public Shared Function CreateFromIdAsync (deviceId As String, additionalProperties As IEnumerable(Of String)) As IAsyncOperation(Of DeviceInformation)

Paramètres

deviceId: String
Platform::String

winrt::hstring

Chaîne contenant l’ID DeviceInformation .

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 les propriétés représentent, consultez Propriétés d’informations sur l’appareil.

Retours

IAsyncOperation<DeviceInformation>

Objet permettant de démarrer et de gérer la création asynchrone de l’objet DeviceInformation .

Attributs: OverloadAttribute

Exemples

L’exemple suivant génère une liste de propriétés à inclure dans l’objet DeviceInformation à créer à partir d’un ID DeviceInformation.La variable savedId dans cet exemple est un ID DeviceInformation précédemment enregistré par l’application, obtenu à partir de la propriété id du dernier objet DeviceInformation utilisé.

// Create a set of two additional properties
var propertiesToRetrieve = new Array();
propertiesToRetrieve.push("System.InterfaceClassGuid");
propertiesToRetrieve.push("System.Storage.IsPortable");

// Create a DeviceInformation object from a saved ID
var Enum = Windows.Devices.Enumeration;
var DevInf = Enum.DeviceInformation;
DevInf.createFromIdAsync(savedId, propertiesToRetrieve).then(
    function(devinfo) {
        // Use the created DeviceInformation object
        printMessage("Created DeviceInformation. Name: " + devinfo.name);
    },
    function (e) {
        displayError("Failed to create DeviceInformation: " + e.message);
    });

Voir aussi

CreateFromIdAsync(String)

S’applique à

CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind)

Modifier

Crée un objet DeviceInformation à partir d’un ID DeviceInformation , d’une liste de propriétés supplémentaires et d’un paramètre DeviceInformationKind .

public:
 static IAsyncOperation<DeviceInformation ^> ^ CreateFromIdAsync(Platform::String ^ deviceId, IIterable<Platform::String ^> ^ additionalProperties, DeviceInformationKind kind);

/// [Windows.Foundation.Metadata.Overload("CreateFromIdAsyncWithKindAndAdditionalProperties")]
 static IAsyncOperation<DeviceInformation> CreateFromIdAsync(winrt::hstring const& deviceId, IIterable<winrt::hstring> const& additionalProperties, DeviceInformationKind const& kind);

[Windows.Foundation.Metadata.Overload("CreateFromIdAsyncWithKindAndAdditionalProperties")]
public static IAsyncOperation<DeviceInformation> CreateFromIdAsync(string deviceId, IEnumerable<string> additionalProperties, DeviceInformationKind kind);

function createFromIdAsync(deviceId, additionalProperties, kind)

Public Shared Function CreateFromIdAsync (deviceId As String, additionalProperties As IEnumerable(Of String), kind As DeviceInformationKind) As IAsyncOperation(Of DeviceInformation)

Paramètres

deviceId: String
Platform::String

winrt::hstring

Chaîne contenant l’ID DeviceInformation .

additionalProperties: IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

kind: DeviceInformationKind

Type d’objet DeviceInformation que vous souhaitez créer.

Retours

IAsyncOperation<DeviceInformation>

Objet permettant de démarrer et de gérer la création asynchrone de l’objet DeviceInformation .

Attributs: OverloadAttribute

Voir aussi

S’applique à

CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind, IDeviceEnumerationSettings)

Modifier

Crée de manière asynchrone un objet DeviceInformation à partir d’un ID DeviceInformation , d’une liste de propriétés supplémentaires, d’un DeviceInformationKind et d’un objet settings.

public:
 static IAsyncOperation<DeviceInformation ^> ^ CreateFromIdAsync(Platform::String ^ deviceId, IIterable<Platform::String ^> ^ additionalProperties, DeviceInformationKind kind, IDeviceEnumerationSettings ^ settings);

/// [Windows.Foundation.Metadata.Overload("CreateFromIdAsyncWithAdditionalPropertiesKindAndSettings")]
 static IAsyncOperation<DeviceInformation> CreateFromIdAsync(winrt::hstring const& deviceId, IIterable<winrt::hstring> const& additionalProperties, DeviceInformationKind const& kind, IDeviceEnumerationSettings const& settings);

[Windows.Foundation.Metadata.Overload("CreateFromIdAsyncWithAdditionalPropertiesKindAndSettings")]
public static IAsyncOperation<DeviceInformation> CreateFromIdAsync(string deviceId, IEnumerable<string> additionalProperties, DeviceInformationKind kind, IDeviceEnumerationSettings settings);

function createFromIdAsync(deviceId, additionalProperties, kind, settings)

Public Shared Function CreateFromIdAsync (deviceId As String, additionalProperties As IEnumerable(Of String), kind As DeviceInformationKind, settings As IDeviceEnumerationSettings) As IAsyncOperation(Of DeviceInformation)

Paramètres

deviceId: String
Platform::String

winrt::hstring

Chaîne contenant l’ID DeviceInformation .

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 de l’objet DeviceInformation dans les résultats de l’énumération. Pour plus d’informations sur ce que les propriétés représentent, consultez Propriétés d’informations sur l’appareil.

kind: DeviceInformationKind

Type d’objet DeviceInformation que vous souhaitez créer.

settings: IDeviceEnumerationSettings

L’argument transmis dans les paramètres est un objet qui implémente IDeviceEnumerationSettings ; mais sinon, l’objet est d’une classe de marqueur opaque (autrement dit, il n’a pas de propriétés ou de méthodes publiques). L’objectif des paramètres est de récupérer des paramètres étendus à partir d’une API spécifique à l’appareil pour des scénarios spécifiques à l’appareil qui ne sont pas possibles dans l’API WDE standard. Vous pouvez penser aux paramètres tels que des boutons supplémentaires que la surface de l’API n’autorise pas.

L’objet settings proviendrait de la méthode GetDeviceEnumerationSettings d’une API d’appareil et contiendrait des données opaques. Mais il n’existe actuellement aucune API qui produit l’objet.

Retours

IAsyncOperation<DeviceInformation>

Objet d’opération asynchrone qui, une fois terminée, contient un objet DeviceInformation nouvellement créé.

Attributs: OverloadAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 11 Insider Preview (introduit dans 10.0.26100.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v19.0)

S’applique à

Partager via

DeviceInformation.CreateFromIdAsync Méthode

Définition

Surcharges

CreateFromIdAsync(String)

Paramètres

Retours

Exemples

Voir aussi

S’applique à

CreateFromIdAsync(String, IIterable<String>)

Paramètres

Retours

Exemples

Voir aussi

S’applique à

CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind)

Paramètres

Retours

Voir aussi

S’applique à

CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind, IDeviceEnumerationSettings)

Paramètres

Retours

Configuration requise pour Windows

S’applique à

Commentaires

Ressources supplémentaires