DeviceInformation.CreateFromIdAsync Methode

Referenz

Definition

Namespace:: Windows.Devices.Enumeration

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ü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)

Bearbeiten

Erstellt ein DeviceInformation-Objekt aus einer DeviceInformation-ID .

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

IAsyncOperation<DeviceInformation>

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

Attribute: OverloadAttribute RemoteAsyncAttribute

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

CreateFromIdAsync(String, IIterable<String>)

Gilt für:

CreateFromIdAsync(String, IIterable<String>)

Bearbeiten

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

IAsyncOperation<DeviceInformation>

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

Attribute: OverloadAttribute

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

CreateFromIdAsync(String)

Gilt für:

CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind)

Bearbeiten

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>

kind: DeviceInformationKind

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

Gibt zurück

IAsyncOperation<DeviceInformation>

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

Attribute: OverloadAttribute

Weitere Informationen

Gilt für:

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

Bearbeiten

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

IAsyncOperation<DeviceInformation>

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

Attribute: OverloadAttribute

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:

Freigeben über

DeviceInformation.CreateFromIdAsync Methode

Definition

Überlädt

CreateFromIdAsync(String)

Parameter

Gibt zurück

Beispiele

Weitere Informationen

Gilt für:

CreateFromIdAsync(String, IIterable<String>)

Parameter

Gibt zurück

Beispiele

Weitere Informationen

Gilt für:

CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind)

Parameter

Gibt zurück

Weitere Informationen

Gilt für:

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

Parameter

Gibt zurück

Windows-Anforderungen

Gilt für:

Feedback

Zusätzliche Ressourcen