DeviceInformation.CreateFromIdAsync 方法

定義

命名空間:

Windows.Devices.Enumeration

多載

CreateFromIdAsync(String)	從 DeviceInformation 識別符建立 DeviceInformation 物件。
CreateFromIdAsync(String, IIterable<String>)	從 DeviceInformation 識別符和其他屬性清單建立 DeviceInformation 物件。
CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind)	從 DeviceInformation 識別符、其他屬性清單和 DeviceInformationKind 參數建立 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)
• CreateFromIdAsync(String, IIterable<String>)