DeviceInformation.CreateFromIdAsync 方法

定义

命名空间:

Windows.Devices.Enumeration

重载

CreateFromIdAsync(String)	从 DeviceInformation ID 创建 DeviceInformation 对象。
CreateFromIdAsync(String, IIterable<String>)	从 DeviceInformation ID 和其他属性列表创建 DeviceInformation 对象。
CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind)	从 DeviceInformation ID、其他属性列表和 DeviceInformationKind 参数创建 DeviceInformation 对象。

CreateFromIdAsync(String)

从 DeviceInformation 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)

参数

deviceId

String

Platform::String

winrt::hstring

设备 ID。

返回

IAsyncOperation<DeviceInformation>

用于启动和管理 DeviceInformation 对象的异步创建的对象。

属性

OverloadAttribute RemoteAsyncAttribute

示例

此示例中的 savedId 变量是应用程序以前保存的 DeviceInformation ID，从上次使用的 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 ID 和其他属性列表创建 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 ID 的 字符串。

additionalProperties

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

要包含在枚举结果中 DeviceInformation 对象的 Properties 属性中的附加属性的可迭代列表。 有关属性表示的内容的详细信息，请参阅 设备信息属性。

返回

IAsyncOperation<DeviceInformation>

用于启动和管理 DeviceInformation 对象的异步创建的对象。

属性

OverloadAttribute

示例

以下示例生成要包含在 DeviceInformation 对象中的属性列表，以便从 DeviceInformation ID 创建。此示例中的 savedId 变量是应用程序以前保存的 DeviceInformation ID，从上次使用的 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 ID、其他属性列表和 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 ID 的 字符串。

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