DeviceInformation.CreateFromIdAsync 方法

參考

定義

命名空間:: Windows.Devices.Enumeration

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

CreateFromIdAsync(String)	從 DeviceInformation 識別符建立 DeviceInformation 物件。
CreateFromIdAsync(String, IIterable<String>)	從 DeviceInformation 識別符和其他屬性清單建立 DeviceInformation 物件。
CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind)	從 DeviceInformation 識別符、其他屬性清單和 DeviceInformationKind 參數建立 DeviceInformation 物件。
CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind, IDeviceEnumerationSettings)	以異步方式從 DeviceInformation ID、其他屬性清單、DeviceInformationKind 和 settings 物件建立 DeviceInformation 物件。

CreateFromIdAsync(String)

編輯

從 DeviceInformation 識別符建立 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)

參數

deviceId: String
Platform::String

winrt::hstring

裝置識別碼。

傳回

IAsyncOperation<DeviceInformation>

對象，用於啟動和管理 DeviceInformation 對象的異步建立。

屬性: OverloadAttribute RemoteAsyncAttribute

範例

此範例中的 savedId 變數是先前由應用程式儲存的 DeviceInformation 識別符，取自上次使用 DeviceInformation 物件的 id 屬性。

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

另請參閱

CreateFromIdAsync(String, IIterable<String>)

適用於

CreateFromIdAsync(String, IIterable<String>)

編輯

從 DeviceInformation 識別符和其他屬性清單建立 DeviceInformation 物件。

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)

參數

deviceId: String
Platform::String

winrt::hstring

包含 DeviceInformation 識別符的字串。

additionalProperties: IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

可反覆列出要在列舉結果中 DeviceInformation 物件的 Properties 屬性中包含的其他屬性清單。如需屬性所代表內容的詳細資訊，請參閱裝置資訊屬性。

傳回

IAsyncOperation<DeviceInformation>

對象，用於啟動和管理 DeviceInformation 對象的異步建立。

屬性: OverloadAttribute

範例

下列範例會建置要包含在 DeviceInformation 物件中的屬性清單，以從 DeviceInformation ID 建立。此範例中的 savedId 變數是先前由應用程式儲存的 DeviceInformation 標識符，從上次使用的 DeviceInformation 物件的 id 屬性取得。

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

另請參閱

CreateFromIdAsync(String)

適用於

CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind)

編輯

從 DeviceInformation 識別符、其他屬性清單和 DeviceInformationKind 參數建立 DeviceInformation 物件。

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)

參數

deviceId: String
Platform::String

winrt::hstring

包含 DeviceInformation 識別符的字串。

additionalProperties: IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

可反覆列出要在列舉結果中 DeviceInformation 物件的 Properties 屬性中包含的其他屬性清單。如需屬性所代表內容的詳細資訊，請參閱裝置資訊屬性。

kind: DeviceInformationKind

您想要建立的 DeviceInformation 物件類型。

傳回

IAsyncOperation<DeviceInformation>

對象，用於啟動和管理 DeviceInformation 對象的異步建立。

屬性: OverloadAttribute

另請參閱

適用於

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

編輯

以異步方式從 DeviceInformation ID、其他屬性清單、DeviceInformationKind 和 settings 物件建立 DeviceInformation 物件。

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)

參數

deviceId: String
Platform::String

winrt::hstring

包含 DeviceInformation 識別符的字串。

additionalProperties: IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

要在列舉結果中 DeviceInformation 物件的 Properties 屬性中包含其他屬性的可反覆清單。如需屬性所代表內容的詳細資訊，請參閱裝置資訊屬性。

kind: DeviceInformationKind

您想要建立的 DeviceInformation 物件類型。

settings: IDeviceEnumerationSettings

傳入設定的自變數是實作 IDeviceEnumerationSettings 的物件;但是，對像是不透明的標記類別 (，也就是說，它沒有公用屬性或方法) 。設定 的目的是從 裝置特定 API 擷取擴充參數，以用於標準 WDE API 中無法執行的裝置特定案例。您可以將參數想像為 API 介面不允許的額外 Knob。

設定物件會來自裝置 API 的 GetDeviceEnumerationSettings 方法，而且會包含不透明的數據。但目前沒有產生物件的 API。

傳回

IAsyncOperation<DeviceInformation>

異步操作物件，完成時會包含新建立的 DeviceInformation 物件。

屬性: OverloadAttribute

Windows 需求

裝置系列	Windows 11 Insider Preview (已於 10.0.26100.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v19.0 引進)

適用於

共用方式為

DeviceInformation.CreateFromIdAsync 方法

定義

多載

CreateFromIdAsync(String)

參數

傳回

範例

另請參閱

適用於

CreateFromIdAsync(String, IIterable<String>)

參數

傳回

範例

另請參閱

適用於

CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind)

參數

傳回

另請參閱

適用於

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

參數

傳回

Windows 需求

適用於

意見反應

其他資源