Battery Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.Devices.Power
Modifica

Fornisce informazioni su un controller della batteria attualmente connesso al dispositivo. Per altre informazioni, vedere Ottenere informazioni sulla batteria.

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
Ereditarietà
Object Platform::Object IInspectable Battery
Attributi
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

In questo contesto, il dispositivo fa riferimento all'hardware in esecuzione dell'app. Il controller della batteria fa riferimento all'elettronica che si interfaccia tra la batteria fisica e il sistema operativo. Un controller della batteria viene visualizzato in Gestione dispositivi come "Batteria" nel nodo Batterie.

A seconda del dispositivo, potrebbe essere possibile rimuovere la batteria fisica mentre il dispositivo rimane in esecuzione. Ad esempio, un portatile collegato all'alimentazione A/C. In questo caso, se il controller della batteria faceva parte dell'chassis del portatile, potresti potenzialmente creare un oggetto Battery quando non è connessa alcuna batteria al dispositivo. Tuttavia, se il controller della batteria risiede sulla batteria fisica, non sarebbe più visibile al sistema operativo e quindi non è possibile creare un oggetto Battery corrispondente per una singola batteria.

Proprietà

AggregateBattery

Ottiene un oggetto Battery che rappresenta tutti i controller di batteria connessi al dispositivo.
DeviceId

Ottiene l'identificatore (ID) per un singolo controller della batteria.

Metodi

FromIdAsync(String)

Ottiene un oggetto Battery che rappresenta un singolo controller della batteria connesso al dispositivo.
GetDeviceSelector()

Ottiene una stringa AQS (Advanced Query Syntax) che può essere usata per trovare tutti i controller di batteria connessi al dispositivo.
GetReport()

Ottiene un oggetto BatteryReport che indica la carica, la capacità e lo stato della batteria o dell'aggregazione.

Eventi

ReportUpdated

Si verifica quando la carica, la capacità o lo stato di una batteria cambia.

Si applica a

Vedi anche