Represents a Characteristic of a GATT service.
var gattCharacteristic = Windows.Devices.Bluetooth.GenericAttributeProfile.GattCharacteristic;
public sealed class GattCharacteristic
Public NotInheritable Class GattCharacteristic
public ref class GattCharacteristic sealed
- [ DualApiPartition()]
- [ MarshalingBehavior(Agile)]
- [ Version(0x06030000)]
The GattCharacteristic class has these types of members:
The GattCharacteristic class has these events.
|ValueChanged||An App can register an event handler in order to receive events when notification or indications are received from a device, after setting the Client Characteristic Configuration Descriptor.|
The GattCharacteristic class has these methods. With C#, Visual Basic, and C++, it also inherits methods from the Object class.
|ConvertShortIdToUuid||Converts a Bluetooth SIG defined short Id to a full GATT UUID.|
|GetAllDescriptors||Gets the collection of all descriptors belonging to this GattCharacteristic instance.|
|GetDescriptors||Returns a vector of descriptors, that are identified by the specified UUID, and belong to this GattCharacteristic instance.|
|ReadClientCharacteristicConfigurationDescriptorAsync||Reads the current value of the ClientCharacteristicConfigurationDescriptor.|
|ReadValueAsync||Performs a Characteristic Value read from the value cache maintained by Windows.|
|ReadValueAsync(BluetoothCacheMode)||Performs a Characteristic Value read either from the value cache maintained by Windows, or directly from the device.|
|WriteClientCharacteristicConfigurationDescriptorAsync||Writes the ClientCharacteristicConfigurationDescriptor to the Bluetooth LE device, and if the value to be written represents an indication or a notification and a ValueChanged event handler is registered, enables receiving ValueChanged events from the device.|
|WriteValueAsync(IBuffer)||Performs a Characteristic Value write to a Bluetooth LE device.|
|WriteValueAsync(IBuffer,GattWriteOption)||Performs a Characteristic Value write to a Bluetooth LE device.|
The GattCharacteristic class has these properties.
|Read-only||Gets the handle used to uniquely identify GATT-based characteristic attributes as declared on the Bluetooth LE device.|
|Read-only||Gets the GATT characteristic properties, as defined by the GATT profile.|
|Read-only||Gets the list of presentation format descriptors associated with this GattCharacteristic, in the order specified by the Aggregate Format Descriptor.|
|Read/write||Gets or sets the desired GATT security options for over the air communication with the device.|
|Read-only||Get the user friendly description for this GattCharacteristic, if the User Description Descriptor is present, otherwise this will be an empty string.|
|Read-only||Gets the GATT Characteristic UUID for this GattCharacteristic.|
The GattCharacteristic object represents a GATT Characteristic of a particular service, and is obtained from the Characteristics property of the GattDeviceService object.
Minimum supported client
|Windows 8.1 [Windows Store apps, desktop apps]|
Minimum supported server
|None supported [Windows Store apps, desktop apps]|
Minimum supported phone
|Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]|