Dodawanie połączenia programowe

The ConnectionManager class represents physical connections to external data sources.The ConnectionManager class isolates the implementation details of the connection from the runtime.Umożliwia to w czasie wykonywania na interakcję z każdego menedżer połączeń w sposób jednorodny i przewidywalny.Menedżerowie połączenia zawiera zestaw właściwości zapasów, zawierające wszystkie połączenia w wspólnego, takich jak Name(), ID(), Description(), a ConnectionString(). Jednak ConnectionString() i Name() właściwości są zwykle tylko właściwości wymaganych do skonfigurowania menedżer połączeń. W odróżnieniu od innych paradygmat programowania, w których połączenia klas narazić metody takie jak Open lub Connect fizycznie ustanowić połączenie ze źródłem danych, aparat wykonywania zarządza wszystkie połączenia dla tego pakiet podczas jego działania.

The Connections class is a kolekcja of the connection managers that have been added to that pakiet and are available for use at run czas. Do kolekcja można dodać więcej menedżerów połączenia przy użyciu Add(String) metoda zbierania i dostarczania ciąg, który wskazuje typ menedżer połączeń. The Add(String) metoda returns the ConnectionManager wystąpienie that was added to the pakiet.

Właściwości wewnętrzne

The ConnectionManager class exposes a zestaw of properties that are common to all connections. Jednak czasami potrzebny jest dostęp do właściwości, które są unikatowe dla typu określonego połączenia.The Properties() kolekcja of the ConnectionManager class provides access to these properties. właściwość mogą być pobierane z kolekcja, używając nazwy właściwość lub indeksatorze oraz GetValue metoda i wartości są zestaw przy użyciu zestaw Wartość metoda.Pobieranie rzeczywistego wystąpienie obiektu i bezpośrednio ustawiając właściwości można również ustawić właściwości podstawowe właściwości obiektu połączenia.Aby uzyskać podstawowe połączenia, należy użyć InnerObject() właściwość menedżer połączeń. Poniższy wiersz kodu wyświetlany jest wiersz C#, tworzący ADO.NET, Menedżer połączeń, zawierający klasy podstawowej ConnectionManagerAdoNetClass.

ConnectionManagerAdoNetClass cmado = cm.InnerObject as ConnectionManagerAdoNet;

To rzutowana obiektu Menedżera połączenia zarządzanych do jego podstawowej obiekt połączenia.W przypadku korzystania z języka C++, QueryInterface Metoda ConnectionManager obiekt jest nazywany i żąda interfejs obiektu źródłowego połączenia.

The following table lists the connection managers included with Integration Services.and the string that is used in the package.Connections.Add("xxx") statement.Aby wyświetlić listę wszystkich menedżerów połączenia Zobacz Połączenia usług integracja.

String	Menedżer połączeń
"OLEDB"	Menedżer połączeń dla połączeń OLE DB.
"ODBC"	Menedżer połączeń dla połączeń ODBC.
"ADO"	Menedżer połączeń dla połączenia ADO.
"ADO.NET:SQL"	Menedżer połączeń dla połączeń ADO.NET (Dostawca danych SQL).
"ADO.NET:OLEDB"	Menedżer połączeń dla połączeń ADO.NET (Dostawca danych OLE DB).
"FLATFILE"	Menedżer połączeń dla połączeń plik prosty.
"PLIK"	Menedżer połączeń do pliku połączenia.
"MULTIFLATFILE"	Menedżer połączeń dla wielu połączeń plik prosty.
"MULTIFILE"	Menedżer połączeń dla wielu połączeń pliku.
"SQLMOBILE"	Menedżer połączeń SQL Server Compact połączenia.
"MSOLAP100"	Menedżer połączeń Analysis Services połączenia.
"USŁUGI FTP. „	Menedżer połączeń dla połączeń FTP.
"HTTP"	Menedżer połączeń dla połączeń HTTP.
"usługa MSMQ"	Połączenia menedżer połączeń kolejkowanie wiadomości (usługa MSMQ).
"SMTP „	Menedżer połączeń dla połączeń SMTP.
„ WMI „	Menedżer połączeń Microsoft Instrumentacja zarządzania Windows (WMI) połączeń.

Poniższy przykład kodu ilustruje dodanie połączenie OLE DB i FILE Connections() Kolekcja Package. W przykładzie ustawiany jest następnie ConnectionString(), Name(), a Description() właściwości.

using System;
using Microsoft.SqlServer.Dts.Runtime;

