Partager via


Classe BulkInsertTask

Provides the properties and methods for the Bulk Insert task, which is the quickest way to copy large amounts of data into a SQL Server table or view. This class cannot be inherited.

Hiérarchie d'héritage

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

Espace de noms :  Microsoft.SqlServer.Dts.Tasks.BulkInsertTask
Assembly :  Microsoft.SqlServer.BulkInsertTask (en Microsoft.SqlServer.BulkInsertTask.dll)

Syntaxe

'Déclaration
Public NotInheritable Class BulkInsertTask _
    Inherits Task _
    Implements IDTSComponentPersist, IDTSBulkInsertTask, IDTSBreakpointSite, IDTSSuspend
'Utilisation
Dim instance As BulkInsertTask
public sealed class BulkInsertTask : Task, 
    IDTSComponentPersist, IDTSBulkInsertTask, IDTSBreakpointSite, IDTSSuspend
public ref class BulkInsertTask sealed : public Task, 
    IDTSComponentPersist, IDTSBulkInsertTask, IDTSBreakpointSite, IDTSSuspend
[<SealedAttribute>]
type BulkInsertTask =  
    class
        inherit Task
        interface IDTSComponentPersist
        interface IDTSBulkInsertTask
        interface IDTSBreakpointSite
        interface IDTSSuspend
    end
public final class BulkInsertTask extends Task implements IDTSComponentPersist, IDTSBulkInsertTask, IDTSBreakpointSite, IDTSSuspend

Le type BulkInsertTask expose les membres suivants.

Constructeurs

  Nom Description
Méthode publique BulkInsertTask Initializes a new instance of the BulkInsertTask class.

Haut de la page

Propriétés

  Nom Description
Propriété publique BatchSize Gets or sets the number of rows in each batch.
Propriété publique CheckConstraints Gets or sets a Boolean that indicates if you want to enforce table and column check constraints.
Propriété publique CodePage Gets or sets the code page of the data in the data file.
Propriété publique DataFileType Gets or sets a value from the DTSBulkInsert_DataFileType enumeration that indicates the data-type value to use in the load operation.
Propriété publique DebugMode Gets or sets a Boolean that indicates whether a task should determine whether breakpoints are enabled.
Propriété publique DestinationConnection Gets or sets the name of the destination connection object.
Propriété publique DestinationTableName Gets or sets the name of the destination table or view.
Propriété publique ExecutionValue Returns a user-defined object. This field is read-only. (hérité de Task.)
Propriété publique FieldTerminator Gets or sets the field terminator for use in char and widechar data files.
Propriété publique FireTriggers Gets or sets a Boolean that indicates whether the insert triggers should be executed on the table during the operation.
Propriété publique FirstRow Gets or sets the first row from which to start copying.
Propriété publique FormatFile Gets or sets the full path of a format file.
Propriété publique KeepIdentity Gets or sets a Boolean that specifies how identity value or values in the imported data file are used for the identity column
Propriété publique KeepNulls Gets or sets a Boolean that indicates whether empty columns should retain a nullNothingnullptrunitune référence Null (Nothing dans Visual Basic) value during the bulk load operation, or insert default values into the columns.
Propriété publique LastRow Gets or sets the number of the last row to copy.
Propriété publique MaximumErrors Gets or sets the maximum number of errors that can occur before the bulk insert operation fails.
Propriété publique RowTerminator Gets or sets the row terminator for use in char and widechar data files.
Propriété publique SortedData Gets or sets the Order by clause in the bulk insert statement
Propriété publique SourceConnection Gets or sets the name of the source connection object.
Propriété publique SqlStatement Gets a String array that contains the Transact-SQL statement to run.
Propriété publique SuspendRequired Gets or sets a Boolean that indicates whether tasks should suspend when they encounter a breakpoint. This value is set by the runtime engine for tasks and containers when a breakpoint is encountered.
Propriété publique TableLock Gets or sets a Boolean that indicates whether the table is locked during the bulk insert operation.
Propriété publique UseFormatFile Gets or sets a Boolean that indicates whether the Bulk Insert task uses a format file.
Propriété publique Version *** Member deprecated; see Remarks. ***    Returns the version of the task. This property is read-only. (hérité de Task.)

Haut de la page

Méthodes

  Nom Description
Méthode publique AcceptBreakpointManager Called by the run-time engine when a task or container is created, and is passed a BreakpointManager to enable the task to create, remove, and check the status of breakpoints. This method is called by the runtime and is not used in code.
Méthode publique CanUpdate *** Member deprecated; see Remarks. ***    A Boolean that indicates whether the new package XML can update the old package XML. (hérité de Task.)
Méthode publique Equals Determines whether two object instances are equal. (hérité de DtsObject.)
Méthode publique Execute Runs the Bulk Insert task. (remplace Task. . :: . .Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object).)
Méthode protégée Finalize (hérité de Object.)
Méthode publique GetConnectionID Gets a String containing the ID of the connection. (hérité de Task.)
Méthode publique GetConnectionName Gets a String containing the name of the connection. (hérité de Task.)
Méthode publique GetHashCode Returns the hash code for this instance. (hérité de DtsObject.)
Méthode publique GetType (hérité de Object.)
Méthode publique InitializeTask Initializes the properties associated with the task. This method is called by the runtime and is not used in code. (remplace Task. . :: . .InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker).)
Méthode publique LoadFromXML This method is not callable by your application code. To load a package saved as .xml, use the Application..::..LoadPackage method.
Méthode protégée MemberwiseClone (hérité de Object.)
Méthode publique ResumeExecution Resumes execution of the task after pausing. The task or container is resumed by the runtime engine.
Méthode publique SaveToXML This method is not callable by your application code. To save a package as .xml, use the Application..::..SaveToXml method.
Méthode publique SuspendExecution Indicates that the executable needs to suspend. This method is called by the runtime engine.
Méthode publique ToString (hérité de Object.)
Méthode publique Update *** Member deprecated; see Remarks. ***    This method updates the old package XML with the new package XML if CanUpdate is set to true. (hérité de Task.)
Méthode publique Validate Verifies that the Bulk Insert task component is correctly configured. (remplace Task. . :: . .Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging).)

Haut de la page

Notes

For more information, see Tâche d'insertion en bloc.

Sécurité des threads

Tous les membres publics static (Shared dans Visual Basic) de ce type sont thread-safe. Tous les membres de l'instance ne sont pas garantis comme étant thread-safe.