ReferenceValue.Subcomponents Method

The Subcomponents method creates a new ReferenceValue object that contains a set of subcomponents of this ReferenceValue object.

Syntax

public ReferenceValue Subcomponents(
  Int32 startingComponent,
  Int32 endingComponent
);

Public Function Subcomponents( _
  ByVal startingComponent As Int32, _
  ByVal endingComponent As Int32 _
) As ReferenceValue

Parameters

• startingComponent
  The zero-based index of the first distinguished name element to include in the subcomponent. The created subcomponent includes the first distinguished name element. This value must be less than endingComponent.

• endingComponent
  The zero-based index of the first distinguished name element to exclude from the subcomponent. The created subcomponent does not include the name element that is contained in this parameter. This value must be greater than startingComponent.

Return Value

Returns a ReferenceValue object that contains the specified subcomponents.

Exceptions

Remarks

The following VB example shows how the Subcomponents method returns the second and third components of the distinguished name. The output of this code will be "dc=domain,dc=fabrikam".

Examples

ReferenceValue dn = Utils.MAs["ADMA"].CreateDN("cn=jeffsmith,dc=domain,dc=fabrikam,dc=com");
ReferenceValue dnSub = dn.Subcomponents(1, 3);
System.Diagnostics.Debug.WriteLine(dnSub.ToString());

Requirements

See Also

ReferenceValue

Send comments about this topic to Microsoft

Build date: 2/16/2009