SqlBulkCopyOptions 列挙体とは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

SqlBulkCopyOptions 列挙体

メモ : この列挙体は、.NET Framework version 2.0 で新しく追加されたものです。

SqlBulkCopy のインスタンスで使用する、1 つまたは複数のオプションを指定するビット単位のフラグ。

この列挙体には、メンバ値のビットごとの組み合わせを可能にする FlagsAttribute 属性が含まれています。

名前空間: System.Data.SqlClient
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

<FlagsAttribute> _
Public Enumeration SqlBulkCopyOptions

Visual Basic (使用法)

Dim instance As SqlBulkCopyOptions

[FlagsAttribute] 
public enum SqlBulkCopyOptions

C++

[FlagsAttribute] 
public enum class SqlBulkCopyOptions

/** @attribute FlagsAttribute() */ 
public enum SqlBulkCopyOptions

JScript

FlagsAttribute 
public enum SqlBulkCopyOptions

メンバ

	メンバ名	説明
	CheckConstraints	データの挿入時に制約をチェックします。既定では、制約はチェックされません。
	Default	すべてのオプションについて既定値を使用します。
	FireTriggers	指定した場合、データベースに挿入される行について、サーバーが挿入トリガを発生させます。
	KeepIdentity	コピー元の ID 値を維持します。指定しなかった場合、ID 値はコピー先によって割り当てられます。
	KeepNulls	既定値の設定に関係なく、コピー先テーブルの null 値を維持します。指定しなかった場合、null 値は必要に応じて既定値に置き換えられます。
	TableLock	一括コピー操作時に一括更新ロックを取得します。指定しなかった場合、行ロックが使用されます。
	UseInternalTransaction	指定した場合、一括コピー操作の各バッチがトランザクション内で実行されます。このオプションを指定し、さらに、コンストラクタに対して SqlTransaction オブジェクトを指定した場合、ArgumentException が発生します。

解説

SqlBulkCopy のインスタンスを作成するとき、SqlBulkCopyOptions 列挙体を使用することで、そのインスタンスの WriteToServer メソッドの動作を変更できます。

使用例

次のコンソールアプリケーションでは、すべての行の ID 列について新しい値を生成する代わりに、コピー元テーブルの ID 列に格納されている値を、コピー先テーブルの対応する列にコピーする一括読み込みの方法を示しています。

このオプションが一括読み込みの動作にどのように影響しているかを確認するには、dbo.BulkCopyDemoMatchingColumns テーブルを空にした状態でサンプルを実行します。すべての行はソースから読み込まれます。次に、このテーブルを空にせずに、もう一度サンプルを実行します。例外がスローされ、主キーの違反によって行が追加されなかったことを通知するメッセージがコンソールウィンドウに出力されます。

重要 :
このサンプルを実行するには、あらかじめ、「バルクコピーの例のためのテーブルの作成」の説明に従って作業テーブルを作成しておく必要があります。このコードは、SqlBulkCopy を使用する構文を示すためだけに提供されています。同じ SQL Server インスタンスにコピー元テーブルとコピー先テーブルが存在する場合、Transact-SQL の `INSERT … SELECT` ステートメントを使用した方が容易かつ迅速にデータをコピーできます。

重要 :

このサンプルを実行するには、あらかじめ、「バルクコピーの例のためのテーブルの作成」の説明に従って作業テーブルを作成しておく必要があります。このコードは、SqlBulkCopy を使用する構文を示すためだけに提供されています。同じ SQL Server インスタンスにコピー元テーブルとコピー先テーブルが存在する場合、Transact-SQL の INSERT … SELECT ステートメントを使用した方が容易かつ迅速にデータをコピーできます。

Visual Basic

Imports System.Data.SqlClient

