Microsoft Identity Integration Server 2003 Developer Reference

ReferenceValue

The ReferenceValue class represents an attribute value that is a distinguished name.

The ReferenceValue class is derived from the Value class.

Public Methods

The ReferenceValue class has the following public methods.

Method Description
Concat(ReferenceValue)

Creates a new ReferenceValue object by concatenating the distinguished name of this ReferenceValue with the distinguished name of another ReferenceValue object.

Concat(String)

Creates a new ReferenceValue object by concatenating the distinguished name of this ReferenceValue with a distinguished name string. The string can contain escaped characters.

Equals

Determines whether the specified System.Object is equal to the current Value.

GetHashCode

Serves as a hash function for a particular type.

GetType

Retrieves the Type of the current object.

Parent

Creates a new ReferenceValue object that contains the distinguished name of the parent of this ReferenceValue object.

Parent(Int32)

Creates a new ReferenceValue object that contains the distinguished name of the parent of this ReferenceValue object, starting from the specified parent level.

Subcomponents

Creates a new ReferenceValue object that contains a set of subcomponents of this ReferenceValue object.

ToBinary

Because the binary value of a reference makes no sense, if you attempt to execute this method, it throws the InvalidOperationException exception.

ToBoolean

Because the Boolean value of a reference makes no sense, if you attempt to execute this method, it throws the InvalidOperationException exception.

ToInteger

Because the integer value of a reference makes no sense, if you attempt to execute this method, it throws the InvalidOperationException exception.

ToString

Interprets the contents of the ReferenceValue object as a System.String value. If the value is binary, it is converted to a string of hexadecimal digits in little-endian byte order. The return value can contain escaped characters.

Public Properties

The ReferenceValue class has the following public properties.

Property Description
DataType Data type: AttributeType
Access type: Read-only

Inherited from the Value class. Retrieves one of the AttributeType values that indicates the type of data that the Value object contains.

Depth Data type: Int32
Access type: Read-only

Retrieves the hierarchy depth of this ReferenceValue object. This property is equal to the number of components in the distinguished name.

Item Data type: String
Access type: Read-only

Retrieves an individual component of the distinguished name. The return value can contain escaped characters.

Protected Constructors

The ReferenceValue class has the following protected constructor.

Constructor Description
ReferenceValue

Creates an instance of the ReferenceValue class.

Requirements

Product: Microsoft Identity Integration Server 2003
Namespace: Defined in Microsoft.MetadirectoryServices.
Assembly: Requires Microsoft.MetadirectoryServices (in Microsoft.MetadirectoryServices.dll).
.NET Framework: Requires .NET Framework 1.1.

See Also

AttributeType, Value