Connections.Item[Object] Eigenschaft

Referenz

Definition

Namespace:: Microsoft.SqlServer.Dts.Runtime

Assembly:: Microsoft.SqlServer.ManagedDTS.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft ein ConnectionManager-Objekt aus der Connections-Auflistung ab.

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

Parameter

index: Object

Der Name oder Index bzw. die Identität oder ID des ConnectionManager-Objekts, das zurückgegeben werden soll.

Eigenschaftswert

ConnectionManager

Ein ConnectionManager-Objekt aus der Auflistung.

Beispiele

Im folgenden Codebeispiel wird ein Element aus der Auflistung mit zwei Methoden abgerufen. Die erste Methode verwendet die conns[0] Syntax, um das gesamte Objekt abzurufen, das sich an der ersten Position der Auflistung befindet, und es in die myConnMgr Variable einzufügen. Sie können jetzt alle Eigenschaften wie myConnMgr gewohnt abrufen. Die zweite Methode ruft eine bestimmte Eigenschaft aus dem ersten Objekt in der Auflistung mithilfe der conns[0].<property> Syntax ab.

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

Beispielausgabe:

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

Hinweise

Wenn der Aufruf der Contains Methode zurückgegeben wird true, können Sie mithilfe der Syntax Connections[index]auf das angegebene Element in der Auflistung zugreifen. Wenn die Contains Methode zurückgegeben wird, löst falsediese Eigenschaft eine Ausnahme aus. In C# ist diese Eigenschaft der Indexer für die Connections-Klasse.

Gilt für:

Freigeben über