DeviceInformation.CreateFromIdAsync 方法

参考

定义

命名空间:: Windows.Devices.Enumeration

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

CreateFromIdAsync(String)	从 DeviceInformation ID 创建 DeviceInformation 对象。
CreateFromIdAsync(String, IIterable<String>)	从 DeviceInformation ID 和其他属性列表创建 DeviceInformation 对象。
CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind)	从 DeviceInformation ID、其他属性列表和 DeviceInformationKind 参数创建 DeviceInformation 对象。
CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind, IDeviceEnumerationSettings)	从 DeviceInformation ID、其他属性列表、DeviceInformationKind 和 settings 对象异步创建 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, 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 ID 的字符串。

additionalProperties: IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

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

kind: DeviceInformationKind

要创建的 DeviceInformation 对象的类型。

settings: IDeviceEnumerationSettings

在设置中传递的参数是实现 IDeviceEnumerationSettings 的对象;但除此之外，对象是一个不透明的标记类 (也就是说，它没有公共属性或方法) 。设置的目的是针对在标准 WDE API 中无法实现的设备特定方案，从特定于设备的 API 检索扩展参数。可以将参数视为 API 图面不允许的额外旋钮。

设置对象将来自设备 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 要求

适用于

反馈

其他资源