ConnectorCollection

Article
02/16/2009

The ConnectorCollection class represents a collection of connector objects. Each connector object is represented by a CSEntry object. The collection object is retrieved from the ConnectedMA.Connectors property.

The ConnectorCollection class is derived from the IEnumerable class.

Public Methods

The ConnectorCollection class has the following public methods.

Method	Description
DeprovisionAll	Changes all connector CSEntry objects in the specified management agent to disconnector CSEntry objects.
Equals	Determines if two objects are equal.
GetEnumerator	Retrieves a ConnectorCollectionEnumerator object that allows enumeration of the members of the collection.
GetHashCode	Serves as a hash function for a particular type.
GetType	Retrieves the Type of the current object.
StartNewConnector(String)	Initiates the process of creating a connector of the specified object type.
StartNewConnector(String, String[])	Initiates the process of creating a connector of the specified object type from an array of object classes.
StartNewConnector(String, ValueCollection)	Initiates the process of creating a connector of the specified object type from a ValueCollection object.
ToString	Retrieves a String that represents the current object.

Public Properties

The ConnectorCollection class defines the following public properties.

Property	Description
ByDN	Data type: ConnectorCollectionByDN Access type: Read-only Retrieves a ConnectorCollectionByDN object that contains a collection of connector objects that can be indexed by distinguished name.
ByIndex	Data type: ConnectorCollectionByIndex Access type: Read-only Retrieves a ConnectorCollectionByIndex object that contains the collection of connector objects that can be indexed numerically.
Count	Data type: Int32 Access type: Read-only Retrieves the number of elements in the collection.

ByDN

Data type: ConnectorCollectionByDN
Access type: Read-only

Retrieves a ConnectorCollectionByDN object that contains a collection of connector objects that can be indexed by distinguished name.

ByIndex

Data type: ConnectorCollectionByIndex
Access type: Read-only

Retrieves a ConnectorCollectionByIndex object that contains the collection of connector objects that can be indexed numerically.

Count

Data type: Int32
Access type: Read-only

Retrieves the number of elements in the collection.

Protected Constructors

The ConnectorCollection class has the following protected constructor.

Constructor	Description
ConnectorCollection	Creates an instance of the ConnectorCollection class.

ConnectorCollection

Creates an instance of the ConnectorCollection class.

Examples

The following example shows how to use Visual Basic to implement the IMVSynchronization.Provision method with the ConnectorCollection class:

Public Sub Provision(ByVal mventry As MVEntry) _
    Implements IMVSynchronization.Provision

    Dim Container As String
    Dim RDN As String
    Dim DN As ReferenceValue
    Dim ma As ConnectedMA
    Dim entry As CSEntry

    ma = mventry.ConnectedMAs("Fabrikam AD MA")

    ' Create the new distinguished name
    Container = "CN=users,DC=fabrikam,DC=com"
    RDN = "CN=" & mventry("cn").Value
    DN = ma.EscapeDNComponent(RDN).Concat(Container)

    ' Start creating the new connector
    entry = ma.Connectors.StartNewConnector("user")

    ' Set the property to the new distinguished name
    entry.DN = DN

    ' Finish creating the new connector
    entry.CommitNewConnector()
End Sub

The following example shows how to use C# to implement the IMVSynchronization.Provision method with the ConnectorCollection class:

void IMVSynchronization.Provision(MVEntry mventry)
{
    string Container;
    string RDN;
    ReferenceValue DN;
    CSEntry entry;
    ConnectedMA ma = mventry.ConnectedMAs["Fabrikam AD MA"];

    // Create the distinguished name
    Container = "CN=users,DC=fabrikam,DC=com";
    RDN = "CN=" + mventry["cn"].Value;
    DN = ma.EscapeDNComponent(RDN).Concat(Container);
 
    // Start creating the new connector
    entry = ma.Connectors.StartNewConnector("user");

    // Set the property to the new distinguished name
    entry.DN = DN;

    // Finish creating the new connector
    entry.CommitNewConnector();
}

Requirements

Product	ILM 2007 FP1
Namespace	Microsoft.MetadirectoryServices
Assembly	Microsoft.MetadirectoryServices
.NET Framework	.NET Framework 2.0