Share via


ConnectionInfos.Item[Object] Property

Definition

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

public:
 property Microsoft::SqlServer::Dts::Runtime::ConnectionInfo ^ default[System::Object ^] { Microsoft::SqlServer::Dts::Runtime::ConnectionInfo ^ get(System::Object ^ index); };
public Microsoft.SqlServer.Dts.Runtime.ConnectionInfo this[object index] { get; }
member this.Item(obj) : Microsoft.SqlServer.Dts.Runtime.ConnectionInfo
Default Public ReadOnly Property Item(index As Object) As ConnectionInfo

Parameters

index
Object

The name, index, ID, or identity of the object in the collection to return.

Property Value

A ConnectionInfo object from the collection that matches the name, index, ID, or identity given in the index parameter.

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

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.

Applies to