Creates a new ReferenceValue object that contains a set of subcomponents of this ReferenceValue object.
Namespace: Microsoft.MetadirectoryServices
Assembly: Microsoft.MetadirectoryServicesEx (in microsoft.metadirectoryservicesex.dll)

Usage

Visual Basic 
Dim instance As ReferenceValue
Dim startingComponent As Integer
Dim endingComponent As Integer
Dim returnValue As ReferenceValue

returnValue = instance.Subcomponents(startingComponent, endingComponent)

Syntax

Visual Basic 
Public MustOverride Function Subcomponents ( _
		startingComponent As Integer, _
		endingComponent As Integer _
) As ReferenceValue
C# 
public abstract ReferenceValue Subcomponents (
		int startingComponent,
		int endingComponent
)
C++ 
public:
virtual ReferenceValue^ Subcomponents (
		int startingComponent, 
		int endingComponent
) abstract
J# 
public abstract ReferenceValue Subcomponents (
		int startingComponent, 
		int endingComponent
)
JScript 
public abstract function Subcomponents (
		startingComponent : int, 
		endingComponent : int
) : 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 the endingComponent value.

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 the startingComponent value.

Return Value

Returns a ReferenceValue object that contains the specified subcomponents.

Exceptions

Exception type Condition
System.ArgumentOutOfRangeException

One of the following cases:

  • The startingComponent or endingComponent value is not valid in the ReferenceValue object.

  • The startingComponent value is greater than or equal to the endingComponent value.

  • The startingComponent or endingComponent value is greater than the depth of the ReferenceValue object that is provided by the Depth property.

Remarks

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

Visual Basic Script  Copy Code 
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());

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Target Platforms

Change History

See Also