Microsoft Identity Integration Server 2003 Developer Reference

ManagementAgent.UnescapeDNComponent

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

[C#]
public String[] UnescapeDNComponent(
  String component
);

[Visual Basic .NET]
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 Values

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: 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.