複数値を含むプロパティの設定

[アーティクル]
09/12/2008

ここでは、次のメソッドを使用して複数値プロパティを設定する方法について説明します。

Add は、複数値プロパティに追加のプロパティ値を追加する PropertyValueCollection のメソッドです。
AddRange は、複数値プロパティに複数の値を追加する PropertyValueCollection のメソッドです。
Insert は、複数値プロパティにインデックス位置を使ってプロパティ値を挿入する PropertyValueCollection のメソッドです。この位置は、クライアント上でのみ設定されます。ディレクトリにコミットした場合、Active Directory ドメインサービスのこのインデックス位置に保存される保証はありません。

インデックス付き配列を使用して値を設定することもできます。

プロパティ値を設定すると、データはプロパティキャッシュに格納されます。ディレクトリに新しいデータを書き込むには、CommitChanges メソッドを呼び出します。詳細については、「プロパティキャッシュ」を参照してください。

次のコード例は、AddRange メソッドの使用方法を示しています。

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();

次のコード例は、Insert メソッドの使用方法を示しています。

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();

次のコード例は、配列を使用して複数値プロパティに値を設定する方法を示しています。

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();

次の方法で共有

複数値を含むプロパティの設定

関連項目

リファレンス

概念

その他のリソース