ConnectionInfos.Item Property

Retrieves the ConnectionInfo object from the collection by the name, index, ID, or identity.

Namespace:  Microsoft.SqlServer.Dts.Runtime
Assembly:  Microsoft.SqlServer.ManagedDTS (in Microsoft.SqlServer.ManagedDTS.dll)

Syntax

'Declaration
Public ReadOnly Default Property Item ( _
    index As Object _
) As ConnectionInfo
    Get
'Usage
Dim instance As ConnectionInfos
Dim index As Object
Dim value As ConnectionInfo

value = instance(index)
public ConnectionInfo this[
    Object index
] { get; }
public:
property ConnectionInfo^ default[Object^ index] {
    ConnectionInfo^ get (Object^ index);
}
member Item : ConnectionInfo
JScript supports the use of indexed properties, but not the declaration of new ones.

Parameters

  • index
    Type: System.Object
    The name, index, ID, or identity of the object in the collection to return.

Property Value

Type: Microsoft.SqlServer.Dts.Runtime.ConnectionInfo
A ConnectionInfo object from the collection that matches the name, index, ID, or identity given in the index parameter.

Remarks

If a call to the Contains method returns true, you can access the specified element in the collection by using the syntax ConnectionInfos[index]. If the Contains method returns false, this property throws an exception. In C#, this property is the indexer for the ConnectionInfos class.

Examples

The following code example retrieves an item from the collection by using two methods. The first method uses the connectionInfos[0] syntax to retrieve the entire object, located in the first position of the collection and then places it in the connInfo object. You can now retrieve all properties from the ConnectionInfo object as usual. The second method retrieves a specific property from the first object in the collection.

using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.SqlServer.Dts.Runtime;

namespace ConnectionInfos_GetEnum
{
    class Program
    {
        static void Main(string[] args)
        {
            Application dtsApplication = new Application();
            ConnectionInfos connectionInfos = dtsApplication.ConnectionInfos;

            //Using the Item method syntax of [x], obtain the first entry and a name.
            ConnectionInfo connInfo = connectionInfos[0];
            String nameOfFirstItem = connectionInfos[0].Name;

            //Print the name of the log provider object located at position [0].
            Console.WriteLine("The ID of the first connection info is: {0}", connInfo.ID);
            Console.WriteLine("The Name of the first connection info is: {0}", nameOfFirstItem);

        }
    }
}
Imports System
Imports System.Collections.Generic
Imports System.Text
Imports Microsoft.SqlServer.Dts.Runtime
 
Namespace ConnectionInfos_GetEnum
    Class Program
        Shared  Sub Main(ByVal args() As String)
            Dim dtsApplication As Application =  New Application() 
            Dim connectionInfos As ConnectionInfos =  dtsApplication.ConnectionInfos 
 
            'Using the Item method syntax of [x], obtain the first entry and a name.
            Dim connInfo As ConnectionInfo =  connectionInfos(0) 
            Dim nameOfFirstItem As String =  connectionInfos(0).Name 
 
            'Print the name of the log provider object located at position [0].
            Console.WriteLine("The ID of the first connection info is: {0}", connInfo.ID)
            Console.WriteLine("The Name of the first connection info is: {0}", nameOfFirstItem)
 
        End Sub
    End Class
End Namespace

Sample Output:

The ID of the first connection info is: {41F5EFE4-E91A-4EB0-BF10-D40FD48B3C03}

The Name of the first connection info is: DTS Connection Manager for Files