ConnectionInfos.Item Property

Artykuł
12/03/2008

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

public ConnectionInfo this [
    Object index
] { get; }

public:
property ConnectionInfo^ default [Object^] {
    ConnectionInfo^ get (Object^ index);
}

/** @property */
public ConnectionInfo get_Item (Object index)

Parameters

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

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.

Example

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

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms