System.DirectoryServices.Protocols Namespace

System.DirectoryServices.Protocols 命名空间提供在轻量目录访问协议 (LDAP) 3 版 (V3) 和目录服务标记语言 (DSML) 2.0 版 (V2) 标准中定义的方法。 The System.DirectoryServices.Protocols namespace provides the methods defined in the Lightweight Directory Access Protocol (LDAP) version 3 (V3) and Directory Services Markup Language (DSML) version 2.0 (V2) standards.

AddRequest

AddRequest 类将项添加到目录中。The AddRequest class adds an entry to the directory.

AddResponse

AddResponseSendRequest(DirectoryRequest) 类作为对 AddRequest 的响应返回。The AddResponse class is returned by SendRequest(DirectoryRequest) as a response to AddRequest.

AsqRequestControl

AsqRequestControl 类创建特性范围查询 (ASQ) 控件。The AsqRequestControl class creates an attribute scoped query (ASQ) control. 此控件与搜索请求一起用于强制基于具有特定 DN 值的特性执行查询。This control is used with a search request to force the query to be based on a specific DN-valued attribute.

AsqResponseControl

AsqResponseControl 对象中将 SearchResponse 类作为对 AsqRequestControl 查询的响应返回。The AsqResponseControl class is returned in a SearchResponse object as a response to a AsqRequestControl query.

BerConversionException

BerConversionException 类是一个异常,当使用 BerConverter 对象转换数据时,将引发该异常。The BerConversionException class is an exception thrown when converting data using a BerConverter object.

BerConverter

BerConverter 类使用基本编码规则 (BER) 对结构化数据进行编码和解码。The BerConverter class encodes and decodes structured data using basic encoding rules (BER).

CompareRequest

CompareRequest 类确定目录对象是否容纳特性的指定值。The CompareRequest class determines whether the directory object holds the specified value for the attribute.

CompareResponse

CompareResponseSendRequest(DirectoryRequest) 类作为对 CompareRequest 的响应返回。The CompareResponse class is returned by SendRequest(DirectoryRequest) as a response to CompareRequest.

CrossDomainMoveControl

CrossDomainMoveControl 类与 ModifyDNRequest 对象一起使用以将 LDAP 对象从一个域移到另一个域。The CrossDomainMoveControl class is used with a ModifyDNRequest object to move an LDAP object from one domain to another.

DeleteRequest

DeleteRequest 类从目录中删除项。The DeleteRequest class deletes an entry from the directory.

DeleteResponse

DeleteResponseSendRequest(DirectoryRequest) 类作为对 DeleteRequest 的响应返回。The DeleteResponse class is returned by SendRequest(DirectoryRequest) as a response to DeleteRequest.

DirectoryAttribute

DirectoryAttribute 类可以访问属性值。The DirectoryAttribute class enables access to the attribute values.

DirectoryAttributeCollection

DirectoryAttributeCollection 类包含 DirectoryAttribute 对象的集合。The DirectoryAttributeCollection class contains a collection of DirectoryAttribute objects.

DirectoryAttributeModification

DirectoryAttributeModification 类可用于修改 DirectoryAttribute 值。The DirectoryAttributeModification class enables modification of the DirectoryAttribute values.

DirectoryAttributeModificationCollection

DirectoryAttributeModificationCollection 类包含 DirectoryAttributeModification 对象的集合。The DirectoryAttributeModificationCollection class contains a collection of DirectoryAttributeModification objects.

DirectoryConnection

DirectoryConnection 类是一个抽象类,不能进行实例化。The DirectoryConnection class is an abstract class and cannot be instantiated. 使用 LdapConnectionDsmlSoapHttpConnection 类可连接到目录服务器。Use the LdapConnection or DsmlSoapHttpConnection classes to connect to a directory server.

DirectoryControl

DirectoryControl 类指定各种 LDAP 操作的扩展数据。The DirectoryControl class specifies extension data for various LDAP operations.

DirectoryControlCollection

DirectoryControlCollection 类管理 DirectoryControl 对象的集合。The DirectoryControlCollection class manages a collection of DirectoryControl objects.

DirectoryException

DirectoryException 类是一个抽象类,用作所有 System.DirectoryServices.Protocols 异常的基类。The DirectoryException class is an abstract class used as the base class for all System.DirectoryServices.Protocols exceptions.

DirectoryIdentifier

DirectoryIdentifier 类是标识要连接到的目标的抽象类。The DirectoryIdentifier class is an abstract class that identifies the target to connect to.

