Microsoft Identity Integration Server 2003 Developer Reference

ConnectorCollectionByDN.Item

The Item property retrieves the connector object with the specified distinguished name.

[C#]
public CSEntry this[
  ReferenceValue DN
] {get;}

[Visual Basic .NET]
Public ReadOnly Property Item( _
  ByVal DN As ReferenceValue _
) As CSEntry

Parameters

DN: Contains a ReferenceValue object that contains the distinguished name of the connector to retrieve.

Exceptions

Exception type	Condition
ArgumentNullException	The DN is null.
NoSuchObjectException	The connector is not present in the collection.

Example Code [Visual Basic .NET]

The following example demonstrates how to use this property:

Dim connMA As ConnectedMA
Dim connectorsByDN As ConnectorCollectionByDN
Dim dn As ReferenceValue
Dim connJeffSmith As CSEntry

connMA = mventry.ConnectedMAs("Fabrikam HR MA")
connectorsByDN = connMA.Connectors.ByDN
dn = connMA.CreateDN("CN=Jeff Smith,DC=fabrikam,DC=com")
connJeffSmith = connectorsByDN(dn)

Example Code [C#]

ConnectedMA connMA = mventry.ConnectedMAs["Fabrikam HR MA"];
ConnectorCollectionByDN connectorsByDN = connMA.Connectors.ByDN;
ReferenceValue dn = connMA.CreateDN("CN=Jeff Smith,DC=fabrikam,DC=com");
CSEntry connJeffSmith = connectorsByDN[dn];

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.