SqlDataAdapter Konstruktor

Referensi

Definisi

Ruang nama:: Microsoft.Data.SqlClient

Rakitan:: Microsoft.Data.SqlClient.dll

Paket:: Microsoft.Data.SqlClient v1.0.19269.1

Paket:: Microsoft.Data.SqlClient v1.1.4

Paket:: Microsoft.Data.SqlClient v2.0.1

Paket:: Microsoft.Data.SqlClient v2.1.4

Paket:: Microsoft.Data.SqlClient v3.0.1

Paket:: Microsoft.Data.SqlClient v3.1.0

Paket:: Microsoft.Data.SqlClient v4.0.1

Paket:: Microsoft.Data.SqlClient v4.1.0

Paket:: Microsoft.Data.SqlClient v5.0.0

Paket:: Microsoft.Data.SqlClient v5.1.0

Paket:: Microsoft.Data.SqlClient v5.2.0

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.

Overload

SqlDataAdapter()	Menginisialisasi instans baru kelas SqlDataAdapter.
SqlDataAdapter(SqlCommand)	Menginisialisasi instans SqlDataAdapter baru kelas dengan yang ditentukan SqlCommand sebagai SelectCommand properti .
SqlDataAdapter(String, SqlConnection)	Menginisialisasi instans SqlDataAdapter baru kelas dengan SelectCommand objek dan SqlConnection .
SqlDataAdapter(String, String)	Menginisialisasi instans SqlDataAdapter baru kelas dengan SelectCommand string koneksi dan .

SqlDataAdapter()

Menginisialisasi instans baru kelas SqlDataAdapter.

public:
 SqlDataAdapter();

public SqlDataAdapter ();

Public Sub New ()

Contoh

Contoh berikut membuat SqlDataAdapter dan mengatur beberapa propertinya.

public static SqlDataAdapter CreateSqlDataAdapter(SqlConnection connection)
{
    // Assumes that connection is a valid SqlConnection object
    SqlDataAdapter adapter = new SqlDataAdapter();
    adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;

    // Create the commands.
    adapter.SelectCommand = new SqlCommand(
        "SELECT CustomerID, CompanyName FROM CUSTOMERS", connection);
    adapter.InsertCommand = new SqlCommand(
        "INSERT INTO Customers (CustomerID, CompanyName) " +
        "VALUES (@CustomerID, @CompanyName)", connection);
    adapter.UpdateCommand = new SqlCommand(
        "UPDATE Customers SET CustomerID = @CustomerID, CompanyName = @CompanyName " +
        "WHERE CustomerID = @oldCustomerID", connection);
    adapter.DeleteCommand = new SqlCommand(
        "DELETE FROM Customers WHERE CustomerID = @CustomerID", connection);

    // Create the parameters.
    adapter.InsertCommand.Parameters.Add("@CustomerID",
        SqlDbType.Char, 5, "CustomerID");
    adapter.InsertCommand.Parameters.Add("@CompanyName",
        SqlDbType.VarChar, 40, "CompanyName");

    adapter.UpdateCommand.Parameters.Add("@CustomerID",
        SqlDbType.Char, 5, "CustomerID");
    adapter.UpdateCommand.Parameters.Add("@CompanyName",
        SqlDbType.VarChar, 40, "CompanyName");
    adapter.UpdateCommand.Parameters.Add("@oldCustomerID",
        SqlDbType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    adapter.DeleteCommand.Parameters.Add("@CustomerID",
        SqlDbType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    return adapter;
}

Keterangan

Saat instans SqlDataAdapter dibuat, properti baca/tulis berikut diatur ke nilai awal berikut.

Properti	Nilai awal
MissingMappingAction	`MissingMappingAction.Passthrough`
MissingSchemaAction	`MissingSchemaAction.Add`

Anda dapat mengubah nilai salah satu properti ini melalui panggilan terpisah ke properti .

Berlaku untuk

SqlDataAdapter(SqlCommand)

Menginisialisasi instans SqlDataAdapter baru kelas dengan yang ditentukan SqlCommand sebagai SelectCommand properti .

public:
 SqlDataAdapter(Microsoft::Data::SqlClient::SqlCommand ^ selectCommand);

public SqlDataAdapter (Microsoft.Data.SqlClient.SqlCommand selectCommand);

new Microsoft.Data.SqlClient.SqlDataAdapter : Microsoft.Data.SqlClient.SqlCommand -> Microsoft.Data.SqlClient.SqlDataAdapter

Public Sub New (selectCommand As SqlCommand)

Parameter

selectCommand: SqlCommand

SqlCommand yang merupakan pernyataan T-SQL SELECT atau prosedur tersimpan dan ditetapkan sebagai SelectCommand properti dari SqlDataAdapter.

Contoh

Contoh berikut membuat SqlDataAdapter dan mengatur beberapa propertinya.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
    }
    public static SqlDataAdapter CreateSqlDataAdapter(SqlCommand selectCommand,
        SqlConnection connection)
    {
        SqlDataAdapter adapter = new SqlDataAdapter(selectCommand);
        adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;

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

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

        adapter.DeleteCommand = new SqlCommand(
            "DELETE FROM Customers WHERE CustomerID = @CustomerID", connection);

        // Create the parameters.
        adapter.InsertCommand.Parameters.Add("@CustomerID",
            SqlDbType.Char, 5, "CustomerID");
        adapter.InsertCommand.Parameters.Add("@CompanyName",
            SqlDbType.VarChar, 40, "CompanyName");

        adapter.UpdateCommand.Parameters.Add("@CustomerID",
            SqlDbType.Char, 5, "CustomerID");
        adapter.UpdateCommand.Parameters.Add("@CompanyName",
            SqlDbType.VarChar, 40, "CompanyName");
        adapter.UpdateCommand.Parameters.Add("@oldCustomerID",
            SqlDbType.Char, 5, "CustomerID").SourceVersion = DataRowVersion.Original;

        adapter.DeleteCommand.Parameters.Add("@CustomerID",
            SqlDbType.Char, 5, "CustomerID").SourceVersion = DataRowVersion.Original;

        return adapter;
    }
}

Keterangan

Implementasi SqlDataAdapter konstruktor ini mengatur SelectCommand properti ke nilai yang ditentukan dalam selectCommand parameter .

Saat instans SqlDataAdapter dibuat, properti baca/tulis berikut diatur ke nilai awal berikut.

Properti	Nilai awal
MissingMappingAction	`MissingMappingAction.Passthrough`
MissingSchemaAction	`MissingSchemaAction.Add`

Anda dapat mengubah nilai salah satu properti ini melalui panggilan terpisah ke properti .

Ketika SelectCommand (atau salah satu properti perintah lainnya) ditetapkan ke yang dibuat SqlCommandsebelumnya , SqlCommand tidak dikloning. SelectCommand mempertahankan referensi ke objek yang dibuat SqlCommand sebelumnya.

Berlaku untuk

SqlDataAdapter(String, SqlConnection)

Menginisialisasi instans SqlDataAdapter baru kelas dengan SelectCommand objek dan SqlConnection .

public:
 SqlDataAdapter(System::String ^ selectCommandText, Microsoft::Data::SqlClient::SqlConnection ^ selectConnection);

public SqlDataAdapter (string selectCommandText, Microsoft.Data.SqlClient.SqlConnection selectConnection);

new Microsoft.Data.SqlClient.SqlDataAdapter : string * Microsoft.Data.SqlClient.SqlConnection -> Microsoft.Data.SqlClient.SqlDataAdapter

Public Sub New (selectCommandText As String, selectConnection As SqlConnection)

Parameter

selectCommandText: String

String yang merupakan pernyataan T-SQL SELECT atau prosedur tersimpan yang akan digunakan oleh SelectCommand properti dari SqlDataAdapter.

selectConnection: SqlConnection

SqlConnection yang mewakili koneksi. Jika string koneksi Anda tidak menggunakan Integrated Security = true, Anda dapat menggunakan SqlCredential untuk meneruskan ID pengguna dan kata sandi dengan lebih aman daripada dengan menentukan ID pengguna dan kata sandi sebagai teks dalam string koneksi.

Contoh

Contoh berikut membuat SqlDataAdapter dan mengatur beberapa propertinya.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
    }
    public static SqlDataAdapter CreateSqlDataAdapter(string commandText,
        SqlConnection connection)
    {
        SqlDataAdapter adapter = new SqlDataAdapter(commandText, connection);

        adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;

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

        adapter.UpdateCommand = new SqlCommand(
            "UPDATE Customers SET CustomerID = @CustomerID, CompanyName = @CompanyName " +
            "WHERE CustomerID = @oldCustomerID");

        adapter.DeleteCommand = new SqlCommand(
            "DELETE FROM Customers WHERE CustomerID = @CustomerID");

        // Create the parameters.
        adapter.InsertCommand.Parameters.Add("@CustomerID",
            SqlDbType.Char, 5, "CustomerID");
        adapter.InsertCommand.Parameters.Add("@CompanyName",
            SqlDbType.VarChar, 40, "CompanyName");

        adapter.UpdateCommand.Parameters.Add("@CustomerID",
            SqlDbType.Char, 5, "CustomerID");
        adapter.UpdateCommand.Parameters.Add("@CompanyName",
            SqlDbType.VarChar, 40, "CompanyName");
        adapter.UpdateCommand.Parameters.Add("@oldCustomerID",
            SqlDbType.Char, 5, "CustomerID").SourceVersion = DataRowVersion.Original;

        adapter.DeleteCommand.Parameters.Add("@CustomerID",
            SqlDbType.Char, 5, "CustomerID").SourceVersion = DataRowVersion.Original;

        return adapter;
    }
}

