Freigeben über


BulkInsertTask Klasse

Definition

Stellt die Eigenschaften und Methoden für die Aufgabe "Massen einfügen" bereit, die am schnellsten ist, um große Datenmengen in eine SQL Server Tabelle oder Ansicht zu kopieren. Diese Klasse kann nicht vererbt werden.

public ref class BulkInsertTask sealed : Microsoft::SqlServer::Dts::Runtime::Task, Microsoft::SqlServer::Dts::Runtime::IDTSBreakpointSite, Microsoft::SqlServer::Dts::Runtime::IDTSComponentPersist, Microsoft::SqlServer::Dts::Tasks::BulkInsertTask::IDTSBulkInsertTask
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.bulkinserttask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.BulkInsertTaskMessages), SamplesTag="SsisBulkInsertTask", UITypeName="Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.BulkInsertTaskUI, Microsoft.SqlServer.BulkInsertTaskUI, Version=13.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
public sealed class BulkInsertTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSBreakpointSite, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.IDTSBulkInsertTask
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.bulkinserttask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.BulkInsertTaskMessages), SamplesTag="SsisBulkInsertTask", UITypeName="Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.BulkInsertTaskUI, Microsoft.SqlServer.BulkInsertTaskUI, Version=14.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
public sealed class BulkInsertTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSBreakpointSite, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.IDTSBulkInsertTask
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.bulkinserttask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.BulkInsertTaskMessages), SamplesTag="SsisBulkInsertTask", UITypeName="Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.BulkInsertTaskUI, Microsoft.SqlServer.BulkInsertTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
public sealed class BulkInsertTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSBreakpointSite, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.IDTSBulkInsertTask
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.bulkinserttask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.BulkInsertTaskMessages), SamplesTag="SsisBulkInsertTask", UITypeName="Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.BulkInsertTaskUI, Microsoft.SqlServer.BulkInsertTaskUI, Version=13.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
type BulkInsertTask = class
    inherit Task
    interface IDTSComponentPersist
    interface IDTSBulkInsertTask
    interface IDTSBreakpointSite
    interface IDTSSuspend
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.bulkinserttask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.BulkInsertTaskMessages), SamplesTag="SsisBulkInsertTask", UITypeName="Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.BulkInsertTaskUI, Microsoft.SqlServer.BulkInsertTaskUI, Version=14.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
type BulkInsertTask = class
    inherit Task
    interface IDTSComponentPersist
    interface IDTSBulkInsertTask
    interface IDTSBreakpointSite
    interface IDTSSuspend
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.bulkinserttask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.BulkInsertTaskMessages), SamplesTag="SsisBulkInsertTask", UITypeName="Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.BulkInsertTaskUI, Microsoft.SqlServer.BulkInsertTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
type BulkInsertTask = class
    inherit Task
    interface IDTSComponentPersist
    interface IDTSBulkInsertTask
    interface IDTSBreakpointSite
    interface IDTSSuspend
Public NotInheritable Class BulkInsertTask
Inherits Task
Implements IDTSBreakpointSite, IDTSBulkInsertTask, IDTSComponentPersist
Vererbung
BulkInsertTask
Attribute
Implementiert

Hinweise

Weitere Informationen finden Sie unter Bulk Insert Task.

Konstruktoren

BulkInsertTask()

Initialisiert eine neue Instanz der BulkInsertTask-Klasse.

Eigenschaften

BatchSize

Ruft die Anzahl der Zeilen in jedem Batch ab oder legt sie fest.

CheckConstraints

Dient zum Abrufen oder Festlegen eines Booleschen Werts, der angibt, ob Sie Tabellen- und Spaltenprüfungseinschränkungen erzwingen möchten.

CodePage

Ruft die Codepage der in der Datendatei enthaltenen Daten ab oder legt sie fest.

DataFileType

Ruft einen Wert aus der DTSBulkInsert_DataFileType-Enumeration ab, der den im Ladevorgang zu verwendenden Wert für den Datentyp angibt, oder legt ihn fest.

DebugMode

Ruft einen booleschen Wert ab, der angibt, ob von einem Task bestimmt werden soll, ob Breakpoints aktiviert sind, oder legt ihn fest.

DestinationConnection

Ruft den Namen des Zielverbindungsobjekts ab oder legt ihn fest.

DestinationTableName

Ruft den Namen der Zieltabelle oder -sicht ab oder legt ihn fest.

ExecutionValue

Gibt ein benutzerdefiniertes Objekt zurück. Dieses Feld ist schreibgeschützt.

(Geerbt von Task)
FieldTerminator

Ruft den Feldterminator für die Verwendung in Char- und Widechar-Datendateien ab oder legt diesen fest.

FireTriggers

Ruft einen Boolean ab oder legt diesen fest, der angibt, ob die Einfügen-Trigger während des Vorgangs auf der Tabelle ausgeführt werden sollen.

FirstRow

Ruft die erste zu kopierende Zeile ab oder legt sie fest.

FormatFile

Ruft den vollständigen Pfad einer Formatdatei ab oder legt ihn fest.

KeepIdentity

Ruft einen Booleschen Wert ab oder legt diesen fest, der angibt, wie Identitätswert oder Werte in der importierten Datendatei für die Identitätsspalte verwendet werden.

KeepNulls

Ruft einen booleschen Wert ab oder legt diesen fest, der angibt, ob leere Spalten während des Massenladevorgangs einen Nullwert beibehalten oder Standardwerte in die Spalten einfügen sollen.

LastRow

Ruft die Nummer der letzten zu kopierenden Zeile ab oder legt sie fest.

MaximumErrors

Ruft ab oder legt fest, wie viele Fehler maximal auftreten dürfen, bevor der Masseneinfügungsvorgang fehlschlägt.

RowTerminator

Ruft den Zeilenterminator für die Verwendung in Char- und Widechar-Datendateien ab oder legt diesen fest.

SortedData

Ruft die Order by-Klausel in der Massen einfügen-Anweisung ab oder legt diese fest.

SourceConnection

Ruft den Namen des Quellverbindungsobjekts ab oder legt ihn fest.

SqlStatement

Ruft ein String-Array ab, das die zu ausführende Transact-SQL-Anweisung enthält.

SuspendRequired

Ruft einen booleschen Wert ab, der angibt, ob die Taskausführung bei Erreichen eines Breakpoints angehalten werden soll, oder legt ihn fest. Dieser Wert wird von der Runtime-Engine für Tasks und Container festgelegt, wenn ein Breakpoint erreicht wird.

TableLock

Ruft einen Boolean ab oder legt diesen fest, der angibt, ob die Tabelle während des Massen einfügen-Vorgangs gesperrt ist.

TargetServerVersion

Stellt die Eigenschaften und Methoden für die Aufgabe "Massen einfügen" bereit, die am schnellsten ist, um große Datenmengen in eine SQL Server Tabelle oder Ansicht zu kopieren. Diese Klasse kann nicht vererbt werden.

(Geerbt von Task)
UseFormatFile

Ruft einen Boolean ab oder legt diesen fest, der angibt, ob die Massen einfügen-Aufgabe eine Formatdatei verwendet.

Version

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

(Geerbt von Task)

Methoden

AcceptBreakpointManager(BreakpointManager)

Wird von der Runtime-Engine beim Erstellen eines Tasks oder Containers aufgerufen. Darüber hinaus wird BreakpointManager übergeben, damit der Task Breakpoints erstellen, entfernen und deren Status überprüfen kann. Diese Methode wird von der Laufzeit aufgerufen und wird nicht in Code verwendet.

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 den Masseneinfügungstask 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.

ResumeExecution()

Setzt die Taskausführung nach einer Unterbrechung fort. Die Runtime-Engine setzt die Ausführung des Tasks oder Containers fort.

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.

SuspendExecution()

Gibt an, dass das ausführbare Element angehalten werden muss. Diese Methode wird von der Runtime-Engine aufgerufen.

Update(String)

Mitglied veraltet; siehe Hinweise. Diese Methode aktualisiert das alte Paket-XML 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 Masseneinfügungstask-Komponente ordnungsgemäß konfiguriert ist.

Gilt für: