Value Event

Fired when a characteristic or descriptor value is received from the server.

Syntax

• C#
• VB.NET

public event OnValueHandler OnValue;

public delegate void OnValueHandler(object sender, BleclientValueEventArgs e);

public class BleclientValueEventArgs : EventArgs {
  public string ServiceId { get; }
  public string CharacteristicId { get; }
  public string DescriptorId { get; }
  public string Uuid { get; }
  public string Description { get; }
  public string Value { get; }
  public byte[] ValueB { get; }
}

Public Event OnValue As OnValueHandler

Public Delegate Sub OnValueHandler(sender As Object, e As BleclientValueEventArgs)

Public Class BleclientValueEventArgs Inherits EventArgs
  Public ReadOnly Property ServiceId As String
  Public ReadOnly Property CharacteristicId As String
  Public ReadOnly Property DescriptorId As String
  Public ReadOnly Property Uuid As String
  Public ReadOnly Property Description As String
  Public ReadOnly Property Value As String
  Public ReadOnly Property ValueB As Byte()
End Class

Remarks

This event is fired to signify that a value has been received for a characteristic or descriptor. The DescriptorId parameter will be empty string if the value is for a characteristic.

Uuid and Description are the UUID and Bluetooth SIG user-friendly name (if one is defined) of the characteristic or descriptor.

There are three scenarios which can cause this event to fire:

• The server has responded to a read request for a characteristic.
• The server has responded to a read request for a descriptor.
• The server has sent an updated value for a subscribed characteristic.

Whenever a value is received for a characteristic or descriptor, the value that the platform has cached for it is updated as well. You can read the cached value for a characteristic using CachedValue, or for a descriptor using CachedValue.

Refer to the ReadValue and/or Subscribe methods for more information.