DeviceInformation.CreateFromIdAsync Méthode

Définition

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)

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

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

Attributs

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

S’applique à

CreateFromIdAsync(String, IIterable<String>)

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

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

Attributs

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

S’applique à

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 .

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>

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.

kind
DeviceInformationKind

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

Retours

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

Attributs

Voir aussi

S’applique à

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.

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

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

Attributs

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 à