DeviceInformation.CreateFromIdAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 .
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 .
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.
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 .
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.
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)
|