DirectoryNotificationControl

DirectoryNotificationControl 类是一个用于扩展的 LDAP 异步搜索功能的目录控件,可注册在对 Active Directory 域服务中的对象进行更改时要通知的客户端。The DirectoryNotificationControl class is a directory control used with an extended LDAP asynchronous search function to register the client to be notified when changes are made to an object in the Active Directory Domain Services.

DirectoryOperation

DirectoryOperation 类是抽象类,用作请求元素和响应元素的基础。The DirectoryOperation class is an abstract class used as a base for request and response elements.

DirectoryOperationException

DirectoryOperationException 类是由 SendRequest(DirectoryRequest) 方法引发的异常,用于指示服务器返回了有错误的 DirectoryResponse 对象。The DirectoryOperationException class is an exception thrown by the SendRequest(DirectoryRequest) method to indicate that the server returned a DirectoryResponse object with an error.

DirectoryRequest

DirectoryRequest 类是与请求相关的类(如 SearchRequest 类和 AddRequest 类)的基类。The DirectoryRequest class is the base class for request related classes, like the SearchRequest and AddRequest classes.

DirectoryResponse

DirectoryResponse 类与 SearchResponseAddResponse 类相似,是请求响应类的基类。The DirectoryResponse class is the base class for request response classes, like the SearchResponse and AddResponse classes.

DirSyncRequestControl

DirSyncRequestControl 类是一种目录控件,它允许应用程序搜索目录,以查找自先前状态以来发生了更改的对象。The DirSyncRequestControl class is a directory control that enables the application to search the directory for objects that have changed since a previous state.

DirSyncResponseControl

DirSyncResponseControl 类是用于将 DirSyncRequest 信息从服务器传送到客户端的目录控件。The DirSyncResponseControl class is a directory control used to pass DirSyncRequest information from the server to the client.

DomainScopeControl

DomainScopeControl 类是一个目录控件,用于指示 LDAP 服务器在完成请求时不生成检索。The DomainScopeControl class is a directory control used to instruct the LDAP server not to generate referrals when completing a request.

DsmlAuthRequest

DsmlAuthRequest 类指示按 Principal 属性所标识的安全主体执行请求的方式来解释对请求的访问控制。The DsmlAuthRequest class indicates that access control for the requests be interpreted as though the requests are performed by the security principal identified by the Principal property.

DsmlAuthResponse

DsmlAuthResponseSendRequest(DirectoryRequest) 类作为对 DsmlAuthRequest 的响应返回。The DsmlAuthResponse class is returned by SendRequest(DirectoryRequest) as a response to DsmlAuthRequest.

DsmlDirectoryIdentifier

DsmlDirectoryIdentifier 类标识 HTTP 服务器。The DsmlDirectoryIdentifier class identifies an HTTP server.

DsmlDocument

DsmlDocument 类是构造或操作 DSML 文档的抽象类。The DsmlDocument class is an abstract class to construct or manipulate a DSML document. 它是 DsmlRequestDocumentDsmlResponseDocument 的基类。It is the base class for both DsmlRequestDocument and DsmlResponseDocument. DsmlDocument 支持集合和索引。DsmlDocument supports collections and indexes. 集合中的每一项都是从 DirectoryOperation 派生的对象。Each item in its collection is an object derived from DirectoryOperation.

DsmlErrorResponse

当出错时,由服务器生成 DsmlErrorResponse 类。The DsmlErrorResponse class is generated by the server when a severe error occurs.

DsmlInvalidDocumentException

DsmlInvalidDocumentException 类是一个异常,当 DSML 请求或响应文档的 XML 不是格式良好的或者无法使用 DSMLv2 架构对该文档进行验证时,将引发该异常。The DsmlInvalidDocumentException class is an exception that occurs when a DSML Request or Response document is not well-formed XML or cannot be validated with DSMLv2 schema.

DsmlRequestDocument

DsmlRequestDocument 类可让你生成 DSML 请求负载,如 AddRequestModifyRequestSearchRequestThe DsmlRequestDocument class enables you to build a DSML request payload, such as AddRequest, ModifyRequest, or SearchRequest. 它包含零个或多个 DirectoryRequest 派生对象。It contains zero or more DirectoryRequest derived objects. 用户可以先添加、删除、修改和枚举 DirectoryRequest,然后再发送到服务器。The user may add, delete, modify, and enumerate the DirectoryRequest before sending to the server. DsmlRequestDocument 可以与任何 DSML 绑定类(如 DsmlSoapHttpConnection)一起使用,以传输文档。DsmlRequestDocument can be used with any DSML Binding classes to transport the document, such as DsmlSoapHttpConnection.

