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

AddResponse 類別是由 SendRequest(DirectoryRequest) 傳回以回應 AddRequestThe AddResponse class is returned by SendRequest(DirectoryRequest) as a response to AddRequest.

AsqRequestControl

AsqRequestControl 類別會建立屬性範圍的查詢 (Attribute Scoped Query,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 類別使用基本編碼規則 (Basic Encoding Rules,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

CompareResponse 類別是由 SendRequest(DirectoryRequest) 傳回以回應 CompareRequestThe CompareResponse class is returned by SendRequest(DirectoryRequest) as a response to CompareRequest.

CrossDomainMoveControl

CrossDomainMoveControl 類別 (Class) 要與 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

DeleteResponse 類別是由 SendRequest(DirectoryRequest) 傳回以回應 DeleteRequestThe 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 類別是抽象類別,所以無法執行具現化 (Instantiated)。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 類別是可要求相關類別的基底類別,如 SearchRequestAddRequest 類別。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 類別 (Class) 指示要求的存取控制可按照如同由 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

DsmlAuthResponse 類別是由 SendRequest(DirectoryRequest) 傳回以回應 DsmlAuthRequestThe DsmlAuthResponse class is returned by SendRequest(DirectoryRequest) as a response to DsmlAuthRequest.

DsmlDirectoryIdentifier

DsmlDirectoryIdentifier 類別 (Class) 識別 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 類別 (Class) 由伺服器在發生嚴重錯誤時產生。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 類別可讓您建置 DMSL 要求裝載 (例如 AddRequestModifyRequestSearchRequest)。The 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

DsmlResponseDocument 類別是唯讀的集合,作為 DsmlRequestDocument 物件的回應所產生,該物件包含零或多個衍生自 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 類別是無法執行具現化 (Instantiated) 的抽象類別。The DsmlSoapConnection class is an abstract class that cannot be instantiated. 它可透過提供工作階段 (Session) 導向的功能,對沒有狀態 (stateful) 和有狀態的通訊協定進行相似的處理。It enables stateless and stateful protocols to be handled similarly by providing session-oriented features.

DsmlSoapHttpConnection

DsmlSoapHttpConnection 類別 (Class) 表示使用 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 類別 (Class) 要求提供 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

ExtendedResponse 類別是由 SendRequest(DirectoryRequest) 傳回以回應 ExtendedRequestThe ExtendedResponse class is returned by SendRequest(DirectoryRequest) as a response to ExtendedRequest.

LazyCommitControl

LazyCommitControl 類別 (Class) 指示伺服器於修改作業在記憶體中完成之後和被磁碟認可之前,傳回該 DS 修改命令 (如加入、刪除或取代) 的結果。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

ModifyDNResponse 類別是由 SendRequest(DirectoryRequest) 傳回以回應 ModifyDNRequestThe 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

ModifyResponse 類別是由 SendRequest(DirectoryRequest) 傳回以回應 ModifyRequestThe 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 類別 (Class) 用來修改 ModifyRequest 物件的行為。The PermissiveModifyControl class is used to modify the behavior of a ModifyRequest object.

QuotaControl

QuotaControl 類別 (Class) 用於傳遞安全性原則的安全性識別項 (SID),以擷取與配額相關的資料。The QuotaControl class is used to pass the security identifier (SID) of a security principle to retrieve quota-related data.

ReferralCallback

ReferralCallback 類別包含做為轉介回呼 (Callback) 方法的委派。The ReferralCallback class contains delegates used as referral callback methods.

SearchOptionsControl

SearchOptionsControl 類別 (Class) 用於將旗標傳遞至伺服器,以控制搜尋行為。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 類別 (Class) 由伺服器傳送,做為對 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 類別 (Class) 用於將旗標傳遞至伺服器,以控制各種安全性描述元行為。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 類別 (Class) 與 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 類別 (Class) 儲存排序準則用於排序控制項。The SortKey class stores sort criteria for use by sort controls.

SortRequestControl

SortRequestControl 類別 (Class) 與 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 類別 (Class) 用於將排序資料從伺服器傳遞至用戶端。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 類別 (Class) 與 DeleteRequest 搭配使用,來刪除目錄中的整個樹狀子目錄。The TreeDeleteControl class is used with DeleteRequest to delete an entire subtree in the directory.

VerifyNameControl

VerifyNameControl 類別 (Class) 與 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 類別 (Class) 用於要求支援伺服器中的虛擬清單檢視 (Virtual List View,VLV)。The VlvRequestControl class is used to request virtual list view (VLV) support from the server.

VlvResponseControl

VlvResponseControl 類別 (Class) 用於將虛擬清單檢視 (VLV) 資料從伺服器傳遞至用戶端。The VlvResponseControl class is used to pass virtual list view (VLV) data from the server to the client.

列舉

AuthType

AuthType 列舉型別 (Enumeration) 用於指定對連接所用的驗證 (Authentication) 方法。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 列舉型別 (Enumeration) 指定 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 列舉型別 (Enumeration) 包含可能的 DSML 錯誤回應。The ErrorResponseCategory enumeration contains possible DSML error responses.

ExtendedDNFlag

ExtendedDNFlag 列舉型別 (Enumeration) 指定擴充辨別名稱的格式。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 列舉型別 (Enumeration) 指定轉介追趕是否進行和如何進行。The ReferralChasingOptions enumeration specifies if and how referral chasing is pursued.

ResultCode

ResultCode 列舉型別 (Enumeration) 指定作業結果碼。The ResultCode enumeration specifies the operation result codes.

SearchOption

SearchOption 列舉型別 (Enumeration),指定在定義搜尋表現方式的搜尋選項。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 列舉型別會指定各種安全性描述元 (Security Descriptor) 選項。The SecurityMasks enumeration specifies various security descriptor options.

SecurityProtocol

SecurityProtocol 列舉型別 (Enumeration) 用於指定連接所使用的安全性通訊協定。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 委派會取得或設定預設回呼 (Callback) 函式,用於在建立 SSL 連接時指定用戶端憑證。The QueryClientCertificateCallback delegate gets or sets the default callback function used to specify the client certificates while establishing an SSL connection.

QueryForConnectionCallback

QueryForConnectionCallback 委派 (Delegate) 可以判斷是否有可用的快取連接。The QueryForConnectionCallback delegate determines whether there is a cached connection available for use.

VerifyServerCertificateCallback

VerifyServerCertificateCallback 委派 (Delegate) 可以取得或設定預設回呼函式,用於在建立 SSL 連接時驗證伺服器憑證。The VerifyServerCertificateCallback delegate gets or sets the default callback function used to verify server certificates when establishing an SSL connection.