The System.DirectoryServices.Protocols namespace has three top level classes:
The DirectoryConnection class provides a way to transport either the DsmlDocument or the DirectoryOperation object. The DsmlDocument class is used to send batched DirectoryOperation requests. The DirectoryOperation class contains single operation requests.
In addition to this conceptual documentation, the Introduction to System.DirectoryServices.Protocols whitepaper on the MSDN Library explains concepts, practices, and guidelines for programming with the SDS.Protocols API.
The following sections identify the architecture of the top level System.DirectoryServices.Protocols classes.
The DirectoryConnection class is the base class for DSML bindings and LDAP TCP/IP or UDP connections. All classes derived from the DirectoryConnection class support taking a single DirectoryRequest object and returning the resulting DirectoryResponse object. Derived classes specific to DSML also support taking a DsmlRequestDocument object and returning the resulting DsmlResponseDocument object, in order to support the DSML batching capability.
There are two types of DsmlDocument objects:
There are two types of DirectoryOperation objects:
The DirectoryRequest class is the base class for request related classes, like the AddRequest, DeleteRequest, ModifyRequest, and SearchRequest classes.
The DirectoryResponse class is the base class for request response classes, like the AddResponse, DeleteResponse, ModifyResponse and SearchResponse classes.
Copyright © 2008 by Microsoft Corporation. All rights reserved.