namespace Microsoft.SqlServer.Dts.Samples
{
  class Program
  {
    static void Main(string[] args)
    {
      // Create a package, and retrieve its connections.
      Package pkg = new Package();
      Connections pkgConns = pkg.Connections;

      // Add an OLE DB connection to the package, using the 
      // method defined in the AddConnection class.
      CreateConnection myOLEDBConn = new CreateConnection();
      myOLEDBConn.CreateOLEDBConnection(pkg);

      // View the new connection in the package.
      Console.WriteLine("Connection description: {0}",
         pkg.Connections["SSIS Connection Manager for OLE DB"].Description);

      // Add a second connection to the package.
      CreateConnection myFileConn = new CreateConnection();
      myFileConn.CreateFileConnection(pkg);

      // View the second connection in the package.
      Console.WriteLine("Connection description: {0}",
        pkg.Connections["SSIS Connection Manager for Files"].Description);

      Console.WriteLine();
      Console.WriteLine("Number of connections in package: {0}", pkg.Connections.Count);

      Console.Read();
    }
  }
  // <summary>
  // This class contains the definitions for multiple
  // connection managers.
  // </summary>
  public class CreateConnection
  {
    // Private data.
    private ConnectionManager ConMgr;

    // Class definition for OLE DB Provider.
    public void CreateOLEDBConnection(Package p)
    {
      ConMgr = p.Connections.Add("OLEDB");
      ConMgr.ConnectionString = "Provider=SQLOLEDB.1;" +
        "Integrated Security=SSPI;Initial Catalog=AdventureWorks;" +
        "Data Source=(local);";
      ConMgr.Name = "SSIS Connection Manager for OLE DB";
      ConMgr.Description = "OLE DB connection to the AdventureWorks database.";
    }
    public void CreateFileConnection(Package p)
    {
      ConMgr = p.Connections.Add("File");
      ConMgr.ConnectionString = @"\\<yourserver>\<yourfolder>\books.xml";
      ConMgr.Name = "SSIS Connection Manager for Files";
      ConMgr.Description = "Flat File connection";
    }
  }

}

Imports Microsoft.SqlServer.Dts.Runtime

Module Module1

  Sub Main()

    ' Create a package, and retrieve its connections.
    Dim pkg As New Package()
    Dim pkgConns As Connections = pkg.Connections

    ' Add an OLE DB connection to the package, using the 
    ' method defined in the AddConnection class.
    Dim myOLEDBConn As New CreateConnection()
    myOLEDBConn.CreateOLEDBConnection(pkg)

    ' View the new connection in the package.
    Console.WriteLine("Connection description: {0}", _
      pkg.Connections("SSIS Connection Manager for OLE DB").Description)

    ' Add a second connection to the package.
    Dim myFileConn As New CreateConnection()
    myFileConn.CreateFileConnection(pkg)

    ' View the second connection in the package.
    Console.WriteLine("Connection description: {0}", _
      pkg.Connections("SSIS Connection Manager for Files").Description)

    Console.WriteLine()
    Console.WriteLine("Number of connections in package: {0}", pkg.Connections.Count)

    Console.Read()

  End Sub

End Module

' This class contains the definitions for multiple
' connection managers.

Public Class CreateConnection
  ' Private data.
  Private ConMgr As ConnectionManager

  ' Class definition for OLE DB provider.
  Public Sub CreateOLEDBConnection(ByVal p As Package)
    ConMgr = p.Connections.Add("OLEDB")
    ConMgr.ConnectionString = "Provider=SQLOLEDB.1;" & _
      "Integrated Security=SSPI;Initial Catalog=AdventureWorks;" & _
      "Data Source=(local);"
    ConMgr.Name = "SSIS Connection Manager for OLE DB"
    ConMgr.Description = "OLE DB connection to the AdventureWorks database."
  End Sub

  Public Sub CreateFileConnection(ByVal p As Package)
    ConMgr = p.Connections.Add("File")
    ConMgr.ConnectionString = "\\<yourserver>\<yourfolder>\books.xml"
    ConMgr.Name = "SSIS Connection Manager for Files"
    ConMgr.Description = "Flat File connection"
  End Sub

End Class

Przykładowe dane wyjściowe:

Opis połączenia: Połączenie OLE DB do bazy danych AdventureWorks.

Opis połączenia: Połączenie OLE DB do bazy danych AdventureWorks.

Liczba połączeń w pakiet: 2

Konfiguracja w aktualizacji z usług integracja Services pobytu Najnowsze pliki do pobrania, artykuły, próbki, i pliki wideo firmy Microsoft, jak również wybranego rozwiązania od Wspólnoty, odwiedź witrynę Integration Services strona w witrynie MSDN lub TechNet: Odwiedź strona usług integracja Services w witrynie MSDN Odwiedź strona usług integracja Services w witrynie TechNet Automatycznego powiadomienie tych aktualizacji należy subskrybować źródła danych RSS, które jest dostępne strona.

See Also

Other Resources

Połączenia usług integracja

Creating Connection Managers