Freigeben über

Festlegen von Eigenschaften mit mehreren Werten

  • Artikel

In diesem Thema wird veranschaulicht, wie mehrwertige Eigenschaften mit den folgenden Methoden festgelegt werden:

  • Add ist eine Methode von PropertyValueCollection, die einen weiteren Eigenschaftenwert zu einer mehrwertigen Eigenschaft hinzufügt.
  • AddRange ist eine Methode von PropertyValueCollection, die mehrere Werte zu einer mehrwertigen Eigenschaft hinzufügt.
  • Insert ist eine Methode von PropertyValueCollection, die einen Eigenschaftenwert anhand der Indexposition in eine mehrwertige Eigenschaft einfügt. Diese Position wird nur im Client festgelegt. Wenn ein Commit in das Verzeichnis ausgeführt wird, besteht keine Garantie, dass der Wert in den Active Directory-Domänendiensten an dieser Position gespeichert wird.

Sie können Werte auch mit einem indizierten Array festlegen.

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 AddRange-Methode veranschaulicht.

Dim ent As New DirectoryEntry("LDAP://Fabrikam/CN=My Username,CN=Users,DC=Fabrikam,DC=com")
ent.Properties("otherTelephone").AddRange(New Object() {"(425) 523 1462", "(523) 125 6321"})
ent.CommitChanges()

DirectoryEntry ent = new DirectoryEntry("LDAP://Fabrikam/CN=My Username,CN=Users,DC=Fabrikam,DC=com");
ent.Properties["otherTelephone"].AddRange(new object[] {"(425) 523 1462","(523) 125 6321"});
ent.CommitChanges();

Im folgenden Codebeispiel wird die Verwendung der Insert-Methode veranschaulicht.

Dim ent As New DirectoryEntry("LDAP://Fabrikam/CN=My Username,CN=Users,DC=Fabrikam,DC=com")
ent.Properties("otherTelephone").Insert(2, "525 623 5423")
ent.CommitChanges()

DirectoryEntry ent = new DirectoryEntry("LDAP://Fabrikam/CN=My Username,CN=Users,DC=Fabrikam,DC=com");
ent.Properties["otherTelephone"].Insert(2, "525 623 5423");
ent.CommitChanges();

Im folgenden Codebeispiel wird die Verwendung eines Arrays veranschaulicht, um in einer mehrwertigen Eigenschaft einen Wert festzulegen.

Dim ent As New DirectoryEntry("LDAP://Fabrikam/CN=My Username,CN=Users,DC=Fabrikam,DC=com")
ent.Properties("otherTelephone")(0) = "425 263 6234"
ent.CommitChanges()

DirectoryEntry ent = new DirectoryEntry("LDAP://Fabrikam/CN=My Username,CN=Users,DC=Fabrikam,DC=com");
ent.Properties["otherTelephone"][0] = "425 263 6234";
ent.CommitChanges();

Siehe auch

Referenz

System.DirectoryServices
PropertyValueCollection
DirectoryEntry

Konzepte

Eigenschaften mit mehreren Werten

Send comments about this topic to Microsoft.

Copyright © 2007 Microsoft Corporation. Alle Rechte vorbehalten.