Battery Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
- Attributi
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. |