SqlDataAdapter Oluşturucular

Başvuru

Tanım

Ad Alanı:: Microsoft.Data.SqlClient

Bütünleştirilmiş Kod:: 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

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Aşırı Yüklemeler

SqlDataAdapter()	SqlDataAdapter sınıfının yeni bir örneğini başlatır.
SqlDataAdapter(SqlCommand)	özelliği olarak belirtilen SqlCommand sınıfın SqlDataAdapter yeni bir örneğini SelectCommand başlatır.
SqlDataAdapter(String, SqlConnection)	ve nesnesiyle SelectCommand sınıfının yeni bir SqlConnection örneğini SqlDataAdapter başlatır.
SqlDataAdapter(String, String)	ve bağlantı dizesiyle SelectCommand sınıfının yeni bir örneğini SqlDataAdapter başlatır.

SqlDataAdapter()

SqlDataAdapter sınıfının yeni bir örneğini başlatır.

public:
 SqlDataAdapter();

public SqlDataAdapter();

Public Sub New ()

Örnekler

Aşağıdaki örnek bir SqlDataAdapter oluşturur ve bazı özelliklerini ayarlar.

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;
}

Açıklamalar

Örneği SqlDataAdapter oluşturulduğunda, aşağıdaki okuma/yazma özellikleri aşağıdaki başlangıç değerlerine ayarlanır.

Özellikler	İlk değer
MissingMappingAction	`MissingMappingAction.Passthrough`
MissingSchemaAction	`MissingSchemaAction.Add`

Özelliğine ayrı bir çağrı aracılığıyla bu özelliklerden herhangi birinin değerini değiştirebilirsiniz.

Şunlara uygulanır

SqlDataAdapter(SqlCommand)

özelliği olarak belirtilen SqlCommand sınıfın SqlDataAdapter yeni bir örneğini SelectCommand başlatır.

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)

Parametreler

selectCommand: SqlCommand

SqlCommand Transact-SQL SELECT deyimi veya saklı yordam olan ve özelliği SqlDataAdapterolarak SelectCommand ayarlanan.

Örnekler

Aşağıdaki örnek bir SqlDataAdapter oluşturur ve bazı özelliklerini ayarlar.

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;
    }
}

Açıklamalar

Oluşturucunun SqlDataAdapter bu uygulaması, özelliğini parametresinde belirtilen değere selectCommand ayarlarSelectCommand.

Örneği SqlDataAdapter oluşturulduğunda, aşağıdaki okuma/yazma özellikleri aşağıdaki başlangıç değerlerine ayarlanır.

Özellikler	İlk değer
MissingMappingAction	`MissingMappingAction.Passthrough`
MissingSchemaAction	`MissingSchemaAction.Add`

Özelliğine ayrı bir çağrı aracılığıyla bu özelliklerden herhangi birinin değerini değiştirebilirsiniz.

Önceden oluşturulmuş SqlCommandbir öğesine (veya diğer komut özelliklerinden herhangi biri) atandığında SelectCommand kopyalanmazSqlCommand. , SelectCommand daha önce oluşturulan SqlCommand nesneye bir başvuru tutar.

Şunlara uygulanır

SqlDataAdapter(String, SqlConnection)

ve nesnesiyle SelectCommand sınıfının yeni bir SqlConnection örneğini SqlDataAdapter başlatır.

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)

Parametreler

selectCommandText: String

String Özelliği tarafından SelectCommand kullanılacak transact-SQL SELECT deyimi veya saklı yordamdırSqlDataAdapter.

selectConnection: SqlConnection

SqlConnection Bağlantıyı temsil eden bir. Bağlantı dizeniz kullanmıyorsa Integrated Security = true, kullanıcı kimliğini ve parolayı bağlantı dizesinde metin olarak belirterek kullanıcı kimliğini ve parolayı daha güvenli bir şekilde geçirmek için kullanabilirsiniz SqlCredential .

Örnekler

Aşağıdaki örnek bir SqlDataAdapter oluşturur ve bazı özelliklerini ayarlar.

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;
    }
}

Açıklamalar

uygulamasının SqlDataAdapter bu uygulaması açılır ve henüz açık değilse kapatılır SqlConnection . Bu, iki veya daha fazla SqlDataAdapter nesne için yöntemini çağırması Fill gereken bir uygulamada yararlı olabilir. SqlConnection zaten açıksa, kapatmak için Kapat veya At'ı açıkça çağırmanız gerekir.

Örneği SqlDataAdapter oluşturulduğunda, aşağıdaki okuma/yazma özellikleri aşağıdaki başlangıç değerlerine ayarlanır.

Özellikler	İlk değer
MissingMappingAction	`MissingMappingAction.Passthrough`
MissingSchemaAction	`MissingSchemaAction.Add`

Özelliğine ayrı bir çağrı aracılığıyla bu özelliklerden birinin değerini değiştirebilirsiniz.

Şunlara uygulanır

SqlDataAdapter(String, String)

ve bağlantı dizesiyle SelectCommand sınıfının yeni bir örneğini SqlDataAdapter başlatır.

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)

Parametreler

selectCommandText: String

String Özelliği tarafından SelectCommand kullanılacak transact-SQL SELECT deyimi veya saklı yordamdırSqlDataAdapter.

selectConnectionString: String

Bağlantı dizesi. Bağlantı dizeniz kullanmıyorsaIntegrated Security = true, kullanıcı SqlCredential kimliği ve parolayı bağlantı dizesinde metin olarak belirterek kullanıcı kimliği ve parolayı daha güvenli bir şekilde geçirmek için ve kullanabilirsinizSqlDataAdapter(String, SqlConnection).

Örnekler

Aşağıdaki örnek bir SqlDataAdapter oluşturur ve bazı özelliklerini ayarlar.

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;
    }
}

Açıklamalar

Oluşturucunun SqlDataAdapter bu aşırı yüklemesi, özelliğini ayarlamak için parametresini SelectCommand kullanırselectCommandText. SqlDataAdapter parametresiyle selectConnectionString oluşturulan bağlantıyı oluşturur ve korur.

Örneği SqlDataAdapter oluşturulduğunda, aşağıdaki okuma/yazma özellikleri aşağıdaki başlangıç değerlerine ayarlanır.

Özellikler	İlk değer
MissingMappingAction	`MissingMappingAction.Passthrough`
MissingSchemaAction	`MissingSchemaAction.Add`

Özelliğine ayrı bir çağrı aracılığıyla bu özelliklerden herhangi birinin değerini değiştirebilirsiniz.

Şunlara uygulanır

Aracılığıyla paylaş

SqlDataAdapter Oluşturucular

Tanım

Aşırı Yüklemeler

SqlDataAdapter()

Örnekler

Açıklamalar

Şunlara uygulanır

SqlDataAdapter(SqlCommand)

Parametreler

Örnekler

Açıklamalar

Şunlara uygulanır

SqlDataAdapter(String, SqlConnection)

Parametreler

Örnekler

Açıklamalar

Şunlara uygulanır

SqlDataAdapter(String, String)

Parametreler

Örnekler

Açıklamalar

Şunlara uygulanır