DirectoryEntry类是Windows操作系统中非常有用的一个系统类。它提供了一种简洁易用的方式来访问Active Directory、LDAP以及其他系统资源。通过使用DirectoryEntry类，应用程序开发者可以访问和操作Windows域中的用户、组、计算机和其他资源，并实现对Active Directory中的数据进行管理和维护。本文将就DirectoryEntry类的应用场景和使用方法作详细的探讨。

一、带参初始化DirectoryEntry对象

要访问Active Directory或LDAP中的数据源，首先需要获得一个DirectoryEntry对象。DirectoryEntry类的构造函数支持两种初始化方式，即带参数初始化和不带参数初始化。带参数初始化方式可以用来指定目录对象的路径和登录认证信息。

目录对象的路径指的是要访问的Active Directory或LDAP目录的路径。在使用DirectoryEntry类访问目录对象时，需要提供一个路径以便确定要访问的目录的位置。例如，下面的代码表示访问名为“example.com”的域：

```

DirectoryEntry domain = new DirectoryEntry("LDAP://example.com");

```

在初始化时，如果提供的路径无效，则会触发ArgumentException异常。

如果目录对象需要的话，我们还可以提供认证信息来进行登录验证。DirectoryEntry类的构造函数支持传递用户名和密码，这意味着我们可以使用这些凭据来登录目录。例如，下面的代码表示使用登录名和密码登录名为“ example.com”的域：

```

DirectoryEntry domain = new DirectoryEntry("LDAP://example.com", "domain\username", "password");

```

当我们将用户名和密码传递给构造函数调用时，DirectoryEntry对象将使用这些凭据来访问目录，这一过程称为绑定。如果用户名或密码不正确，则会触发DirectoryServicesCOMException异常。

二、读取DirectoryEntry对象属性

一旦DirectoryEntry对象被创建，我们就可以通过它来获得目录对象的属性信息。DirectoryEntry对象提供了Properties集合来访问目录对象的所有属性。这个集合与标准的Dictionary集合很相似。我们可以在Properties集合中添加、修改和删除目录对象的属性，并访问它们的值。例如，下面的代码显示如何添加和修改一个属性：

```

DirectoryEntry entry = new DirectoryEntry("LDAP://example.com");

entry.Properties["displayName"].Add("New User Name"); // 添加displayName属性

entry.Properties["displayName"][0] = "Updated User Name"; // 修改displayName属性

```

在初始化DirectoryEntry对象后，我们可以使用Properties集合访问目录对象的属性。例如，下面的代码显示如何访问与目录对象有关的属性：

```

DirectoryEntry entry = new DirectoryEntry("LDAP://example.com");

Console.WriteLine(entry.Properties["distinguishedName"].Value); // 访问distinguishedName属性的值

Console.WriteLine(entry.Properties["objectSid"].Count); // 输出objectSid属性的值

```

在访问Properties集合中的属性时，需要为每个属性提供一个名称，并通过其Value属性来访问该属性的值。另外需要注意的是，DirectoryEntry的属性是一个实时的，可以动态访问的集合。例如，当我们获取属性时，我们可以更改目录中的属性值，并且下一次访问该属性时，将返回更新后的值。

三、创建DirectoryEntry对象和操作目录对象

DirectoryEntry类不仅仅是用来访问和读取目录对象，它还可以用来创建和编辑目录对象。通过使用DirectoryEntry类，我们可以创建新的用户、组和计算机对象，同时也可以修改和删除现有的目录对象。例如，下面的代码显示如何创建一个新的组：

```

DirectoryEntry entry = new DirectoryEntry("LDAP://example.com");

DirectoryEntry group = entry.Children.Add("CN=NewGroup", "group"); // 创建新组

group.Properties["sAMAccountName"].Add("newgrp"); // 添加sAMAccountName属性

group.CommitChanges(); // 提交更改

```

在上面的代码中，我们首先创建了一个新的DirectoryEntry对象（entry），然后创建了一个名为“NewGroup”的新组，并向其添加了一个sAMAccountName属性。最后，我们通过调用CommitChanges方法来保存对目录对象的更改。

另外，如果要删除目录对象，我们可以调用DirectoryEntry类的Delete方法：

```

DirectoryEntry user = new DirectoryEntry("LDAP://example.com/CN=JohnDoe,CN=Users,DC=example,DC=com");

user.Delete(); // 删除用户

```

总结

DirectoryEntry类是一个非常有用的系统类，可用于访问和编辑Active Directory、LDAP等系统资源。我们可以通过它来创建、修改和删除目录对象，并通过其Properties集合来读取和设置属性。在使用DirectoryEntry类时，需要注意的是，它使用实时的、动态的属性集合。因此，当我们获取目录对象的属性时，它可能已经被另一个进程更新过。因此，我们需要在修改目录对象之前先调用DirectoryEntry对象的RefreshCache方法来获取最新的属性集合。