Compartilhar via


DeviceInformation.CreateFromIdAsync Método

Definição

Sobrecargas

CreateFromIdAsync(String)

Cria um objeto DeviceInformation de uma ID DeviceInformation .

CreateFromIdAsync(String, IIterable<String>)

Cria um objeto DeviceInformation de uma ID DeviceInformation e uma lista de propriedades adicionais.

CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind)

Cria um objeto DeviceInformation de uma ID DeviceInformation , uma lista de propriedades adicionais e um parâmetro DeviceInformationKind .

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

Cria de forma assíncrona um objeto DeviceInformation de uma ID DeviceInformation , uma lista de propriedades adicionais, um DeviceInformationKind e um objeto settings.

CreateFromIdAsync(String)

Cria um objeto DeviceInformation de uma 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)

Parâmetros

deviceId
String

Platform::String

winrt::hstring

A ID do dispositivo.

Retornos

Um objeto para iniciar e gerenciar a criação assíncrona do objeto DeviceInformation .

Atributos

Exemplos

A variável savedId neste exemplo é uma ID DeviceInformation salva anteriormente pelo aplicativo, obtida da propriedade id do objeto DeviceInformation usado pela última vez.

// 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);
    });

Confira também

Aplica-se a

CreateFromIdAsync(String, IIterable<String>)

Cria um objeto DeviceInformation de uma ID DeviceInformation e uma lista de propriedades adicionais.

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)

Parâmetros

deviceId
String

Platform::String

winrt::hstring

Uma cadeia de caracteres que contém a ID de DeviceInformation .

additionalProperties

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Uma lista iterável de propriedades adicionais a serem incluídas na propriedade Properties dos objetos DeviceInformation nos resultados da enumeração. Para obter mais informações sobre o que as propriedades representam, consulte Propriedades de informações do dispositivo.

Retornos

Um objeto para iniciar e gerenciar a criação assíncrona do objeto DeviceInformation .

Atributos

Exemplos

O exemplo a seguir cria uma lista de propriedades a serem incluídas no objeto DeviceInformation a ser criada a partir de uma ID DeviceInformation . A variável savedId neste exemplo é uma ID DeviceInformation salva anteriormente pelo aplicativo, obtida da propriedade id do objeto DeviceInformation usado pela última vez.

// 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);
    });

Confira também

Aplica-se a

CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind)

Cria um objeto DeviceInformation de uma ID DeviceInformation , uma lista de propriedades adicionais e um parâmetro 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)

Parâmetros

deviceId
String

Platform::String

winrt::hstring

Uma cadeia de caracteres que contém a ID de DeviceInformation .

additionalProperties

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Uma lista iterável de propriedades adicionais a serem incluídas na propriedade Properties dos objetos DeviceInformation nos resultados da enumeração. Para obter mais informações sobre o que as propriedades representam, consulte Propriedades de informações do dispositivo.

kind
DeviceInformationKind

O tipo de objeto DeviceInformation que você deseja criar.

Retornos

Um objeto para iniciar e gerenciar a criação assíncrona do objeto DeviceInformation .

Atributos

Confira também

Aplica-se a

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

Cria de forma assíncrona um objeto DeviceInformation de uma ID DeviceInformation , uma lista de propriedades adicionais, um DeviceInformationKind e um objeto 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)

Parâmetros

deviceId
String

Platform::String

winrt::hstring

Uma cadeia de caracteres que contém a ID de DeviceInformation .

additionalProperties

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Uma lista iterável de propriedades adicionais a serem incluídas na propriedade Properties do objeto DeviceInformation nos resultados da enumeração. Para obter mais informações sobre o que as propriedades representam, consulte Propriedades de informações do dispositivo.

kind
DeviceInformationKind

O tipo de objeto DeviceInformation que você deseja criar.

settings
IDeviceEnumerationSettings

O argumento passado nas configurações é um objeto que implementa IDeviceEnumerationSettings; mas, caso contrário, o objeto é de uma classe de marcador opaco (ou seja, ele não tem propriedades ou métodos públicos). A finalidade das configurações é recuperar parâmetros estendidos de uma API específica do dispositivo para cenários específicos do dispositivo que não são possíveis na API padrão do WDE. Você pode pensar nos parâmetros como botões extras que a superfície da API não permite.

O objeto settings seria proveniente do método GetDeviceEnumerationSettings de uma API de dispositivo e conteria dados opacos. Mas, atualmente, não há APIs que produzam o objeto.

Retornos

Um objeto de operação assíncrona que, quando concluído, contém um objeto DeviceInformation recém-criado.

Atributos

Requisitos do Windows

Família de dispositivos
Windows 11 Insider Preview (introduzida na 10.0.26100.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v19.0)

Aplica-se a