IDbDataAdapter.InsertCommand Properti

Referensi

Definisi

Ruang nama:: System.Data

Rakitan:: System.Data.Common.dll

Rakitan:: System.Data.dll

Rakitan:: netstandard.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan atau mengatur pernyataan SQL yang digunakan untuk menyisipkan rekaman baru ke dalam sumber data.

public:
 property System::Data::IDbCommand ^ InsertCommand { System::Data::IDbCommand ^ get(); void set(System::Data::IDbCommand ^ value); };

public System.Data.IDbCommand? InsertCommand { get; set; }

public System.Data.IDbCommand InsertCommand { get; set; }

member this.InsertCommand : System.Data.IDbCommand with get, set

Public Property InsertCommand As IDbCommand

Nilai Properti

IDbCommand

Yang IDbCommand digunakan selama Update(DataSet) menyisipkan rekaman di sumber data untuk baris baru dalam himpunan data.

Contoh

Contoh berikut membuat instans kelas yang diwariskan OleDbDataAdapter , dan mengatur SelectCommand properti dan InsertCommand . Ini mengasumsikan Anda telah membuat OleDbConnection objek.

public static OleDbDataAdapter CreateCustomerAdapter(
    OleDbConnection connection)
{
    OleDbDataAdapter adapter = new OleDbDataAdapter();
    OleDbCommand command;

    // Create the SelectCommand.
    command = new OleDbCommand("SELECT CustomerID FROM Customers " +
        "WHERE Country = ? AND City = ?", connection);

    command.Parameters.Add("Country", OleDbType.VarChar, 15);
    command.Parameters.Add("City", OleDbType.VarChar, 15);

    adapter.SelectCommand = command;

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

    command.Parameters.Add(
        "CustomerID", OleDbType.Char, 5, "CustomerID");
    command.Parameters.Add(
        "CompanyName", OleDbType.VarChar, 40, "CompanyName");

    adapter.InsertCommand = command;
    return adapter;
}

Public Shared Function CreateCustomerAdapter( _
    connection As OleDbConnection) As OleDbDataAdapter 
  
    Dim adapter As New OleDbDataAdapter()
    Dim command As OleDbCommand

    ' Create the SelectCommand.
    command = New OleDbCommand("SELECT CustomerID FROM Customers " & _
        "WHERE Country = ? AND City = ?", connection)

    command.Parameters.Add("Country", OleDbType.VarChar, 15)
    command.Parameters.Add("City", OleDbType.VarChar, 15)

    adapter.SelectCommand = command

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

    command.Parameters.Add( _
        "CustomerID", OleDbType.Char, 5, "CustomerID")
    command.Parameters.Add( _
        "CompanyName", OleDbType.VarChar, 40, "CompanyName")

    adapter.InsertCommand = command
    Return adapter
End Function

Keterangan

Selama Update, jika properti ini tidak diatur dan informasi kunci primer ada di DataSet, InsertCommand dapat dihasilkan secara otomatis jika Anda mengatur SelectCommand properti penyedia data .NET Framework. Kemudian, perintah tambahan apa pun yang tidak Anda tetapkan dihasilkan oleh CommandBuilder. Logika generasi ini memerlukan informasi kolom kunci untuk hadir di DataSet. Untuk informasi selengkapnya, lihat Membuat Perintah dengan CommandBuilders.

Ketika InsertCommand ditetapkan ke yang dibuat IDbCommandsebelumnya , IDbCommand tidak dikloning. InsertCommand mempertahankan referensi ke objek yang dibuat IDbCommand sebelumnya.

Catatan

Jika eksekusi perintah ini mengembalikan baris, baris ini dapat ditambahkan ke DataSet bergantung pada cara Anda mengatur UpdatedRowSource properti IDbCommand objek.

Berlaku untuk

Bagikan melalui