Battery Clase

Definición

Espacio de nombres:

Windows.Devices.Power

Proporciona información sobre un controlador de batería que está conectado actualmente al dispositivo. Para obtener más información, consulta Obtener información sobre la batería.

public ref class Battery sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Battery final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class Battery

Public NotInheritable Class Battery

Herencia

Object Platform::Object IInspectable Battery

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

En este contexto, el dispositivo hace referencia al hardware en el que se ejecuta la aplicación. El controlador de batería hace referencia a la electrónica que interactúa entre la batería física y el sistema operativo. Un controlador de batería aparece en Administrador de dispositivos como una "Batería" bajo el nodo Baterías.

Dependiendo del dispositivo, puede ser posible quitar la batería física mientras el dispositivo permanece en funcionamiento. Por ejemplo, un portátil conectado a la alimentación A/C. En ese caso, si el controlador de batería formaba parte del gabinete del portátil, podría crear un objeto Battery cuando no haya batería conectada al dispositivo. Sin embargo, si el controlador de batería residía en la batería física, ya no sería visible para el sistema operativo y, por lo tanto, no podía crear un objeto Battery correspondiente para una batería individual.

Propiedades

AggregateBattery	Obtiene un objeto Battery que representa todos los controladores de batería conectados al dispositivo.
DeviceId	Obtiene el identificador (ID) de un controlador de batería individual.

Métodos

FromIdAsync(String)	Obtiene un objeto Battery que representa un controlador de batería individual conectado al dispositivo.
GetDeviceSelector()	Obtiene una cadena de sintaxis de consulta avanzada (AQS) que se puede usar para buscar todos los controladores de batería conectados al dispositivo.
GetReport()	Obtiene un objeto BatteryReport que indica la carga, la capacidad y el estado de la batería o el agregado.

Eventos

ReportUpdated

Se produce cuando cambia la carga, la capacidad o el estado de una batería.

Consulte también

• Obtener información sobre la batería