SqlBulkCopy.EnableStreaming Propriété

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

Active ou désactive un objet SqlBulkCopy pour diffuser des données en continu à partir d’un objet IDataReader.

public:
 property bool EnableStreaming { bool get(); void set(bool value); };

public bool EnableStreaming { get; set; }

member this.EnableStreaming : bool with get, set

Public Property EnableStreaming As Boolean

Valeur de propriété

Boolean

true si un objet SqlBulkCopy peut diffuser des données en continu à partir d’un objet IDataReader ; sinon, false. La valeur par défaut estfalse .

Remarques

Quand EnableStreaming est true, SqlBulkCopy lit à partir d’un IDataReader objet à l’aide SequentialAccessde , optimisant l’utilisation de la mémoire à l’aide des fonctionnalités de IDataReader streaming. La diffusion en continu s’applique uniquement aux types de données max (par exemple, VARBINARY(MAX), VARCHAR(MAX), NVARCHAR(MAX) et XML). Quand EnableStreaming est défini sur false, la SqlBulkCopy classe charge toutes les données retournées par l’objet IDataReader en mémoire avant de les envoyer au serveur.

Notes

Le principal avantage de l’activation de la diffusion en continu est de réduire l’utilisation de la mémoire lors de la copie en bloc de types de données maximum.