DeviceInformation.CreateFromIdAsync Метод

Ссылка

Определение

Пространство имен:: Windows.Devices.Enumeration

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Перегрузки

CreateFromIdAsync(String)	Создает объект DeviceInformation на основе идентификатора DeviceInformation .
CreateFromIdAsync(String, IIterable<String>)	Создает объект DeviceInformation на основе идентификатора DeviceInformation и списка дополнительных свойств.
CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind)	Создает объект DeviceInformation из идентификатора DeviceInformation , списка дополнительных свойств и параметра DeviceInformationKind .
CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind, IDeviceEnumerationSettings)	Асинхронно создает объект DeviceInformation из идентификатора DeviceInformation , списка дополнительных свойств, Объекта DeviceInformationKind и объекта settings.

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 , ранее сохраненный приложением, полученный из свойства id последнего используемого объекта DeviceInformation .

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

Итерируемый список дополнительных свойств для включения в свойство Properties объектов DeviceInformation в результатах перечисления. Дополнительные сведения о том, что представляют свойства, см. в разделе Свойства сведений об устройстве.

Возвращаемое значение

IAsyncOperation<DeviceInformation>

Объект для запуска асинхронного создания объекта DeviceInformation и управления ими.

Атрибуты: OverloadAttribute

Примеры

В следующем примере создается список свойств, включаемых в объект DeviceInformation для создания из идентификатора DeviceInformation . Переменная savedId в этом примере — это идентификатор DeviceInformation , ранее сохраненный приложением, полученный из свойства id последнего используемого объекта DeviceInformation .

// 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 из идентификатора DeviceInformation , списка дополнительных свойств и параметра DeviceInformationKind .

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>

kind: DeviceInformationKind

Тип объекта DeviceInformation , который требуется создать.

Возвращаемое значение

IAsyncOperation<DeviceInformation>

Объект для запуска асинхронного создания объекта DeviceInformation и управления ими.

Атрибуты: OverloadAttribute

См. также раздел

Применяется к

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

Изменить

Асинхронно создает объект DeviceInformation из идентификатора DeviceInformation , списка дополнительных свойств, Объекта DeviceInformationKind и объекта settings.

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>

Итерируемый список дополнительных свойств, включаемых в свойство Properties объекта DeviceInformation в результатах перечисления. Дополнительные сведения о том, что представляют свойства, см. в разделе Свойства сведений об устройстве.

kind: DeviceInformationKind

Тип объекта DeviceInformation , который требуется создать.

settings: IDeviceEnumerationSettings

Аргумент, передаваемый в параметрах , является объектом, который реализует IDeviceEnumerationSettings; но в противном случае объект является непрозрачным классом маркера (то есть он не имеет открытых свойств или методов). Назначение параметров — получение расширенных параметров из API для конкретного устройства для сценариев, которые недоступны в стандартном API WDE. Вы можете думать о таких параметрах, как дополнительные ручки, которые не разрешены поверхностью API.

Объект settings будет поступать из метода GetDeviceEnumerationSettings API устройства и содержать непрозрачные данные. Но в настоящее время нет 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

Применяется к

Обратная связь

Дополнительные ресурсы