ServiceElement Class

public sealed class ServiceElement

Public NotInheritable Class ServiceElement

public ref class ServiceElement sealed

[<SealedAttribute>]
type ServiceElement = class end

Inheritance

Object    ServiceElement

A Service Element hold the data in a SDP Service Record. It can hold various types of data, being like the ‘variant’ type in some environments. Each ServiceAttribute in a ServiceRecord holds its content in a Service Element.

The types currently defined in the Service Discovery specification include unsigned and signed integers of various sizes (8-bit, 16-bit etc), UUIDs in the full 128-bit form or in the 16 and 32-bit forms, TextString, Url etc. An element can itself also contain a list of element, either as a ‘sequence’ or an ‘alternative’, and thus an attribute can contain a tree of values, e.g. as used by the ProtocolDescriptorList attribute.

The type that an element is holding can be accessed with the ElementTypeDescriptor and ElementType properties which are of type ElementTypeDescriptor and ElementType respectively, the former being the ‘major’ type e.g. UnsignedInteger, and the latter the ‘minor’ type e.g. UInt16.

The element's value can be accessed in various ways, either directly in its internal form through its Value property. It has return type Object so the value will have to be cast before use, see the UInt16 example below. There are also a number of type-specific methods, e.g. GetValueAsElementArray, GetValueAsUuid, GetValueAsString(Encoding) etc. Each will throw an InvalidOperationException if the element is not of a suitable type. The complete set is:

Note that there are no access methods for the numeric type for instance so the Value property will have to be used e.g.

// ElementType is UInt16
ushort x = (ushort)element.Value;

// ElementType is UInt16
Dim x As UShort = CUShort(element.Value);

Additional type-specific methods can be added as required, in fact the full set of 19+ could be added, it just requires implementation and test…

Reference