ConnectionManager.ConnectionString Eigenschaft

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.

Erhält oder setzt die Verbindungszeichenfolge, die zur Herstellung einer Verbindung zu einer Datenquelle verwendet wird.

public:
 property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };

[Microsoft.SqlServer.Dts.Runtime.Localization.LocalizablePropertyDescription(typeof(Microsoft.SqlServer.Dts.Runtime.Localized), "ConnectionStringDesc")]
[System.ComponentModel.RefreshProperties(System.ComponentModel.RefreshProperties.All)]
public string ConnectionString { get; set; }

[<Microsoft.SqlServer.Dts.Runtime.Localization.LocalizablePropertyDescription(typeof(Microsoft.SqlServer.Dts.Runtime.Localized), "ConnectionStringDesc")>]
[<System.ComponentModel.RefreshProperties(System.ComponentModel.RefreshProperties.All)>]
member this.ConnectionString : string with get, set

Public Property ConnectionString As String

Eigenschaftswert

String

Ein String, der den Wert der Verbindungszeichenfolge enthält.

Attribute: LocalizablePropertyDescriptionAttribute RefreshPropertiesAttribute

Beispiele

Das folgende Codebeispiel erzeugt ein FileSystemTask als ein Executable in einem Paket. Sie FileSystemTask kopiert einen Testordner, der zwei Unterordner und eine .txt Datei enthält, in einen anderen Ordner. Quell- und Zielverzeichnisse sind vorhandene Ordner. Daher werden die IsDestinationPathVariable und IsSourcePathVariable auf falsegesetzt, und die und-Eigenschaften Source werden so gesetzt, dass sie Destination auf zwei FILE-Verbindungsmanager verweisen, die erstellt wurden und deren Verbindungszeichenketten auf Referenzen Strings mit den Pfaden gesetzt wurden.

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

namespace FileSystemTask_API  
{  
    class Program  
    {  
        static void Main(string[] args)  
        {  
            String sourceDir = @"C:\TestFolder";  
            String destDir = @"C:\MyNewTestFolder";  

            Package pkg = new Package();  
            Executable exec1 = pkg.Executables.Add("STOCK:FileSystemTask");  
            TaskHost th = exec1 as TaskHost;  

            // Show how to set properties using the TaskHost  
             // Properties. Set the properties to copy an existing  
             // folder, which contains two subfolders and a .txt file,  
            // to another existing folder on the C:\ drive.  

            // The source or destination files are not in a variable,  
            // so set IsSourcePathVariable and   
            // IsDestinationPathVariable to false.  
            th.Properties["IsSourcePathVariable"].SetValue(th, false);  
            th.Properties["IsDestinationPathVariable"].SetValue(th, false);  

            // Create the File connection manager for the source.  
            ConnectionManager cm = pkg.Connections.Add("FILE");  
            cm.Name = "The FILE connection manager";  
            cm.ConnectionString = sourceDir;  
            cm.Properties["FileUsageType"].SetValue(cm, DTSFileConnectionUsageType.FolderExists);  

            // Create the File connection manager for the destination.  
            ConnectionManager cmdest = pkg.Connections.Add("FILE");  
            cmdest.Name = "The destination FILE connection manager";  
            cmdest.ConnectionString = destDir;  
            cmdest.Properties["FileUsageType"].SetValue(cmdest, DTSFileConnectionUsageType.FolderExists);  

            // Set the source property and destination properties  
            // for the task.  
            th.Properties["Source"].SetValue(th, cm.Name);  
            th.Properties["Destination"].SetValue(th, cmdest.Name);  

            // The operation to perform is to copy all the files and  
             // subfolders in a folder.  
            // Do not overwrite the destination information   
            // if it exists.  
            th.Properties["Operation"].SetValue(th, DTSFileSystemOperation.CopyDirectory);  
            th.Properties["OperationName"].SetValue(th, "Copy TestFolder");  
            th.Properties["OverwriteDestinationFile"].SetValue(th, false);  

            // Set the attribute of the folder to be read-only.  
            th.Properties["Attributes"].SetValue(th, DTSFileSystemAttributes.ReadOnly);  
            // Multiple attributes can be set. The next line of code,  
            // commented out, shows how to do that.  
            //th.Properties["Attributes"].SetValue(th, DTSFileSystemAttributes.ReadOnly | DTSFileSystemAttributes.Hidden);  

            // Run the task and copy the folder.  
            DTSExecResult result = pkg.Execute();  
        }  
    }  
}

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

