SqlDataAdapter.InsertCommand プロパティ

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

SqlDataAdapter.InsertCommand プロパティ

データ ソースに新しいレコードを挿入するための Transact-SQL ステートメントまたはストアド プロシージャを取得または設定します。

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

Visual Basic (宣言)

Public Property InsertCommand As
 SqlCommand

Visual Basic (使用法)

Dim instance As SqlDataAdapter
Dim value As SqlCommand

value = instance.InsertCommand

instance.InsertCommand = value

C#

public SqlCommand InsertCommand { get; set;
 }

C++

public:
property SqlCommand^ InsertCommand {
    SqlCommand^ get ();
    void set (SqlCommand^ value);
}

J#

/** @property */
public SqlCommand get_InsertCommand ()

/** @property */
public void set_InsertCommand (SqlCommand value)

JScript

public function get InsertCommand
 () : SqlCommand

public function set InsertCommand
 (value : SqlCommand)

プロパティ値
Update 処理中に、DataSet 内の新しい行に対応するレコードをデータベースに挿入するための SqlCommand。

解説

Update 処理中に、このプロパティが設定されておらず、DataSet に主キー情報が存在する場合、SelectCommand プロパティを設定し、SqlCommandBuilder を使用しているときは、InsertCommand が自動的に生成されます。続いて、設定していない追加のコマンドが、SqlCommandBuilder によって生成されます。この生成ロジックでは、DataSet 内にキー列情報が存在している必要があります。詳細については、「コマンドの自動生成」を参照してください。

作成済みの SqlCommand に InsertCommand が割り当てられた場合、SqlCommand のクローンは作成されません。InsertCommand によって、作成済みの SqlCommand オブジェクトへの参照が維持されます。

メモ
このコマンドの実行によって行が返される場合、SqlCommand オブジェクトの UpdatedRowSource プロパティの設定によっては、返された行を DataSet に追加できます。

使用例

SqlDataAdapter を作成し、SelectCommand、InsertCommand、UpdateCommand、および DeleteCommand の各プロパティを設定する例を次に示します。ここでは、SqlConnection オブジェクトが既に作成されていることを前提にしています。

Visual Basic

Public Function CreateCustomerAdapter( _
  ByVal connection As SqlConnection) As
 SqlDataAdapter

    Dim adapter As SqlDataAdapter = New
 SqlDataAdapter()

    ' Create the SelectCommand.
    Dim command As SqlCommand = New
 SqlCommand( _
        "SELECT * FROM Customers " & _
        "WHERE Country = @Country AND City = @City",
 connection)

    ' Add the parameters for the SelectCommand.
    command.Parameters.Add("@Country", SqlDbType.NVarChar,
 15)
    command.Parameters.Add("@City", SqlDbType.NVarChar,
 15)

    adapter.SelectCommand = command

    ' Create the InsertCommand.
    command = New SqlCommand( _
        "INSERT INTO Customers (CustomerID, CompanyName) "
 & _
        "VALUES (@CustomerID, @CompanyName)", connection)

    ' Add the parameters for the InsertCommand.
    command.Parameters.Add("@CustomerID", SqlDbType.NChar,
 5, "CustomerID")
    command.Parameters.Add("@CompanyName", SqlDbType.NVarChar,
 40, "CompanyName")

    adapter.InsertCommand = command

    ' Create the UpdateCommand.
    command = New SqlCommand( _
        "UPDATE Customers SET CustomerID = @CustomerID, CompanyName
 = @CompanyName " & _
        "WHERE CustomerID = @oldCustomerID", connection)

    ' Add the parameters for the UpdateCommand.
    command.Parameters.Add("@CustomerID", SqlDbType.NChar,
 5, "CustomerID")
    command.Parameters.Add("@CompanyName", SqlDbType.NVarChar,
 40, "CompanyName")
    Dim parameter As SqlParameter = command.Parameters.Add(
 _
        "@oldCustomerID", SqlDbType.NChar, 5, "CustomerID")
    parameter.SourceVersion = DataRowVersion.Original

    adapter.UpdateCommand = command

    ' Create the DeleteCommand.
    command = New SqlCommand( _
        "DELETE FROM Customers WHERE CustomerID = @CustomerID",
 connection)

    ' Add the parameters for the DeleteCommand.
    command.Parameters.Add( _
        "@CustomerID", SqlDbType.NChar, 5, "CustomerID")
    parameter.SourceVersion = DataRowVersion.Original

    adapter.DeleteCommand = command

    Return adapter
End Function

C#

public static SqlDataAdapter CreateCustomerAdapter(
    SqlConnection connection)
{
    SqlDataAdapter adapter = new SqlDataAdapter();

    // Create the SelectCommand.
    SqlCommand command = new SqlCommand("SELECT * FROM Customers
 " +
        "WHERE Country = @Country AND City = @City", connection);

    // Add the parameters for the SelectCommand.
    command.Parameters.Add("@Country", SqlDbType.NVarChar, 15);
    command.Parameters.Add("@City", SqlDbType.NVarChar, 15);

    adapter.SelectCommand = command;

    // Create the InsertCommand.
    command = new SqlCommand(
        "INSERT INTO Customers (CustomerID, CompanyName) " +
        "VALUES (@CustomerID, @CompanyName)", connection);

    // Add the parameters for the InsertCommand.
    command.Parameters.Add("@CustomerID", SqlDbType.NChar, 5, "CustomerID");
    command.Parameters.Add("@CompanyName", SqlDbType.NVarChar, 40, "CompanyName");

    adapter.InsertCommand = command;

    // Create the UpdateCommand.
    command = new SqlCommand(
        "UPDATE Customers SET CustomerID = @CustomerID, CompanyName = @CompanyName
 " +
        "WHERE CustomerID = @oldCustomerID", connection);

    // Add the parameters for the UpdateCommand.
    command.Parameters.Add("@CustomerID", SqlDbType.NChar, 5, "CustomerID");
    command.Parameters.Add("@CompanyName", SqlDbType.NVarChar, 40, "CompanyName");
    SqlParameter parameter = command.Parameters.Add(
        "@oldCustomerID", SqlDbType.NChar, 5, "CustomerID");
    parameter.SourceVersion = DataRowVersion.Original;

    adapter.UpdateCommand = command;

    // Create the DeleteCommand.
    command = new SqlCommand(
        "DELETE FROM Customers WHERE CustomerID = @CustomerID", connection);

    // Add the parameters for the DeleteCommand.
    parameter = command.Parameters.Add(
        "@CustomerID", SqlDbType.NChar, 5, "CustomerID");
    parameter.SourceVersion = DataRowVersion.Original;

    adapter.DeleteCommand = command;

    return adapter;
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
SqlDataAdapter クラス
SqlDataAdapter メンバ
System.Data.SqlClient 名前空間
その他の技術情報
ADO.NET でのデータの変更
.NET Framework Data Provider for SQL Server の使用