Freigeben über

Battery Klasse

  • Referenz

Definition

Namespace:
Windows.Devices.Power
Bearbeiten

Stellt Informationen zu einem Akkucontroller bereit, der derzeit mit dem Gerät verbunden ist. Weitere Informationen finden Sie unter Abrufen von Akkuinformationen.

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
Vererbung
Object Platform::Object IInspectable Battery
Attribute
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

In diesem Kontext bezieht sich das Gerät auf die Hardware, auf der Ihre App ausgeführt wird. Batteriecontroller bezieht sich auf die Elektronik, die zwischen der physischen Batterie und dem Betriebssystem verbunden ist. Ein Akkucontroller wird in Geräte-Manager als "Batterie" unter dem Knoten Batterien angezeigt.

Je nach Gerät kann es möglich sein, den physischen Akku zu entfernen, während das Gerät weiterhin ausgeführt wird. Beispielsweise ein Laptop, der an die Stromversorgung angeschlossen ist. In diesem Fall könnten Sie, wenn der Akkucontroller Teil des Laptopgehäuses ist, möglicherweise ein Battery-Objekt erstellen, wenn kein Akku mit dem Gerät verbunden ist. Wenn sich der Batteriecontroller jedoch auf dem physischen Akku befindet, wäre er für das Betriebssystem nicht mehr sichtbar, sodass Sie kein entsprechendes Akkuobjekt für eine einzelne Batterie erstellen könnten.

Eigenschaften

AggregateBattery

Ruft ein Battery-Objekt ab, das alle Akkucontroller darstellt, die mit dem Gerät verbunden sind.
DeviceId

Ruft den Bezeichner (ID) für einen einzelnen Akkucontroller ab.

Methoden

FromIdAsync(String)

Ruft ein Battery-Objekt ab, das einen einzelnen Akkucontroller darstellt, der mit dem Gerät verbunden ist.
GetDeviceSelector()

Ruft eine AQS-Zeichenfolge (Advanced Query Syntax) ab, die verwendet werden kann, um alle Akkucontroller zu finden, die mit dem Gerät verbunden sind.
GetReport()

Ruft ein BatteryReport-Objekt ab, das die Ladung, Kapazität und status des Akkus oder Aggregats angibt.

Ereignisse

ReportUpdated

Tritt auf, wenn sich die Ladung, Kapazität oder status eines Akkus ändert.

Gilt für:

Weitere Informationen