DirectoryEntry::Username Property

.NET Framework (current version)
 

Gets or sets the user name to use when authenticating the client.

Namespace:   System.DirectoryServices
Assembly:  System.DirectoryServices (in System.DirectoryServices.dll)

C#
C++
F#
VB
Copy 
public:
[DSDescriptionAttribute("DSUsername")]
[TypeConverterAttribute("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[BrowsableAttribute(false)]
property String^ Username {
	String^ get();
	void set(String^ value);
}

Property Value

Type: System::String^

The user name to use when authenticating the client.

You can set the Username and Password in order to specify alternate credentials with which to access the information in Active Directory Domain Services. Any other DirectoryEntry objects retrieved from this instance (for example, through Children) are automatically created with the same alternate credentials.

The following example demonstrates the Username and Password properties of the DirectoryEntry class. This example gets the user-specified DirectoryEntry and the Path of all its Children.

C#
C++
VB
Copy 
String^ myADSPath = "LDAP://onecity/CN=Users,DC=onecity,DC=corp,DC=fabrikam,DC=com";

// Create an Instance of DirectoryEntry.
DirectoryEntry^ myDirectoryEntry = new DirectoryEntry(myADSPath);
myDirectoryEntry->Username = UserName;
myDirectoryEntry->Password = SecurelyStoredPassword;

// Get the Child ADS objects.
Console::WriteLine("The Child ADS objects are:");
Collections::IEnumerator^ myEnum = myDirectoryEntry->Children->GetEnumerator();
while (myEnum->MoveNext()) 
{
    DirectoryEntry^ myChildDirectoryEntry = safe_cast<DirectoryEntry^>(myEnum->Current);
    Console::WriteLine(myChildDirectoryEntry->Path);
}

.NET Framework
Available since 1.1
Return to top
Show: