• Article

Application.SaveToSqlServerAs Method

Saves a package to an instance of SQL Server with a new name.

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

Syntax

'Declaration
Public Sub SaveToSqlServerAs ( _
    package As Package, _
    events As IDTSEvents, _
    packagePath As String, _
    serverName As String, _
    serverUserName As String, _
    serverPassword As String _
)
'Usage
Dim instance As Application
Dim package As Package
Dim events As IDTSEvents
Dim packagePath As String
Dim serverName As String
Dim serverUserName As String
Dim serverPassword As String

instance.SaveToSqlServerAs(package, events, _
    packagePath, serverName, serverUserName, _
    serverPassword)

public void SaveToSqlServerAs(
    Package package,
    IDTSEvents events,
    string packagePath,
    string serverName,
    string serverUserName,
    string serverPassword
)

public:
void SaveToSqlServerAs(
    Package^ package, 
    IDTSEvents^ events, 
    String^ packagePath, 
    String^ serverName, 
    String^ serverUserName, 
    String^ serverPassword
)

member SaveToSqlServerAs : 
        package:Package * 
        events:IDTSEvents * 
        packagePath:string * 
        serverName:string * 
        serverUserName:string * 
        serverPassword:string -> unit 

public function SaveToSqlServerAs(
    package : Package, 
    events : IDTSEvents, 
    packagePath : String, 
    serverName : String, 
    serverUserName : String, 
    serverPassword : String
)

Parameters

  • packagePath
    Type: System.String
    The path and new name to assign to the package. The parameter packagePath is in the format of \\folder\\packageName. If packagePath is specified without an existing folder, the package will be saved with this parameter as its new name.
  • serverName
    Type: System.String
    The name of the instance of SQL Server.
  • serverUserName
    Type: System.String
    The SQL Server login name if you use SQL Server Authentication to log into the server; otherwise, nulla null reference (Nothing in Visual Basic) if you use Windows Authentication.
  • serverPassword
    Type: System.String
    The SQL Server login password if you use SQL Server Authentication to log into the server; otherwise, nulla null reference (Nothing in Visual Basic) if you use Windows Authentication.

Examples

The following code example saves the sample package named ExecuteProcess.dtsx to the msdb folder, with a new name of myNewPackage. To verify that the package was saved, run the following Transact-SQL query against the msdb database. The query returns all packages stored in the msdb system table.

select * from sysssispackages

Or, connect to the Integration Services service, expand Stored Packages, and then expand MSDB. The package with the name specified in packagePath will be listed.

static void Main(string[] args)
        {
           // The variable pkg points to the location
           // of the ExecuteProcess package sample 
           // that is installed with the SSIS samples.
            string pkg = @"C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\Package Samples\ExecuteProcess Sample\ExecuteProcess\UsingExecuteProcess.dtsx";
            
            Application app = new Application();
            Package p = app.LoadPackage(pkg, null);

           // Save the package to the SQL Server msdb folder, which is
           // also the MSDB folder in the Integration Services service, or as a row in the
           //sysssispackages table.
            app.SaveToSqlServerAs(p, null, "myNewPackage", "yourserver", null, null);
        }

Shared  Sub Main(ByVal args() As String)
           ' The variable pkg points to the location
           ' of the ExecuteProcess package sample 
           ' that is installed with the SSIS samples.
            Dim pkg As String =  "C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\Package Samples\ExecuteProcess Sample\ExecuteProcess\UsingExecuteProcess.dtsx" 
 
            Dim app As Application =  New Application() 
            Dim p As Package =  app.LoadPackage(pkg,Nothing) 
 
           ' Save the package to the SQL Server msdb folder, which is
           ' also the MSDB folder in the Integration Services service, or as a row in the
           'sysssispackages table.
            app.SaveToSqlServerAs(p, Nothing, "myNewPackage", "yourserver", Nothing, Nothing)
End Sub