Module Module1
    Sub Main()
        Dim connectionString As String
 = GetConnectionString()

        ' Open a connection to the AdventureWorks database.
        Using sourceConnection As SqlConnection = _
           New SqlConnection(connectionString)
            sourceConnection.Open()

            ' Perform an initial count on the destination table.
            Dim commandRowCount As New
 SqlCommand( _
            "SELECT COUNT(*) FROM dbo.BulkCopyDemoMatchingColumns;",
 _
                sourceConnection)
            Dim countStart As Long
 = _
               System.Convert.ToInt32(commandRowCount.ExecuteScalar())
            Console.WriteLine("Starting row count = {0}",
 countStart)

            ' Get data from the source table as a SqlDataReader.
            Dim commandSourceData As SqlCommand
 = New SqlCommand( _
               "SELECT ProductID, Name, ProductNumber "
 & _
               "FROM Production.Product;", sourceConnection)
            Dim reader As SqlDataReader = commandSourceData.ExecuteReader

            ' Create the SqlBulkCopy object using a connection string
 
            ' and the KeepIdentity option. 
            ' In the real world you would not use SqlBulkCopy to move
            ' data from one table to the other in the same database.
            Using bulkCopy As SqlBulkCopy = _
              New SqlBulkCopy(connectionString, SqlBulkCopyOptions.KeepIdentity)
                bulkCopy.DestinationTableName = "dbo.BulkCopyDemoMatchingColumns"

                Try
                    ' Write from the source to the destination.
                    bulkCopy.WriteToServer(reader)

                Catch ex As Exception
                    Console.WriteLine(ex.Message)

                    Finally
                        ' Close the SqlDataReader. The SqlBulkCopy
                        ' object is automatically closed at the end
                        ' of the Using block.
                        reader.Close()
                End Try
            End Using

            ' Perform a final count on the destination table
            ' to see how many rows were added.
            Dim countEnd As Long
 = _
                System.Convert.ToInt32(commandRowCount.ExecuteScalar())
            Console.WriteLine("Ending row count = {0}",
 countEnd)
            Console.WriteLine("{0} rows were added.",
 countEnd - countStart)

            Console.WriteLine("Press Enter to finish.")
            Console.ReadLine()
        End Using
    End Sub

    Private Function GetConnectionString()
 As String
        ' To avoid storing the sourceConnection string in your code,
 
        ' you can retrieve it from a configuration file. 
        Return "Data Source=(local);"
 & _
            "Integrated Security=true;" & _
            "Initial Catalog=AdventureWorks;"
    End Function
End Module

using System.Data.SqlClient;

class Program
{
    static void Main()
    {
        string connectionString = GetConnectionString();
        // Open a sourceConnection to the AdventureWorks database.
        using (SqlConnection sourceConnection =
                   new SqlConnection(connectionString))
        {
            sourceConnection.Open();

            // Perform an initial count on the destination table.
            SqlCommand commandRowCount = new SqlCommand(
                "SELECT COUNT(*) FROM " +
                "dbo.BulkCopyDemoMatchingColumns;",
                sourceConnection);
            long countStart = System.Convert.ToInt32(
                commandRowCount.ExecuteScalar());
            Console.WriteLine("Starting row count = {0}", countStart);

            // Get data from the source table as a SqlDataReader.
            SqlCommand commandSourceData = new SqlCommand(
                "SELECT ProductID, Name, " +
                "ProductNumber " +
                "FROM Production.Product;", sourceConnection);
            SqlDataReader reader =
                commandSourceData.ExecuteReader();

            // Create the SqlBulkCopy object using a connection string
 
            // and the KeepIdentity option. 
            // In the real world you would not use SqlBulkCopy to move
            // data from one table to the other in the same database.
            using (SqlBulkCopy bulkCopy =
                new SqlBulkCopy(connectionString, SqlBulkCopyOptions.KeepIdentity))
            {
                bulkCopy.DestinationTableName =
                    "dbo.BulkCopyDemoMatchingColumns";

                try
                {
                    // Write from the source to the destination.
                    bulkCopy.WriteToServer(reader);
                }
                catch (Exception ex)
                {
                    Console.WriteLine(ex.Message);
                }
                finally
                {
                    // Close the SqlDataReader. The SqlBulkCopy
                    // object is automatically closed at the end
                    // of the using block.
                    reader.Close();
                }
            }

            // Perform a final count on the destination 
            // table to see how many rows were added.
            long countEnd = System.Convert.ToInt32(
                commandRowCount.ExecuteScalar());
            Console.WriteLine("Ending row count = {0}", countEnd);
            Console.WriteLine("{0} rows were added.", countEnd - countStart);
            Console.WriteLine("Press Enter to finish.");
            Console.ReadLine();
        }
    }

    private static string
 GetConnectionString()
        // To avoid storing the sourceConnection string in your code,
 
        // you can retrieve it from a configuration file. 
    {
        return "Data Source=(local); " +
            " Integrated Security=true;" +
            "Initial Catalog=AdventureWorks;";
    }
}

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
System.Data.SqlClient 名前空間
その他の技術情報
バルクコピー操作の実行

>> 「SqlBulkCopyOptions 列挙体」を含む用語の索引
SqlBulkCopyOptions 列挙体のページへのリンク


	© 2025 Microsoft.All rights reserved.

SqlBulkCopyOptions 列挙体とは？ わかりやすく解説

SqlBulkCopyOptions 列挙体

急上昇のことば

SqlBulkCopyOptions 列挙体とは？わかりやすく解説