ManagementAgent.UnescapeDNComponent Method

Article
02/16/2009

The UnescapeDNComponent method extracts the individual naming elements from a distinguished name component. The component can contain escaped characters.

Syntax

public String[] UnescapeDNComponent(
  String component
);

Public Function UnescapeDNComponent( _
  ByVal component As String _
) As String[]

Parameters

component
Contains the distinguished name component from which the elements will be extracted. This string can contain escaped characters.

Return Value

Returns an array of strings that contains the individual naming elements of the distinguished name.

Exceptions

Exception type	Condition
InvalidOperationException	The distinguished name component represented by the component parameter is not properly escaped or cannot be parsed.

Remarks

This method returns the least significant naming element in the first element of the array, and will continue to return the naming elements in order of increasing significance. For example, if the LDAP distinguished name "cn=jeffsmith\,cn=users\,dc=fabrikam\,dc=com" is passed to this method, the array that is returned will contain the following elements:

cn=jeffsmith

cn=users

dc=fabrikam

dc=com

Requirements

Product	ILM 2007 FP1
Namespace	Microsoft.MetadirectoryServices
Assembly	Microsoft.MetadirectoryServices
.NET Framework	.NET Framework 2.0