DsmlResponseDocument

作为针对 DsmlRequestDocument 对象的响应生成的 DsmlResponseDocument 类,该类包含派生自 DirectoryResponse 的零个或多个对象。The DsmlResponseDocument class is a read-only collection generated as a response to a DsmlRequestDocument object that contains zero, or more, objects derived from DirectoryResponse.

DsmlSoapConnection

DsmlSoapConnection 类是一个不能进行实例化的抽象类。The DsmlSoapConnection class is an abstract class that cannot be instantiated. 它通过提供面向会话的功能,可以采用类似方式处理无状态协议和有状态协议。It enables stateless and stateful protocols to be handled similarly by providing session-oriented features.

DsmlSoapHttpConnection

DsmlSoapHttpConnection 类表示使用 SOAP over HTTP 与 DSML 网关的连接。The DsmlSoapHttpConnection class represents a connection to a DSML Gateway using SOAP over HTTP.

ErrorResponseException

ErrorResponseException 类是服务器返回 <errorResponse> 时发生的异常。The ErrorResponseException class is an exception that occurs when the server returns an <errorResponse>.

ExtendedDNControl

ExtendedDNControl 类请求 Active Directory 域服务对象的可分辨名称的扩展形式。The ExtendedDNControl class requests an extended form of the distinguished name of an Active Directory Domain Services object.

ExtendedRequest

ExtendedRequest 类将扩展的 LDAP 操作传递到服务器。The ExtendedRequest class passes extended LDAP operations to the server.

ExtendedResponse

ExtendedResponseSendRequest(DirectoryRequest) 类作为对 ExtendedRequest 的响应返回。The ExtendedResponse class is returned by SendRequest(DirectoryRequest) as a response to ExtendedRequest.

LazyCommitControl

LazyCommitControl 类指示服务器返回 DS 修改命令(如 add、delete 或 replace)的结果的时机为在内存中完成该命令后,但在将该命令提交到磁盘前。The LazyCommitControl class instructs the server to return the results of a DS modification command, such as add, delete, or replace, after it has been completed in memory, but before it has been committed to disk.

LdapConnection

LdapConnection 类创建与 Microsoft Active Directory 域服务或 LDAP 服务器的 TCP/IP 或 UDP LDAP 连接。The LdapConnection class creates a TCP/IP or UDP LDAP connection to Microsoft Active Directory Domain Services or an LDAP server.

LdapDirectoryIdentifier

LdapDirectoryIdentifier 类为一个或多个 LDAP 服务器创建目录标识符。The LdapDirectoryIdentifier class creates a directory identifier for one or more LDAP servers.

LdapException

LdapException 类是一个异常,当 LDAP 返回的错误代码未包含在 ResultCode 中时,将出现此异常。The LdapException class is an exception that occurs when LDAP returns an error code not included in ResultCode.

LdapSessionOptions

LdapSessionOptions 类用来获取或设置各种 LDAP 会话选项。The LdapSessionOptions class is used to get or set various LDAP session options.

ModifyDNRequest

ModifyDNRequest 类修改对象的识别名。The ModifyDNRequest class modifies the distinguished name of an object. 此类将对象移动到新的父级并且/或者重命名对象。This class moves an object to a new parent and/or renames the object.

ModifyDNResponse

ModifyDNResponseSendRequest(DirectoryRequest) 类作为对 ModifyDNRequest 的响应返回。The ModifyDNResponse class is returned by SendRequest(DirectoryRequest) as a response to ModifyDNRequest.

ModifyRequest

ModifyRequest 类修改现有目录项的特性。The ModifyRequest class modifies the attributes of an existing directory entry.

ModifyResponse

ModifyResponseSendRequest(DirectoryRequest) 类作为对 ModifyRequest 的响应返回。The ModifyResponse class is returned by SendRequest(DirectoryRequest) as a response to ModifyRequest.

PageResultRequestControl

PageResultRequestControl 类指示服务器以指定的页大小返回搜索结果。The PageResultRequestControl class instructs the server to return the search result in the specified page size.

PageResultResponseControl

PageResultResponseControl 类是一个目录控件,用于将页数据从服务器传送到客户端。The PageResultResponseControl class is a directory control used to pass page data from the server to the client.

