DeviceInformation.CreateFromIdAsync Метод

Определение

Перегрузки

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

идентификатор устройства;

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

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

Атрибуты

Примеры

Переменная 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>)

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

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

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

Атрибуты

Примеры

В следующем примере создается список свойств, включаемых в объект 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, 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>

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

kind
DeviceInformationKind

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

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

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

Атрибуты

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

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

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, создающих объект .

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

Объект асинхронной операции, который по завершении содержит только что созданный объект DeviceInformation .

Атрибуты

Требования к Windows

Семейство устройств
Windows 11 Insider Preview (появилось в 10.0.26100.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v19.0)

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