Namespace FileSystemTask_API  
    Class Program  
        Shared  Sub Main(ByVal args() As String)  
            Dim sourceDir As String =  "C:\TestFolder"   
            Dim destDir As String =  "C:\MyNewTestFolder"   

            Dim pkg As Package =  New Package()   
            Dim exec1 As Executable =  pkg.Executables.Add("STOCK:FileSystemTask")   
            Dim th As TaskHost =  exec1 as TaskHost   

            ' Show how to set properties using the TaskHost Properties.  
            ' Set the properties to copy an existing folder, which contains two subfolders  
            ' and a .txt file, to another existing folder on the C:\ drive.  

            ' The source or destination files are not in a variable, so set   
            ' IsSourcePathVariable and IsDestinationPathVariable to false.  
            th.Properties("IsSourcePathVariable").SetValue(th, False)  
            th.Properties("IsDestinationPathVariable").SetValue(th, False)  

            ' Create the File connection manager for the source.  
            Dim cm As ConnectionManager =  pkg.Connections.Add("FILE")   
            cm.Name = "The FILE connection manager"  
            cm.ConnectionString = sourceDir  
            cm.Properties("FileUsageType").SetValue(cm, DTSFileConnectionUsageType.FolderExists)  

            ' Create the File connection manager for the destination.  
            Dim cmdest As ConnectionManager =  pkg.Connections.Add("FILE")   
            cmdest.Name = "The destination FILE connection manager"  
            cmdest.ConnectionString = destDir  
            cmdest.Properties("FileUsageType").SetValue(cmdest, DTSFileConnectionUsageType.FolderExists)  

            ' Set the source property and destination properties  
            ' for the task.  
            th.Properties("Source").SetValue(th, cm.Name)  
            th.Properties("Destination").SetValue(th, cmdest.Name)  

            ' The operation to perform is to copy all the files and  
             ' subfolders in a folder.  
            ' Do not overwrite the destination information   
            ' if it exists.  
            th.Properties("Operation").SetValue(th, DTSFileSystemOperation.CopyDirectory)  
            th.Properties("OperationName").SetValue(th, "Copy TestFolder")  
            th.Properties("OverwriteDestinationFile").SetValue(th, False)  

            ' Set the attribute of the folder to be read-only.  
            th.Properties("Attributes").SetValue(th, DTSFileSystemAttributes.ReadOnly)  
            ' Multiple attributes can be set. The next line of code,  
            ' commented out, shows how to do that.  
            'th.Properties["Attributes"].SetValue(th, DTSFileSystemAttributes.ReadOnly | DTSFileSystemAttributes.Hidden);  

            ' Run the task and copy the folder.  
            Dim result As DTSExecResult =  pkg.Execute()   
        End Sub  
    End Class  
End Namespace

Hinweise

Das Format und der Inhalt der Verbindungszeichenfolge hängen vom Datenanbieter, der Datenquelle und der Art des zu erstellenden Verbindungsmanagers ab. Um eine Beispiel-Verbindungszeichenfolge anzuzeigen, erstellen Sie in SQL Server Data Tools ein Paket und erstellen dann einen Connection Manager des entsprechenden Typs innerhalb dieses Pakets. Als Nächstes prüfen Sie im Eigenschaftenfenster die ConnectionString Eigenschaft des gerade erstellten Verbindungsmanagers.

Das folgende Codebeispiel fügt einen OLE DB Connection Manager hinzu und legt dann den Namen des Connection Managers und die Eigenschaften des Verbindungszeichenfolge fest.

// Add the OLE DB connection manager.  
ConnectionManager adventureWorks = package.Connections.Add("OLEDB");  
// Set stock properties.  
adventureWorks.Name = "OLEDBConnection";  
adventureWorks.ConnectionString = @"Provider=SQLNCLI10;Integrated Security=SSPI;Persist Security Info=False;Initial Catalog=AdventureWorks;Data Source=(local);Auto Translate=False;";

' Add the OLE DB connection manager.  
Dim adventureWorks As ConnectionManager =  package.Connections.Add("OLEDB")   
' Set stock properties.  
adventureWorks.Name = "OLEDBConnection"  
adventureWorks.ConnectionString = "Provider=SQLNCLI10;Integrated Security=SSPI;Persist Security Info=False;Initial Catalog=AdventureWorks;Data Source=(local);Auto Translate=False;"

Für einen XML-Verbindungszeichenfolge wird der Verbindungszeichenfolge-Wert ähnlich wie folgt formatiert:

String myConnString = @"C:\Program Files\Microsoft SQL Server\orders.xml";

Während bei einer OLE-Datenbankverbindung der Verbindungszeichenfolge Werte enthält, die dem folgenden Verbindungszeichenfolge ähneln:

String myConnString = "Server=MYSERVER;Provider=SQLOLEDB.1;Pwd= xxxxxxx;User ID= xxxxx;Initial Catalog=mySource;OLE DB Services=-2";

Und ein ODBC-Verbindungszeichenfolge kann ähnlich aussehen wie folgt:

String myConnString = "DSN=LocalServer;DATABASE=MySource;PWD=xxxxxxx;UID=xxxxx";

Im Eigenschaftsdialogfeld einer Verbindung im SSIS-Designer erscheint dieser Wert als Eigenschaft Connection String .

Eine Liste aller mit dem Produkt enthaltenen Verbindungsmanager finden Sie unter Integration Services (SSIS) Connections.

Gilt für: