GattCharacteristic 類別

定義

命名空間:

Windows.Devices.Bluetooth.GenericAttributeProfile

代表 GATT 服務的特性。 GattCharacteristic 物件代表特定服務的 GATT 特性，並從 GattDeviceService 物件的 Characteristics 屬性取得。

public ref class GattCharacteristic 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 GattCharacteristic 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 GattCharacteristic

Public NotInheritable Class GattCharacteristic

繼承

Object Platform::Object IInspectable GattCharacteristic

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)
應用程式功能	bluetooth

備註

版本歷程記錄

Windows 版本	SDK 版本	新增值
1703	15063	GetDescriptorsAsync
1703	15063	GetDescriptorsAsync (BluetoothCacheMode)
1703	15063	GetDescriptorsForUuidAsync (Guid)
1703	15063	GetDescriptorsForUuidAsync (Guid，BluetoothCacheMode)
1703	15063	WriteClientCharacteristicConfigurationDescriptorWithResultAsync
1703	15063	WriteValueWithResultAsync (IBuffer)
1703	15063	WriteValueWithResultAsync (IBuffer，GattWriteOption)

屬性

AttributeHandle	取得用來唯一識別 GATT 型特性屬性的控制碼，如藍牙 LE 裝置上宣告。
CharacteristicProperties	取得 GATT 特性屬性，如 GATT 設定檔所定義。 如果 ExtendedProperties 旗標存在，它也會代表擴充特性屬性描述元的屬性。
PresentationFormats	根據匯總格式描述元所指定的順序，取得與此 GattCharacteristic 相關聯的簡報格式描述元清單。 如果找不到 PresentationFormat 或匯總格式描述項，則清單應該是空的。
ProtectionLevel	取得或設定與裝置無線通訊所需的 GATT 安全性選項。 Windows 會在配對程式中與裝置交涉最大的安全性，而指定較低層級的安全性並不會降低現有的安全性層級。
Service	取得此特性為成員的 GattDeviceService 。
UserDescription	取得此 GattCharacteristic 的使用者易記描述，如果使用者描述描述元存在，則為空字串。
Uuid	取得這個 GattCharacteristic 的 GATT 特性 UUID。

方法

ConvertShortIdToUuid(UInt16)	將藍牙 SIG 定義的簡短識別碼轉換為完整的 GATT UUID。 重要 ConvertShortIdToUuid API 已被取代，未來版本的 Windows 可能無法使用。 請改用 BluetoothUuidHelper.FromShortId。
GetAllDescriptors()	取得屬於這個 GattCharacteristic 實例之所有描述項的集合。 重要 GetAllDescriptors API 已被取代，未來版本的 Windows 可能無法使用。 請改用 GetDescriptorsAsync。
GetDescriptors(Guid)	傳回描述項的向量，這個向量是由指定的 UUID 所識別，並屬於這個 GattCharacteristic 實例。 重要 GetDescriptors API 已被取代，未來版本的 Windows 可能無法使用。 請改用 GetDescriptorsForUuidAsync。
GetDescriptorsAsync()	傳回這個 GattCharacteristic 實例的描述項。
GetDescriptorsAsync(BluetoothCacheMode)	傳回具有這個 GattCharacteristic 實例之指定快取模式的描述項。
GetDescriptorsForUuidAsync(Guid)	傳回其 UUID 符合描述元Uuid 的描述項。
GetDescriptorsForUuidAsync(Guid, BluetoothCacheMode)	傳回描述項，其 UUID 與指定的 cacheMode 相符描述元Uuid。
ReadClientCharacteristicConfigurationDescriptorAsync()	讀取 ClientCharacteristicConfigurationDescriptor 的目前值。
ReadValueAsync()	執行從 Windows 維護的值快取讀取的特性值。
ReadValueAsync(BluetoothCacheMode)	從 Windows 維護的值快取或直接從裝置執行特性值讀取。
WriteClientCharacteristicConfigurationDescriptorAsync(GattClientCharacteristicConfigurationDescriptorValue)	將 ClientCharacteristicConfigurationDescriptor 寫入藍牙 LE 裝置，如果要寫入的值代表指示或通知，且已登錄 ValueChanged 事件處理常式，則可讓您從裝置接收 ValueChanged 事件。
WriteClientCharacteristicConfigurationDescriptorWithResultAsync(GattClientCharacteristicConfigurationDescriptorValue)	將 ClientCharacteristicConfigurationDescriptor 寫入藍牙 LE 裝置，如果要寫入的值代表指示或通知，且已登錄 ValueChanged 事件處理常式，則可讓您從裝置接收 ValueChanged 事件。
WriteValueAsync(IBuffer)	執行特性值寫入藍牙 LE 裝置。
WriteValueAsync(IBuffer, GattWriteOption)	執行特性值寫入藍牙 LE 裝置。
WriteValueWithResultAsync(IBuffer)	執行特性值寫入藍牙 LE 裝置。
WriteValueWithResultAsync(IBuffer, GattWriteOption)	執行特性值寫入藍牙 LE 裝置。

事件

ValueChanged

應用程式可以在設定用戶端特性設定描述項之後，註冊事件處理常式，以便在從裝置收到通知或指示時接收事件。