Share via


TransferDatabaseTask-Klasse

Allows the transfer of a database between a source and a destination server using two different methods: database online, and database offline. The task requires the use of an SMO Connection Manager.

Vererbungshierarchie

System. . :: . .Object
  Microsoft.SqlServer.Dts.Runtime. . :: . .DtsObject
    Microsoft.SqlServer.Dts.Runtime. . :: . .Task
      Microsoft.SqlServer.Dts.Tasks.TransferDatabaseTask..::..TransferDatabaseTask

Namespace:  Microsoft.SqlServer.Dts.Tasks.TransferDatabaseTask
Assembly:  Microsoft.SqlServer.TransferDatabasesTask (in Microsoft.SqlServer.TransferDatabasesTask.dll)

Syntax

'Declaration
<GuidAttribute("D9E9F0F6-7771-4596-BC26-2A8BE222CB56")> _
Public NotInheritable Class TransferDatabaseTask _
    Inherits Task _
    Implements ITransferDatabaseTask, IDTSComponentPersist
'Usage
Dim instance As TransferDatabaseTask
[GuidAttribute("D9E9F0F6-7771-4596-BC26-2A8BE222CB56")]
public sealed class TransferDatabaseTask : Task, 
    ITransferDatabaseTask, IDTSComponentPersist
[GuidAttribute(L"D9E9F0F6-7771-4596-BC26-2A8BE222CB56")]
public ref class TransferDatabaseTask sealed : public Task, 
    ITransferDatabaseTask, IDTSComponentPersist
[<SealedAttribute>]
[<GuidAttribute("D9E9F0F6-7771-4596-BC26-2A8BE222CB56")>]
type TransferDatabaseTask =  
    class
        inherit Task
        interface ITransferDatabaseTask
        interface IDTSComponentPersist
    end
public final class TransferDatabaseTask extends Task implements ITransferDatabaseTask, IDTSComponentPersist

Der TransferDatabaseTask-Typ macht folgende Elemente verfügbar.

Konstruktoren

  Name Beschreibung
Öffentliche Methode TransferDatabaseTask Initializes a new instance of the TransferDatabaseTask class.

Zum Anfang

Eigenschaften

  Name Beschreibung
Öffentliche Eigenschaft Action Gets or sets a value from the TransferAction enumeration indicating whether the Transfer Database task is copying or moving databases.
Öffentliche Eigenschaft DestinationConnection Gets or sets a String containing the name of the SMO connection manager for the destination database.
Öffentliche Eigenschaft DestinationDatabaseFiles Gets or sets a String containing the name of the database files for the destination database.
Öffentliche Eigenschaft DestinationDatabaseName Gets or sets a String containing the name of the database at the destination.
Öffentliche Eigenschaft DestinationOverwrite Gets or sets a Boolean indicating whether the destination database can be overwritten if it exists.
Öffentliche Eigenschaft ExecutionValue Returns the result of the task execution. (Überschreibt Task. . :: . .ExecutionValue.)
Öffentliche Eigenschaft Method Gets or sets a value from the TransferMethod enumeration indicating whether to use Online or Offline transfer method.
Öffentliche Eigenschaft ReattachSourceDatabase A Boolean indicating whether the database should be reattached or not.
Öffentliche Eigenschaft SourceConnection Gets or sets a String containing the name of the SMO connection manager for the source database.
Öffentliche Eigenschaft SourceDatabaseFiles Gets or sets a String containing the names of the source database files to transfer.
Öffentliche Eigenschaft SourceDatabaseName Gets or sets a String containing the name of the source database to transfer.
Öffentliche Eigenschaft Version *** Member deprecated; see Remarks. ***    Returns the version of the task. This property is read-only. (Geerbt von Task.)

Zum Anfang

Methoden

  Name Beschreibung
Öffentliche Methode CanUpdate *** Member deprecated; see Remarks. ***    A Boolean that indicates whether the new package XML can update the old package XML. (Geerbt von Task.)
Öffentliche Methode Equals Determines whether two object instances are equal. (Geerbt von DtsObject.)
Öffentliche Methode Execute Runs the task. (Überschreibt Task. . :: . .Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object).)
Geschützte Methode Finalize (Geerbt von Object.)
Öffentliche Methode GetConnectionID Gets a String containing the ID of the connection. (Geerbt von Task.)
Öffentliche Methode GetConnectionName Gets a String containing the name of the connection. (Geerbt von Task.)
Öffentliche Methode GetHashCode Returns the hash code for this instance. (Geerbt von DtsObject.)
Öffentliche Methode GetType (Geerbt von Object.)
Öffentliche Methode InitializeTask Initializes the properties associated with the task. This method is called by the runtime and is not used in code. (Überschreibt Task. . :: . .InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker).)
Öffentliche Methode LoadFromXML This method is not callable by your application code. To load a package saved as .xml, use the Application..::..LoadPackage method.
Geschützte Methode MemberwiseClone (Geerbt von Object.)
Öffentliche Methode SaveToXML This method is not callable by your application code. To save a package as .xml, use the Application..::..SaveToXml method.
Öffentliche Methode ToString (Geerbt von Object.)
Öffentliche Methode Update *** Member deprecated; see Remarks. ***    This method updates the old package XML with the new package XML if CanUpdate is set to true. (Geerbt von Task.)
Öffentliche Methode Validate Verifies that the task component is correctly configured. (Überschreibt Task. . :: . .Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging).)

Zum Anfang

Hinweise

The transfer can occur between databases of the same version, or to a higher version. For more information, see Datenbanken übertragen (Task).

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Elemente dieses Typs sind Threadsicher. Für Instanzelemente wird die Threadsicherheit nicht gewährleistet.