SqlBulkCopy.EnableStreaming プロパティ

定義

名前空間:

Microsoft.Data.SqlClient

アセンブリ:

Microsoft.Data.SqlClient.dll

パッケージ:

Microsoft.Data.SqlClient v5.2.0

IDataReader オブジェクトからデータをストリーミングする SqlBulkCopy オブジェクトを有効または無効にします。

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はtrue、 をIDataReader使用して SequentialAccessオブジェクトからを読み取り、ストリーミング機能を使用してメモリ使用量をIDataReaderSqlBulkCopy最適化します。 ストリーミングは、最大データ型 (VARBINARY(MAX)、VARCHAR(MAX)、NVARCHAR(MAX)、XML) にのみ適用されます。 が false に設定されている場合 EnableStreaming 、クラスは SqlBulkCopy オブジェクトから返されたすべてのデータを IDataReader サーバーに送信する前にメモリに読み込みます。

Note

ストリーミングを有効にする主な利点は、最大データ型の一括コピー中のメモリ使用量を減らすことです。