PartialResultsCollection

PartialResultsCollection 类表示从尚未完成的异步操作返回的任何部分结果。The PartialResultsCollection class represents any partial results returned from a not-yet-completed asynchronous operation.

PermissiveModifyControl

PermissiveModifyControl 类用于修改 ModifyRequest 对象的行为。The PermissiveModifyControl class is used to modify the behavior of a ModifyRequest object.

QuotaControl

QuotaControl 类用于传递安全原则的安全标识符 (SID) 以检索与配额有关的数据。The QuotaControl class is used to pass the security identifier (SID) of a security principle to retrieve quota-related data.

ReferralCallback

ReferralCallback 类包含用作检索回调方法的委托。The ReferralCallback class contains delegates used as referral callback methods.

SearchOptionsControl

SearchOptionsControl 类用于将标志传递到服务器以控制搜索行为。The SearchOptionsControl class is used to pass flags to the server to control search behavior.

SearchRequest

SearchRequest 类启动搜索操作。The SearchRequest class initiates a search operation.

SearchResponse

SearchResponse 类被服务器作为响应发送到 SearchRequest 对象。The SearchResponse class is sent by the server as a response to a SearchRequest object. 此响应包含零个或多个 SearchResultEntry 对象,并且包含零个或多个 SearchResultReference 对象。This response contains zero or more SearchResultEntry objects, and zero or more SearchResultReference objects.

SearchResultAttributeCollection

SearchResultAttributeCollection 类是 DirectoryAttribute 对象的集合。The SearchResultAttributeCollection class is a collection of DirectoryAttribute objects.

SearchResultEntry

SearchResultEntry 类包含在结果集内返回的对象。The SearchResultEntry class contains an object returned in the result set.

SearchResultEntryCollection

SearchResultEntryCollection 类包含结果集中返回的 SearchResultEntry 对象的集合。The SearchResultEntryCollection class contains a collection of SearchResultEntry objects returned in a result set.

SearchResultReference

SearchResultReference 类包含服务器返回的单个搜索引用。The SearchResultReference class contains a single search reference returned by the server.

SearchResultReferenceCollection

SearchResultReferenceCollection 类包含 SearchResultReference 对象的集合。The SearchResultReferenceCollection class contains a collection of SearchResultReference objects.

SecurityDescriptorFlagControl

SecurityDescriptorFlagControl 类用于将标志传递到服务器以控制各种安全描述符行为。The SecurityDescriptorFlagControl class is used to pass flags to the server to control various security descriptor behaviors.

SecurityPackageContextConnectionInformation

SecurityPackageContextConnectionInformation 类包含有关安全连接的数据。The SecurityPackageContextConnectionInformation class contains data about a secure connection.

ShowDeletedControl

ShowDeletedControl 类与 SearchRequest 结合使用可指定搜索结果中应包含与搜索筛选器匹配的所有已删除对象。The ShowDeletedControl class is used with SearchRequest to specify that the search results should include any deleted objects that match the search filter.

SortKey

SortKey 类存储供排序控件使用的排序条件。The SortKey class stores sort criteria for use by sort controls.

SortRequestControl

SortRequestControl 类与 SearchRequest 一起使用,以指示服务器在将搜索结果返回到客户端应用程序之前对它们进行排序。The SortRequestControl class is used with SearchRequest to instruct the server to sort the search results before returning them to the client application.

SortResponseControl

SortResponseControl 类用于将排序数据从服务器传递到客户端。The SortResponseControl class is used to pass sort data from the server to the client.

TlsOperationException

TlsOperationException 类是当请求失败时在 StartTransportLayerSecurity(DirectoryControlCollection) 方法中发生的异常。The TlsOperationException class is an exception that occurs in the StartTransportLayerSecurity(DirectoryControlCollection) method if the request fails.

TreeDeleteControl

TreeDeleteControl 类与 DeleteRequest 结合使用可删除目录中的整个子树。The TreeDeleteControl class is used with DeleteRequest to delete an entire subtree in the directory.

VerifyNameControl

VerifyNameControl 类与 LDAP 搜索功能一起使用可指定用于验证对象是否存在的服务器。The VerifyNameControl class is used with an LDAP search function to specify the server used to verify the existence of an object.

VlvRequestControl

VlvRequestControl 类用于从服务器请求虚拟列表视图 (VLV) 支持。The VlvRequestControl class is used to request virtual list view (VLV) support from the server.

