IDbDataAdapter.UpdateCommand Tulajdonság

Definíció

Névtér:

System.Data

Szerelvények:

netstandard.dll, System.Data.Common.dll

Forrás:

IDbDataAdapter.cs

Lekéri vagy beállítja az adatforrás rekordjainak frissítéséhez használt SQL-utasítást.

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

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

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

Public Property UpdateCommand As IDbCommand

Tulajdonság értéke

IDbCommand

Az IDbCommand adatforrás rekordjainak frissítéséhez használt Update(DataSet) adathalmaz módosított soraihoz.

Példák

Az alábbi példa létrehozza az örökölt osztály egy példányátOleDbDataAdapter, és beállítja a SelectCommand tulajdonságokat.UpdateCommand Feltételezi, hogy már létrehozott egy OleDbConnection objektumot.

private static OleDbDataAdapter CreateCustomerAdapter(
    OleDbConnection connection)
{
    OleDbDataAdapter dataAdapter = new OleDbDataAdapter();
    OleDbCommand command;
    OleDbParameter parameter;

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

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

    dataAdapter.SelectCommand = command;

    // Create the UpdateCommand.
    command = new OleDbCommand(
        "UPDATE dbo.Customers SET CustomerID = ?, CompanyName = ? " +
        "WHERE CustomerID = ?", connection);

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

    parameter = command.Parameters.Add(
        "oldCustomerID", OleDbType.Char, 5, "CustomerID");
    parameter.SourceVersion = DataRowVersion.Original;

    dataAdapter.UpdateCommand = command;

    return dataAdapter;
}

Private Function CreateCustomerAdapter( _
    ByVal connection As OleDbConnection) As OleDbDataAdapter

    Dim dataAdapter As New OleDbDataAdapter()
    Dim command As OleDbCommand
    Dim parameter As OleDbParameter

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

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

    dataAdapter.SelectCommand = command

    ' Create the UpdateCommand.
    command = New OleDbCommand("UPDATE dbo.Customers " & _
        "SET CustomerID = ?, CompanyName = ? " & _
        "WHERE CustomerID = ?", connection)

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

    parameter = command.Parameters.Add( _
        "oldCustomerID", OleDbType.Char, 5, "CustomerID")
    parameter.SourceVersion = DataRowVersion.Original

    dataAdapter.UpdateCommand = command

    Return dataAdapter
End Function

Megjegyzések

A Update során, ha ez a tulajdonság nincs beállítva, és az elsődleges kulcs információi megtalálhatók a DataSet, a UpdateCommand automatikusan létrejön, ha beállítja egy .NET-keretrendszer adatszolgáltatójának SelectCommand tulajdonságát. Ezután a nem beállított további parancsokat a CommandBuilder hozza létre. Ez a generációs logika megköveteli, hogy a kulcsoszlopok adatai szerepeljenek a DataSet. További információ: Parancsok generálása CommandBuilders használatával.

Ha UpdateCommand egy korábban létrehozotthoz IDbCommandvan rendelve, a IDbCommand rendszer nem klónozza. A UpdateCommand korábban létrehozott IDbCommand objektumra mutató hivatkozást tart fenn.

Note

Ha ennek a parancsnak a végrehajtása sorokat ad vissza, a program hozzáadja ezeket a sorokat a DataSet.