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 .

備註

當 為 時 EnableStreaming ， SqlBulkCopy 會使用 SequentialAccess 從 IDataReader 物件讀取，並使用 IDataReader 串流功能 true 優化記憶體使用量。 串流僅適用于 max 資料類型 (，例如 VARBINARY (MAX) 、VARCHAR (MAX) 、NVARCHAR (MAX) 和 XML) 。 當 設定為 false 時 EnableStreaming ，類別 SqlBulkCopy 會先將物件傳 IDataReader 回的所有資料載入記憶體中，再將它傳送至伺服器。

注意

啟用串流的主要優點是在大量複製 max 資料類型期間減少記憶體使用量。