Item Property
Collapse the table of content
Expand the table of content

Connections.Item Property

Returns a ConnectionManager object from the Connections collection.

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

public ConnectionManager this [
	Object index
] { get; }
/** @property */
public ConnectionManager get_Item (Object index)

Parameters

index

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

Property Value

A ConnectionManager object.

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


The following code sample retrieves an item from the collection using two methods. The first method uses the conns[0] syntax to retrieve the whole object located in the first position of the collection and put it in the myConnMgr variable. You can now retrieve all properties from the myConnMgr as usual. The second method retrieves a specific property from the first object in the collection using the conns[0].<property> syntax.

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

namespace Connections_Item
{
    class Program
    {
        static void Main(string[] args)
        {
            // The package is one of the SSIS Samples.
            string mySample = @"C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Package Samples\ExecuteProcess Sample\ExecuteProcess\UsingExecuteProcess.dtsx";

            // Create an application and load the sample.
            Application app = new Application();
            Package pkg = app.LoadPackage(mySample, null);
            Connections conns = pkg.Connections;

            //Using the Item method syntax of [x], obtain the
            // entire first entry, and then just the name.
            ConnectionManager myConnMgr = conns[0];
            String nameOfFirstItem = conns[0].Name;

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

Sample Output:

The ID of the first connection info is: {B52C0D78-5402-4544-BFEC-2BE203900C91}

The Name of the first connection info is: Create_Execute_Process_Dest.sql

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.

Development Platforms

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

Target Platforms

Community Additions

ADD
Show:
© 2016 Microsoft