VlvResponseControl

VlvResponseControl 类用于将虚拟列表视图 (VLV) 数据从服务器传递到客户端。The VlvResponseControl class is used to pass virtual list view (VLV) data from the server to the client.

枚举

AuthType

AuthType 枚举用于指定将在该连接上使用的身份验证方法。The AuthType enumeration is used to specify the authentication method to use on a connection.

DereferenceAlias

DereferenceAlias 枚举指定取消引用别名的进程。The DereferenceAlias enumeration specifies the process by which aliases are dereferenced.

DirectoryAttributeOperation

DirectoryAttributeOperation 枚举指定要在目录特性上执行的操作。The DirectoryAttributeOperation enumeration specifies the operation to perform on a directory attribute.

DirectorySynchronizationOptions

DirectorySynchronizationOptions 枚举指定 DirSyncRequestControl 对象中的搜索行为。The DirectorySynchronizationOptions enumeration specifies the behavior of the search in a DirSyncRequestControl object.

DsmlDocumentProcessing

DsmlDocumentProcessing 枚举指定 DSML 文档的处理方法。The DsmlDocumentProcessing enumeration specifies the processing method for a DSML document.

DsmlErrorProcessing

DsmlErrorProcessing 枚举指定出错时如何继续。The DsmlErrorProcessing enumeration specifies how to proceed when an error occurs.

DsmlResponseOrder

DsmlResponseOrder 枚举指定响应的接收顺序。The DsmlResponseOrder enumeration specifies the order in which responses are received.

ErrorResponseCategory

ErrorResponseCategory 枚举包含可能的 DSML 错误响应。The ErrorResponseCategory enumeration contains possible DSML error responses.

ExtendedDNFlag

ExtendedDNFlag 枚举指定扩展识别名的格式。The ExtendedDNFlag enumeration specifies the format of an extended distinguished name.

LocatorFlags

LocatorFlags 枚举指定定位域控制器所需要的数据。The LocatorFlags enumeration specifies data required to locate a domain controller.

PartialResultProcessing

PartialResultProcessing 枚举指定正处理的部分结果所要求的类型。The PartialResultProcessing enumeration specifies the required type of partial results processing.

ReferralChasingOptions

ReferralChasingOptions 枚举指定是否以及如何追踪检索跟踪。The ReferralChasingOptions enumeration specifies if and how referral chasing is pursued.

ResultCode

ResultCode 枚举指定操作结果代码。The ResultCode enumeration specifies the operation result codes.

SearchOption

SearchOption 枚举指定用于定义搜索的行为方式的搜索选项。The SearchOption enumeration specifies the search options which define how the search will behave.

SearchScope

SearchScope 枚举指定搜索范围。The SearchScope enumeration specifies the scope of a search.

SecurityMasks

SecurityMasks 枚举指定各种安全描述符选项。The SecurityMasks enumeration specifies various security descriptor options.

SecurityProtocol

SecurityProtocol 枚举可用于指定连接使用的安全协议。The SecurityProtocol enumeration is used to specify the security protocol used by a connection.

委托

DereferenceConnectionCallback

DereferenceConnectionCallback 委托取消引用不再需要的连接。The DereferenceConnectionCallback delegate dereferences a connection that is no longer required. 很可能已通过成功调用 QueryForConnectionCallbackNotifyOfNewConnectionCallback 委托建立了该连接。The connection was probably established through a successful call to the QueryForConnectionCallback or NotifyOfNewConnectionCallback delegate.

NotifyOfNewConnectionCallback

如果在跟踪检索时创建了新连接,则调用 NotifyOfNewConnectionCallback 委托。The NotifyOfNewConnectionCallback delegate is called if a new connection was created while chasing a referral.

QueryClientCertificateCallback

QueryClientCertificateCallback 委托获取或设置默认回调函数,该函数用于在建立 SSL 连接时指定客户端证书。The QueryClientCertificateCallback delegate gets or sets the default callback function used to specify the client certificates while establishing an SSL connection.

QueryForConnectionCallback

QueryForConnectionCallback 委托确定是否有可供使用的缓存连接。The QueryForConnectionCallback delegate determines whether there is a cached connection available for use.

VerifyServerCertificateCallback

VerifyServerCertificateCallback 委托获取或设置默认回调函数,而该函数用于在建立 SSL 连接时验证服务器证书。The VerifyServerCertificateCallback delegate gets or sets the default callback function used to verify server certificates when establishing an SSL connection.