Keterangan

Implementasi SqlDataAdapter terbuka ini dan menutup SqlConnection jika belum terbuka. Ini dapat berguna dalam aplikasi yang harus memanggil Fill metode untuk dua objek atau lebih SqlDataAdapter . SqlConnection Jika sudah terbuka, Anda harus secara eksplisit memanggil Tutup atau Buang untuk menutupnya.

Saat instans SqlDataAdapter dibuat, properti baca/tulis berikut diatur ke nilai awal berikut.

Properti	Nilai awal
MissingMappingAction	`MissingMappingAction.Passthrough`
MissingSchemaAction	`MissingSchemaAction.Add`

Anda dapat mengubah nilai salah satu properti ini melalui panggilan terpisah ke properti .

Berlaku untuk

SqlDataAdapter(String, String)

Menginisialisasi instans SqlDataAdapter baru kelas dengan SelectCommand string koneksi dan .

public:
 SqlDataAdapter(System::String ^ selectCommandText, System::String ^ selectConnectionString);

public SqlDataAdapter (string selectCommandText, string selectConnectionString);

new Microsoft.Data.SqlClient.SqlDataAdapter : string * string -> Microsoft.Data.SqlClient.SqlDataAdapter

Public Sub New (selectCommandText As String, selectConnectionString As String)

Parameter

selectCommandText: String

String yang merupakan pernyataan T-SQL SELECT atau prosedur tersimpan yang akan digunakan oleh SelectCommand properti dari SqlDataAdapter.

selectConnectionString: String

String koneksi. Jika string koneksi Anda tidak menggunakan Integrated Security = true, Anda dapat menggunakan SqlDataAdapter(String, SqlConnection) dan SqlCredential untuk meneruskan ID pengguna dan kata sandi dengan lebih aman daripada dengan menentukan ID pengguna dan kata sandi sebagai teks dalam string koneksi.

Contoh

Contoh berikut membuat SqlDataAdapter dan mengatur beberapa propertinya.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
    }
    public static SqlDataAdapter CreateSqlDataAdapter(string commandText,
        string connectionString)
    {
        SqlDataAdapter adapter = new SqlDataAdapter(commandText, connectionString);
        SqlConnection connection = adapter.SelectCommand.Connection;

        adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;

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

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

        adapter.DeleteCommand = new SqlCommand(
            "DELETE FROM Customers WHERE CustomerID = @CustomerID", connection);

        // Create the parameters.
        adapter.InsertCommand.Parameters.Add("@CustomerID",
            SqlDbType.Char, 5, "CustomerID");
        adapter.InsertCommand.Parameters.Add("@CompanyName",
            SqlDbType.VarChar, 40, "CompanyName");

        adapter.UpdateCommand.Parameters.Add("@CustomerID",
            SqlDbType.Char, 5, "CustomerID");
        adapter.UpdateCommand.Parameters.Add("@CompanyName",
            SqlDbType.VarChar, 40, "CompanyName");
        adapter.UpdateCommand.Parameters.Add("@oldCustomerID",
            SqlDbType.Char, 5, "CustomerID").SourceVersion = DataRowVersion.Original;

        adapter.DeleteCommand.Parameters.Add("@CustomerID",
            SqlDbType.Char, 5, "CustomerID").SourceVersion = DataRowVersion.Original;

        return adapter;
    }
}

Keterangan

Kelebihan beban SqlDataAdapter konstruktor ini menggunakan selectCommandText parameter untuk mengatur SelectCommand properti . SqlDataAdapter akan membuat dan memelihara koneksi yang dibuat dengan selectConnectionString parameter .

Saat instans SqlDataAdapter dibuat, properti baca/tulis berikut diatur ke nilai awal berikut.

Properti	Nilai awal
MissingMappingAction	`MissingMappingAction.Passthrough`
MissingSchemaAction	`MissingSchemaAction.Add`

Anda dapat mengubah nilai salah satu properti ini melalui panggilan terpisah ke properti .

Berlaku untuk

Bagikan melalui

SqlDataAdapter Konstruktor

Definisi

Overload

SqlDataAdapter()

Contoh

Keterangan

Berlaku untuk

SqlDataAdapter(SqlCommand)

Parameter

Contoh

Keterangan

Berlaku untuk

SqlDataAdapter(String, SqlConnection)

Parameter

Contoh

Keterangan

Berlaku untuk

SqlDataAdapter(String, String)

Parameter

Contoh

Keterangan

Berlaku untuk

Sumber Daya Tambahan: