Festlegen von Eigenschaften für Verzeichnisobjekte

In diesem Thema wird erläutert, wie für Verzeichnisobjekte Eigenschaften mit einzelnen Werten festgelegt werden. Das Thema enthält darüber hinaus Codebeispiele.

Verwenden Sie zum Ändern von Eigenschaftenwerten die folgenden Methoden:

• Value ist eine Eigenschaft des PropertyValueCollection-Objekts, die für Eigenschaften, die einen einzelnen Wert enthalten, direkt einen neuen Wert für die Eigenschaft festlegt.
• Add ist eine Methode des PropertyValueCollection-Objekts, das einen Wert zu einer mehrwertigen Eigenschaft hinzufügt. Weitere Informationen zu mehrwertigen Eigenschaften finden Sie unter Eigenschaften mit mehreren Werten.

Beim Festlegen eines Eigenschaftenwerts werden die Daten im Eigenschaftencache gespeichert Rufen Sie zum Schreiben der neuen Daten in das Verzeichnis die CommitChanges-Methode auf. Weitere Informationen hierzu finden Sie unter Der Eigenschaftencache.

Im folgenden Codebeispiel wird die Verwendung der Value-Eigenschaft veranschaulicht.

Try
    Dim ent As New DirectoryEntry("LDAP://Fabrikam/CN=My Username,CN=Users,DC=Fabrikam,DC=com")
    ent.Properties("sn").Value = "Barr"
    ent.CommitChanges()
Catch COMEx As COMException
    ' If a COMException is thrown, then the following code example can catch the text of the error.
    ' For more information about handling COM exceptions, see Handling Errors.
    Console.WriteLine(COMEx.ErrorCode)
End Try

try
{
    DirectoryEntry ent = new DirectoryEntry(
        "LDAP://Fabrikam/CN=My Username,CN=Users,DC=Fabrikam,DC=com");
    ent.Properties["sn"].Value = "Barr";
    ent.CommitChanges();
}
catch (COMException COMEx)
{
    // If a COMException is thrown, then the following code example can catch the text of the error.
    // For more information about handling COM exceptions, see Handling Errors.
    Console.WriteLine(COMEx.ErrorCode);
}

Siehe auch

Referenz

System.DirectoryServices
PropertyValueCollection
DirectoryEntry

Konzepte

Verzeichnisobjekteigenschaften
Der Eigenschaftencache
Eigenschaften mit mehreren Werten

Send comments about this topic to Microsoft.

Copyright © 2007 Microsoft Corporation. Alle Rechte vorbehalten.