Connections.Item[Object] Propriedade

Definição

Namespace:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

Obtém um objeto ConnectionManager da coleção Connections.

public:
 property Microsoft::SqlServer::Dts::Runtime::ConnectionManager ^ default[System::Object ^] { Microsoft::SqlServer::Dts::Runtime::ConnectionManager ^ get(System::Object ^ index); };

public Microsoft.SqlServer.Dts.Runtime.ConnectionManager this[object index] { get; }

member this.Item(obj) : Microsoft.SqlServer.Dts.Runtime.ConnectionManager

Default Public ReadOnly Property Item(index As Object) As ConnectionManager

Parâmetros

index

Object

O nome, a identidade, a ID ou o índice do objeto ConnectionManager a ser retornado.

Valor da propriedade

ConnectionManager

Um objeto ConnectionManager da coleção.

Exemplos

O exemplo de código a seguir recupera um item da coleção usando dois métodos. O primeiro método usa a conns[0] sintaxe para recuperar todo o objeto localizado na primeira posição da coleção e colocá-lo na myConnMgr variável. Agora você pode recuperar todas as propriedades do myConnMgr normal. O segundo método recupera uma propriedade específica do primeiro objeto da coleção usando a conns[0].<property> sintaxe.

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\100\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);  
        }  
    }  
}  

Imports System  
Imports System.Collections.Generic  
Imports System.Text  
Imports Microsoft.SqlServer.Dts.Runtime  

Namespace Connections_Item  
    Class Program  
        Shared  Sub Main(ByVal args() As String)  
            ' The package is one of the SSIS Samples.  
            Dim mySample As String =  "C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\Package Samples\ExecuteProcess Sample\ExecuteProcess\UsingExecuteProcess.dtsx"   

            ' Create an application and load the sample.  
            Dim app As Application =  New Application()   
            Dim pkg As Package =  app.LoadPackage(mySample,Nothing)   
            Dim conns As Connections =  pkg.Connections   

            'Using the Item method syntax of [x], obtain the  
            ' entire first entry, and then just the name.  
            Dim myConnMgr As ConnectionManager =  conns(0)   
            Dim nameOfFirstItem As String =  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)  
        End Sub  
    End Class  
End Namespace  

Saída de exemplo:

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

Comentários

Se a chamada ao Contains método retornar true, você poderá acessar o elemento especificado na coleção usando a sintaxe Connections[index]. Se o Contains método retornar false, essa propriedade gerará uma exceção. Em C#, essa propriedade é o indexador da classe Connections.