Upgrade メソッド
1 つまたは複数の Integration Services パッケージを指定されたアップグレード元の場所から指定されたアップグレード先の場所にアップグレードします。
名前空間: Microsoft.SqlServer.Dts.Runtime
アセンブリ: Microsoft.SqlServer.ManagedDTS (Microsoft.SqlServer.ManagedDTS.dll)
構文
'宣言
Public Function Upgrade ( _
packages As IEnumerable(Of UpgradePackageInfo), _
source As StorageInfo, _
destination As StorageInfo, _
options As BatchUpgradeOptions, _
events As IDTSEvents _
) As UpgradeResult
'使用
Dim instance As Application
Dim packages As IEnumerable(Of UpgradePackageInfo)
Dim source As StorageInfo
Dim destination As StorageInfo
Dim options As BatchUpgradeOptions
Dim events As IDTSEvents
Dim returnValue As UpgradeResult
returnValue = instance.Upgrade(packages, _
source, destination, options, events)
public UpgradeResult Upgrade(
IEnumerable<UpgradePackageInfo> packages,
StorageInfo source,
StorageInfo destination,
BatchUpgradeOptions options,
IDTSEvents events
)
public:
UpgradeResult^ Upgrade(
IEnumerable<UpgradePackageInfo^>^ packages,
StorageInfo^ source,
StorageInfo^ destination,
BatchUpgradeOptions^ options,
IDTSEvents^ events
)
member Upgrade :
packages:IEnumerable<UpgradePackageInfo> *
source:StorageInfo *
destination:StorageInfo *
options:BatchUpgradeOptions *
events:IDTSEvents -> UpgradeResult
public function Upgrade(
packages : IEnumerable<UpgradePackageInfo>,
source : StorageInfo,
destination : StorageInfo,
options : BatchUpgradeOptions,
events : IDTSEvents
) : UpgradeResult
パラメーター
- packages
型: System.Collections.Generic. . :: . .IEnumerable< (Of < ( <'UpgradePackageInfo> ) > ) >
アップグレードするパッケージのコレクション。
- source
型: Microsoft.SqlServer.Dts.Runtime. . :: . .StorageInfo
アップグレードするパッケージのアップグレード元の場所を示す StorageInfo オブジェクト。
- destination
型: Microsoft.SqlServer.Dts.Runtime. . :: . .StorageInfo
アップグレードするパッケージのアップグレード先の場所を示す StorageInfo オブジェクト。
- options
型: Microsoft.SqlServer.Dts.Runtime. . :: . .BatchUpgradeOptions
アップグレード処理中にパッケージに適用されるオプションを示す BatchUpgradeOptions オブジェクト。
- events
型: Microsoft.SqlServer.Dts.Runtime. . :: . .IDTSEvents
IDTSEvents オブジェクトです。
戻り値
型: Microsoft.SqlServer.Dts.Runtime. . :: . .UpgradeResult
1 つまたは複数のパッケージをアップグレードした結果を示す UpgradeResult オブジェクト。
使用例
パッケージのコレクションをアップグレードする方法を次の例に示します。元のパッケージとアップグレード パッケージは、ファイル システム内のフォルダーに格納されます。
using System;
using System.Collections.Generic;
using System.Collections.ObjectModel;
using System.Text;
using Microsoft.SqlServer.Dts.Runtime;
namespace ConsoleApplication1
{
class Program
{
static void Main(string[] args)
{
Application app = new Application();
UpgradePackageInfo packinfo1 = new UpgradePackageInfo("C:\\temp\\Package.dtsx", "C:\\temp\\Package.dtsx", null);
UpgradePackageInfo packinfo2 = new UpgradePackageInfo("C:\\temp\\Package2.dtsx", "C:\\temp\\Package2.dtsx", null);
Collection<UpgradePackageInfo> packages = new Collection<UpgradePackageInfo>();
packages.Add(packinfo1);
packages.Add(packinfo2);
StorageInfo storeinfoSource = StorageInfo.NewFileStorage();
storeinfoSource.RootFolder = "C:\\temp";
StorageInfo storeinfoDest = StorageInfo.NewFileStorage();
BatchUpgradeOptions upgradeOpts = new BatchUpgradeOptions();
upgradeOpts.Validate = true;
upgradeOpts.BackupOldPackages = true;
upgradeOpts.ContinueOnError = true;
upgradeOpts.ValidationFailureAsError = true;
MyEventsClass eventsClass = new MyEventsClass();
app.Upgrade(packages, storeinfoSource, storeinfoDest, upgradeOpts, eventsClass);
}
}
class MyEventsClass : DefaultEvents
{
public override void OnPreExecute(Executable exec, ref bool fireAgain)
{
Console.WriteLine("The PreExecute event of the " + exec.ToString() + " has been raised.");
Console.Read();
}
}
}