SqlBulkCopy.EnableStreaming 属性

定义

命名空间:

Microsoft.Data.SqlClient

程序集:

Microsoft.Data.SqlClient.dll

包:

Microsoft.Data.SqlClient v5.2.0

启用或禁用 SqlBulkCopy 对象，以流式传输 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

属性值

Boolean

如果 SqlBulkCopy 对象可以流式传输 IDataReader 对象中的数据，则为 true；否则为 false。 默认值是false .

注解

当 为 true时EnableStreaming，SqlBulkCopy使用 SequentialAccess从 IDataReader 对象读取 ，通过使用 IDataReader 流式处理功能优化内存使用情况。 流式处理仅适用于最大数据类型 (，即 VARBINARY (MAX) 、VARCHAR (MAX) 、NVARCHAR (MAX) 和 XML) 。 当 设置为 false 时 EnableStreaming ，类会将 SqlBulkCopy 对象返回 IDataReader 的所有数据加载到内存中，然后再将其发送到服务器。

注意

启用流式处理的主要优点是在大容量复制最大数据类型期间减少内存使用量。