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	取得個別電池控制器的識別碼 (識別碼) 。

方法

FromIdAsync(String)	取得 Battery 物件，表示連接到裝置的個別電池控制器。
GetDeviceSelector()	取得進階查詢語法 (AQS) 字串，可用來尋找連線到裝置的所有電池控制器。
GetReport()	取得 BatteryReport 物件，指出電池或匯總的充電、容量和狀態。

事件

ReportUpdated

發生于電池的充電、容量或狀態變更時。

另請參閱

• 取得電池資訊