Battery 类

定义

命名空间:

Windows.Devices.Power

提供有关当前连接到设备的电池控制器的信息。 有关详细信息，请参阅 获取电池信息。

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

继承

Object Platform::Object IInspectable Battery

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

在此上下文中， 设备 是指运行应用的硬件。 电池控制器 是指在物理电池和操作系统之间连接的电子设备。 电池控制器在 设备管理器 中显示为“电池”节点下的“电池”。

根据设备的不同，可以在设备保持运行时移除物理电池。 例如，插入 A/C 电源的笔记本电脑。 在这种情况下，如果电池控制器是笔记本电脑机箱的一部分，则当没有电池连接到设备时，可能会创建 Battery 对象。 但是，如果电池控制器位于物理电池上，则它将不再对操作系统可见，因此无法为单个电池创建相应的 Battery 对象。

属性

AggregateBattery	获取代表连接到设备的所有电池控制器的 Battery 对象。
DeviceId	获取单个电池控制器的标识符 (ID) 。

方法

FromIdAsync(String)	获取一个 Battery 对象，该对象表示连接到设备的单个电池控制器。
GetDeviceSelector()	获取 AQS) 字符串 (高级查询语法，该字符串可用于查找连接到设备的所有电池控制器。
GetReport()	获取 一个 BatteryReport 对象，该对象指示电池或聚合的充电、容量和状态。

事件

ReportUpdated

当电池的充电、容量或状态发生更改时发生。

另请参阅

• 获取电池信息