Microsoft Identity Integration Server 2003 Developer Reference

ConnectorCollection

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 has 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.

Protected Constructors

The ConnectorCollection class has the following protected constructor.

Constructor	Description
ConnectorCollection	Creates an instance of the ConnectorCollection class.

Example Code [Visual Basic .NET]

The following example shows how to use Visual Basic .NET 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

Example Code [C#]

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: Microsoft Identity Integration Server 2003
Namespace: Defined in Microsoft.MetadirectoryServices.
Assembly: Requires Microsoft.MetadirectoryServices (in Microsoft.MetadirectoryServices.dll).
.NET Framework: Requires .NET Framework 1.1.