以程式設計方式建立封裝
Package 物件是 SSIS 專案方案中所有其他物件的最上層容器。做為最上層容器，封裝是第一個建立的物件，而且後續的物件會加入其中，然後在封裝的內容中執行。封裝本身不會移動或是轉換資料。封裝依賴它所含的工作 (Task) 以執行工作 (Work)。工作 (Task) 會執行封裝所執行的大部分工作 (Work)，並定義封裝的功能。只需要三行程式碼就可以建立和執行封裝，但是還需要將各種工作與 ConnectionManager 物件加入，以便為您的封裝提供其他功能。本節討論如何以程式設計方式建立封裝。有關如何建立工作或 ConnectionManager 的詳細資訊並非在此提供，這些內容將於後續章節說明。
範例
若要使用 Visual Studio IDE 撰寫程式碼，會需要 Microsoft.SqlServer.ManagedDTS.DLL 的參考，才能建立 Microsoft.SqlServer.Dts.Runtime 的 using 陳述式 (在 Visual Basic .NET 中則是 Imports)。下列程式碼範例示範建立空的封裝。
using System;
using Microsoft.SqlServer.Dts.Runtime;
namespace Microsoft.SqlServer.Dts.Samples
{
class Program
{
static void Main(string[] args)
{
Package package;
package = new Package();
}
}
}
Imports Microsoft.SqlServer.Dts.Runtime
Module Module1
Sub Main()
Dim package As Package
package = New Package
End Sub
End Module
若要編譯和執行範例，請在 Visual Studio 中按 F5。若要使用 C# 編譯器 csc.exe 建置程式碼，請在要編譯的命令提示字元之下，使用下列命令與檔案參考，以 .cs 或 .vb 檔案的名稱來取代 <filename>，並提供您所選的 <outputfilename>。
csc /target:library /out: <outputfilename>.dll <filename>.cs /r:Microsoft.SqlServer.Managed DTS.dll" /r:System.dll
若要使用 Visual Basic .NET 編譯器 vbc.exe 建置程式碼，請在要編譯的命令提示字元之下，使用下列命令與檔案參考。
vbc /target:library /out: <outputfilename>.dll <filename>.vb /r:Microsoft.SqlServer.Managed DTS.dll" /r:System.dll
您也可以載入儲存在磁碟上、在檔案系統或是儲存到 SQL Server 的現有封裝以建立封裝。其差異在於會先建立 Application 物件，然後其中一個應用程式的多載方法會填入封裝物件：LoadPackage 用於一般檔案、LoadFromSQLServer 用於儲存到 SQL Server 的封裝，或是 LoadFromDtsServer 用於儲存到檔案系統的封裝。下列範例會從磁碟載入現有封裝，然後檢視封裝上的數個屬性。
using System;
using Microsoft.SqlServer.Dts.Runtime;
namespace Microsoft.SqlServer.Dts.Samples
{
class ApplicationTests
{
static void Main(string[] args)
{
// The variable pkg points to the location of the
// ExecuteProcess package sample that was 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);
// Now that the package is loaded, we can query on
// its properties.
int n = p.Configurations.Count;
DtsProperty p2 = p.Properties["VersionGUID"];
DTSProtectionLevel pl = p.ProtectionLevel;
Console.WriteLine("Number of configurations = " + n.ToString());
Console.WriteLine("VersionGUID = " + (string)p2.GetValue(p));
Console.WriteLine("ProtectionLevel = " + pl.ToString());
Console.Read();
}
}
}
Imports Microsoft.SqlServer.Dts.Runtime
Module ApplicationTests
Sub Main()
' The variable pkg points to the location of the
' ExecuteProcess package sample that was 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)
' Now that the package is loaded, we can query on
' its properties.
Dim n As Integer = p.Configurations.Count
Dim p2 As DtsProperty = p.Properties("VersionGUID")
Dim pl As DTSProtectionLevel = p.ProtectionLevel
Console.WriteLine("Number of configurations = " & n.ToString())
Console.WriteLine("VersionGUID = " & CType(p2.GetValue(p), String))
Console.WriteLine("ProtectionLevel = " & pl.ToString())
Console.Read()
End Sub
End Module
範例輸出：
Number of configurations = 2
VersionGUID = {09016682-89B8-4406-AAC9-AF1E527FF50F}
ProtectionLevel = DontSaveSensitive
|
.gif "Integration Services 圖示 (小)")
掌握 Integration Services 的最新狀態