共用方式為


DeviceInformation.CreateFromIdAsync 方法

定義

多載

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)

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

裝置識別碼。

傳回

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

屬性

範例

此範例中的 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>)

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 屬性中包含的其他屬性清單。 如需屬性所代表內容的詳細資訊,請參閱 裝置資訊屬性

傳回

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

屬性

範例

下列範例會建置要包含在 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, 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 物件類型。

傳回

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

屬性

另請參閱

適用於

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。

傳回

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

屬性

Windows 需求

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

適用於