DeviceInformation.CreateFromIdAsync Methode

Definition

Überlädt

CreateFromIdAsync(String)

Erstellt ein DeviceInformation-Objekt aus einer DeviceInformation-ID .

CreateFromIdAsync(String, IIterable<String>)

Erstellt ein DeviceInformation-Objekt aus einer DeviceInformation-ID und einer Liste zusätzlicher Eigenschaften.

CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind)

Erstellt ein DeviceInformation-Objekt aus einer DeviceInformation-ID , einer Liste zusätzlicher Eigenschaften und einem DeviceInformationKind-Parameter .

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

Erstellt asynchron ein DeviceInformation-Objekt aus einer DeviceInformation-ID , einer Liste zusätzlicher Eigenschaften, einem DeviceInformationKind-Objekt und einem Einstellungsobjekt.

CreateFromIdAsync(String)

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)

Parameter

deviceId
String

Platform::String

winrt::hstring

Der Geräte-ID

Gibt zurück

Ein Objekt zum Starten und Verwalten der asynchronen Erstellung des DeviceInformation-Objekts .

Attribute

Beispiele

Die savedId-Variable in diesem Beispiel ist eine DeviceInformation-ID , die zuvor von der Anwendung gespeichert wurde und aus der id-Eigenschaft des zuletzt verwendeten DeviceInformation-Objekts abgerufen wurde.

// 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);
    });

Weitere Informationen

Gilt für:

CreateFromIdAsync(String, IIterable<String>)

Erstellt ein DeviceInformation-Objekt aus einer DeviceInformation-ID und einer Liste zusätzlicher Eigenschaften.

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)

Parameter

deviceId
String

Platform::String

winrt::hstring

Eine Zeichenfolge, die die DeviceInformation-ID enthält.

additionalProperties

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Eine iterierbare Liste zusätzlicher Eigenschaften, die in die Properties-Eigenschaft der DeviceInformation-Objekte in den Enumerationsergebnissen eingeschlossen werden sollen. Weitere Informationen dazu, was die Eigenschaften darstellen, finden Sie unter Geräteinformationseigenschaften.

Gibt zurück

Ein Objekt zum Starten und Verwalten der asynchronen Erstellung des DeviceInformation-Objekts .

Attribute

Beispiele

Im folgenden Beispiel wird eine Liste der Eigenschaften erstellt, die in das DeviceInformation-Objekt aufgenommen werden sollen, das aus einer DeviceInformation-ID erstellt werden soll. Die savedId-Variable in diesem Beispiel ist eine DeviceInformation-ID , die zuvor von der Anwendung gespeichert wurde und aus der id-Eigenschaft des zuletzt verwendeten DeviceInformation-Objekts abgerufen wurde.

// 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);
    });

Weitere Informationen

Gilt für:

CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind)

Erstellt ein DeviceInformation-Objekt aus einer DeviceInformation-ID , einer Liste zusätzlicher Eigenschaften und einem DeviceInformationKind-Parameter .

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)

Parameter

deviceId
String

Platform::String

winrt::hstring

Eine Zeichenfolge, die die DeviceInformation-ID enthält.

additionalProperties

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Eine iterierbare Liste zusätzlicher Eigenschaften, die in die Properties-Eigenschaft der DeviceInformation-Objekte in den Enumerationsergebnissen eingeschlossen werden sollen. Weitere Informationen dazu, was die Eigenschaften darstellen, finden Sie unter Geräteinformationseigenschaften.

kind
DeviceInformationKind

Der Typ des DeviceInformation-Objekts , das Sie erstellen möchten.

Gibt zurück

Ein Objekt zum Starten und Verwalten der asynchronen Erstellung des DeviceInformation-Objekts .

Attribute

Weitere Informationen

Gilt für:

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

Erstellt asynchron ein DeviceInformation-Objekt aus einer DeviceInformation-ID , einer Liste zusätzlicher Eigenschaften, einem DeviceInformationKind-Objekt und einem Einstellungsobjekt.

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)

Parameter

deviceId
String

Platform::String

winrt::hstring

Eine Zeichenfolge, die die DeviceInformation-ID enthält.

additionalProperties

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Eine iterierbare Liste zusätzlicher Eigenschaften, die in die Properties-Eigenschaft des DeviceInformation-Objekts in die Enumerationsergebnisse aufgenommen werden sollen. Weitere Informationen dazu, was die Eigenschaften darstellen, finden Sie unter Geräteinformationseigenschaften.

kind
DeviceInformationKind

Der Typ des DeviceInformation-Objekts , das Sie erstellen möchten.

settings
IDeviceEnumerationSettings

Das in den Einstellungen übergebene Argument ist ein Objekt, das IDeviceEnumerationSettings implementiert. Andernfalls ist das -Objekt jedoch von einer undurchsichtigen Markerklasse (das heißt, es verfügt über keine öffentlichen Eigenschaften oder Methoden). Der Zweck von Einstellungen besteht darin, erweiterte Parameter aus einer gerätespezifischen API für gerätespezifische Szenarien abzurufen, die in der WDE-Standard-API nicht möglich sind. Sie können sich die Parameter wie zusätzliche Regler vorstellen, die die API-Oberfläche nicht zulässt.

Das settings-Objekt stammt aus der GetDeviceEnumerationSettings-Methode einer Geräte-API und würde undurchsichtige Daten enthalten. Derzeit gibt es jedoch keine APIs, die das -Objekt erzeugen.

Gibt zurück

Ein asynchrones Vorgangsobjekt, das nach Abschluss des Vorgangs ein neu erstelltes DeviceInformation-Objekt enthält.

Attribute

Windows-Anforderungen

Gerätefamilie
Windows 11 Insider Preview (eingeführt in 10.0.26100.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v19.0)

Gilt für: