Freigeben über


TransferDatabaseTask Klasse

Definition

Ermöglicht die Übertragung einer Datenbank zwischen einem Quell- und Zielserver unter Verwendung zwei verschiedener Methoden: der Online- und Offlineübertragung von Datenbanken. Der Task erfordert die Verwendung eines SMO-Verbindungs-Managers.

public ref class TransferDatabaseTask sealed : Microsoft::SqlServer::Dts::Runtime::Task, Microsoft::SqlServer::Dts::Runtime::IDTSComponentPersist, Microsoft::SqlServer::Dts::Tasks::TransferDatabaseTask::ITransferDatabaseTask
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.transferdatabasetask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.TransferDatabaseTask.Localized), SamplesTag="SsisTransferDatabaseTask", TaskContact="Transfer Database Task; Microsoft Corporation; SQL Server 2016; (C) Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.TransferDatabasesTaskUI.TransferDatabasesTaskUI, Microsoft.SqlServer.TransferDatabasesTaskUI, Version=13.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.Guid("87A575D4-76EA-487F-9493-0A5ACBDFBA3E")]
public sealed class TransferDatabaseTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.TransferDatabaseTask.ITransferDatabaseTask
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.transferdatabasetask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.TransferDatabaseTask.Localized), SamplesTag="SsisTransferDatabaseTask", TaskContact="Transfer Database Task; Microsoft Corporation; SQL Server 2017; (C) Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.TransferDatabasesTaskUI.TransferDatabasesTaskUI, Microsoft.SqlServer.TransferDatabasesTaskUI, Version=14.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.Guid("B74AA170-4BC7-43DF-B5A6-E560F0E02951")]
public sealed class TransferDatabaseTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.TransferDatabaseTask.ITransferDatabaseTask
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.transferdatabasetask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.TransferDatabaseTask.Localized), SamplesTag="SsisTransferDatabaseTask", TaskContact="Transfer Database Task; Microsoft Corporation; SQL Server 2019; (C) Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.TransferDatabasesTaskUI.TransferDatabasesTaskUI, Microsoft.SqlServer.TransferDatabasesTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.Guid("F609B862-C801-4560-A6C0-B152830A7FDB")]
public sealed class TransferDatabaseTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.TransferDatabaseTask.ITransferDatabaseTask
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.transferdatabasetask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.TransferDatabaseTask.Localized), SamplesTag="SsisTransferDatabaseTask", TaskContact="Transfer Database Task; Microsoft Corporation; SQL Server 2016; (C) Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.TransferDatabasesTaskUI.TransferDatabasesTaskUI, Microsoft.SqlServer.TransferDatabasesTaskUI, Version=13.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("87A575D4-76EA-487F-9493-0A5ACBDFBA3E")>]
type TransferDatabaseTask = class
    inherit Task
    interface ITransferDatabaseTask
    interface IDTSComponentPersist
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.transferdatabasetask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.TransferDatabaseTask.Localized), SamplesTag="SsisTransferDatabaseTask", TaskContact="Transfer Database Task; Microsoft Corporation; SQL Server 2017; (C) Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.TransferDatabasesTaskUI.TransferDatabasesTaskUI, Microsoft.SqlServer.TransferDatabasesTaskUI, Version=14.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("B74AA170-4BC7-43DF-B5A6-E560F0E02951")>]
type TransferDatabaseTask = class
    inherit Task
    interface ITransferDatabaseTask
    interface IDTSComponentPersist
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.transferdatabasetask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.TransferDatabaseTask.Localized), SamplesTag="SsisTransferDatabaseTask", TaskContact="Transfer Database Task; Microsoft Corporation; SQL Server 2019; (C) Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.TransferDatabasesTaskUI.TransferDatabasesTaskUI, Microsoft.SqlServer.TransferDatabasesTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("F609B862-C801-4560-A6C0-B152830A7FDB")>]
type TransferDatabaseTask = class
    inherit Task
    interface ITransferDatabaseTask
    interface IDTSComponentPersist
Public NotInheritable Class TransferDatabaseTask
Inherits Task
Implements IDTSComponentPersist, ITransferDatabaseTask
Vererbung
TransferDatabaseTask
Attribute
Implementiert

Hinweise

Die Übertragung kann zwischen Datenbanken derselben Version oder zu einer höheren Version erfolgen. Weitere Informationen finden Sie unter Transfer Database Task.

Konstruktoren

TransferDatabaseTask()

Initialisiert eine neue Instanz der TransferDatabaseTask-Klasse.

Eigenschaften

Action

Ruft einen Wert aus der TransferAction-Enumeration ab, der angibt, ob Datenbanken vom Task "Datenbanken übertragen" kopiert oder verschoben werden, oder legt ihn fest.

DestinationConnection

Dient zum Abrufen oder Festlegen einer Zeichenfolge, die den Namen des SMO-Verbindungs-Managers für die Zieldatenbank enthält.

DestinationDatabaseFiles

Dient zum Abrufen oder Festlegen einer Zeichenfolge, die den Namen der Datenbankdateien für die Zieldatenbank enthält.

DestinationDatabaseName

Dient zum Abrufen oder Festlegen einer Zeichenfolge, die den Namen der Datenbank am Ziel enthält.

DestinationOverwrite

Dient zum Abrufen oder Festlegen eines booleschen Werts, der angibt, ob die Zieldatenbank überschrieben werden kann, wenn sie vorhanden ist.

ExecutionValue

Gibt das Ergebnis der Taskausführung zurück.

Method

Ruft einen Wert aus der TransferMethod-Enumeration ab, der angibt, ob die Methode für die Online- oder Offlineübertragung verwendet werden soll, oder legt ihn fest.

ReattachSourceDatabase

Ein boolescher Wert, der angibt, ob die Datenbank erneut angefügt werden soll oder nicht.

SourceConnection

Dient zum Abrufen oder Festlegen einer Zeichenfolge, die den Namen des SMO-Verbindungs-Managers für die Quelldatenbank enthält.

SourceDatabaseFiles

Dient zum Abrufen oder Festlegen einer Zeichenfolge, die die Namen der zu übertragenden Quelldatenbankdateien enthält.

SourceDatabaseName

Dient zum Abrufen oder Festlegen einer Zeichenfolge, die den Namen der zu übertragenden Quelldatenbank enthält.

TargetServerVersion

Ermöglicht die Übertragung einer Datenbank zwischen einem Quell- und Zielserver unter Verwendung zwei verschiedener Methoden: der Online- und Offlineübertragung von Datenbanken. Der Task erfordert die Verwendung eines SMO-Verbindungs-Managers.

(Geerbt von Task)
Version

Mitglied veraltet; siehe Hinweise. *** Gibt die Version des Tasks zurück. Diese Eigenschaft ist schreibgeschützt.

(Geerbt von Task)

Methoden

CanUpdate(String)

Mitglied veraltet; siehe Hinweise. Ein boolescher Wert, der angibt, ob der neue Paket-XML-Code das alte Paket-XML aktualisieren kann.

(Geerbt von Task)
Equals(Object)

Stellt fest, ob zwei Objektinstanzen gleich sind.

(Geerbt von DtsObject)
Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)

Führt die Aufgabe aus.

GetConnectionID(Connections, String)

Ruft eine Zeichenfolge ab, die die ID der Verbindung enthält.

(Geerbt von Task)
GetConnectionName(Connections, String)

Ruft eine Zeichenfolge ab, die den Namen der Verbindung enthält.

(Geerbt von Task)
GetHashCode()

Gibt den Hashcode für diese Instanz zurück.

(Geerbt von DtsObject)
InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker)

Initialisiert die dem Task zugeordneten Eigenschaften. Diese Methode wird von der Laufzeit aufgerufen und wird nicht in Code verwendet.

LoadFromXML(XmlElement, IDTSInfoEvents)

Diese Methode kann durch den Anwendungscode nicht aufgerufen werden. Um ein im XML-Format gespeichertes Paket zu laden, verwenden Sie die LoadPackage(String, IDTSEvents)-Methode.

SaveToXML(XmlDocument, IDTSInfoEvents)

Diese Methode kann durch den Anwendungscode nicht aufgerufen werden. Um ein Paket als XML-Datei zu speichern, verwenden Sie die SaveToXml(String, Package, IDTSEvents)-Methode.

Update(String)

Mitglied veraltet; siehe Hinweise. Diese Methode aktualisiert den alten Paket-XML-Code mit dem neuen Paket-XML, wenn CanUpdate(String) er auf "true" festgelegt ist.

(Geerbt von Task)
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)

Überprüft, ob die Taskkomponente ordnungsgemäß konfiguriert ist.

Gilt für: