ManagementAgent.UnescapeDNComponent Method
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 |
See Also
InvalidDNException
ManagementAgent
Send comments about this topic to Microsoft
Build date: 2/16/2009