Class BluetoothGattAttribute

Definition

Namespace:: Tizen.Network.Bluetooth

Assembly:: Tizen.Network.Bluetooth.dll

API Level:: 3

The Bluetooth GATT attribute.


                C#
                
                    Copy
                    
                
            
public abstract class BluetoothGattAttribute

Inheritance: System.Object

BluetoothGattAttribute

Derived: BluetoothGattCharacteristic

BluetoothGattCharacteristic

BluetoothGattDescriptor

BluetoothGattDescriptor

Constructors

View Source

BluetoothGattAttribute(String, BluetoothGattPermission)

The constructor.

Declaration


                C#
                
                    Copy
                    
                
            
public BluetoothGattAttribute(string uuid, BluetoothGattPermission permission)

Parameters

Type	Name	Description
System.String	uuid	The UUID of the GATT attribute.
BluetoothGattPermission	permission	Permission for the GATT attribute.

API Level: 3

Properties

View Source

Permissions

Permissions for this attribute.

Declaration


                C#
                
                    Copy
                    
                
            
public BluetoothGattPermission Permissions { get; }

Property Value

Type	Description
BluetoothGattPermission

API Level: 3

View Source

Uuid

The attribute's UUID.

Declaration


                C#
                
                    Copy
                    
                
            
public string Uuid { get; }

Property Value

Type	Description
System.String

API Level: 3

View Source

Value

The value of this descriptor.

Declaration


                C#
                
                    Copy
                    
                
            
public byte[] Value { get; set; }

Property Value

Type	Description
System.Byte[]

API Level: 3

Methods

View Source

GetValue(Int32)

Returns a string value at the specified offset.

Declaration


                C#
                
                    Copy
                    
                
            
public string GetValue(int offset)

Parameters

Type	Name	Description
Int32	offset	An offset in the attribute value buffer.

Returns

Type	Description
System.String	The string value at specified offset.

API Level: 3

View Source

GetValue(FloatDataType, Int32)

Returns a value at the specified offset as the float value of the specified type.

Declaration


                C#
                
                    Copy
                    
                
            
public float GetValue(FloatDataType type, int offset)

Parameters

Type	Name	Description
FloatDataType	type	The type of the float value.
Int32	offset	An offset in the attribute value buffer.

Returns

Type	Description
System.Single	The float value at given offset.

Exceptions

Type	Condition
System.InvalidOperationException	Throws exception if (offset + size of float value) is greater than the length of the value buffer.

API Level: 3

View Source

GetValue(IntDataType, Int32)

Returns a value at specified offset as the int value of the specified type.

Declaration


                C#
                
                    Copy
                    
                
            
public int GetValue(IntDataType type, int offset)

Parameters

Type	Name	Description
IntDataType	type	The type of the int value.
Int32	offset	An offset in the attribute value buffer.

Returns

Type	Description
Int32	The int value at given offset.

Exceptions

Type	Condition
System.InvalidOperationException	Throws exception if (offset + size of int value) is greater than the length of the value buffer.

API Level: 3

View Source

SetValue(String)

Sets the string value as a specified offset.

Declaration


                C#
                
                    Copy
                    
                
            
public void SetValue(string value)

Parameters

Type	Name	Description
System.String	value	value to set

Exceptions

Type	Condition
System.InvalidOperationException	Throws exception if the value is null.

API Level: 3

View Source

SetValue(FloatDataType, Int32, Int32, Int32)

Updates the value at the specified offset by the float value of the specified type.

Declaration


                C#
                
                    Copy
                    
                
            
public void SetValue(FloatDataType type, int mantissa, int exponent, int offset)

Parameters

Type	Name	Description
FloatDataType	type	The type of the float value.
Int32	mantissa	The mantissa of the float value.
Int32	exponent	An exponent of the float value.
Int32	offset	An offset in the attribute value buffer.

Exceptions

Type	Condition
System.InvalidOperationException	Throws exception if (offset + size of float value) is greater than the length of the value buffer.

API Level: 3

View Source

SetValue(IntDataType, Int32, Int32)

Updates a value at the specified offset by the int value of the specified type.

Declaration


                C#
                
                    Copy
                    
                
            
public void SetValue(IntDataType type, int value, int offset)

Parameters

Type	Name	Description
IntDataType	type	The type of the int value.
Int32	value	The value to set.
Int32	offset	An offset in the attribute value buffer.

Exceptions

Type	Condition
System.InvalidOperationException	Throws exception if (offset + size of int value) is greater than the length of the value buffer.

API Level: 3

Events

View Source

ReadRequested

This event is called when the client request to read the value of a characteristic or a descriptor.

Declaration


                C#
                
                    Copy
                    
                
            
public event EventHandler<ReadRequestedEventArgs> ReadRequested

Event Type

Type	Description
System.EventHandler<ReadRequestedEventArgs>

Remarks

BluetoothGattServer.RegisterGattService() should be called before adding/removing this EventHandler.

Exceptions

Type	Condition
System.InvalidOperationException	Thrown when the set read value requested callback procedure fails.

API Level: 3

View Source

WriteRequested

This event is called when a value of a characteristic or a descriptor has been changed by a client.

Declaration


                C#
                
                    Copy
                    
                
            
public event EventHandler<WriteRequestedEventArgs> WriteRequested

Event Type

Type	Description
System.EventHandler<WriteRequestedEventArgs>

Remarks

BluetoothGattServer.RegisterGattService() should be called before adding/removing this EventHandler.

Exceptions

Type	Condition
System.InvalidOperationException	Thrown when the set write value requested callback procedure fails.