Proprietà SqlCeDataAdapter.DeleteCommand

Articolo
05/27/2011

Ottiene o imposta un'istruzione SQL per l'eliminazione di record dal set di dati.

Spazio dei nomi System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in System.Data.SqlServerCe.dll)

Sintassi

'Dichiarazione
Public Property DeleteCommand As SqlCeCommand
    Get
    Set
'Utilizzo
Dim instance As SqlCeDataAdapter
Dim value As SqlCeCommand

value = instance.DeleteCommand

instance.DeleteCommand = value

public SqlCeCommand DeleteCommand { get; set; }

public:
property SqlCeCommand^ DeleteCommand {
    SqlCeCommand^ get ();
    void set (SqlCeCommand^ value);
}

member DeleteCommand : SqlCeCommand with get, set

function get DeleteCommand () : SqlCeCommand
function set DeleteCommand (value : SqlCeCommand)

Valore proprietà

Tipo: System.Data.SqlServerCe.SqlCeCommand
Oggetto SqlCeCommand utilizzato durante l'applicazione del metodo Update per eliminare i record nell'origine dati che corrispondono alle righe eliminate nell'oggetto DataSet.

Osservazioni

Durante una chiamata al metodo Update, se la proprietà non è impostata e sono presenti informazioni sulla chiave primaria nell'oggetto DataSet, la proprietà DeleteCommand potrà essere generata automaticamente se si imposta la proprietà SelectCommand e si utilizza l'oggetto SqlCeCommandBuilder. In seguito, qualsiasi comando aggiuntivo non impostato viene generato dalla classe SqlCeCommandBuilder. Questa logica di generazione richiede la presenza di informazioni sulle colonne di chiave primaria nell'oggetto DataSet.

Quando la proprietà DeleteCommand viene assegnata a un oggetto SqlCeCommand precedentemente creato, l'oggetto SqlCeCommand non verrà duplicato. La proprietà DeleteCommand conserva un riferimento all'oggetto SqlCeCommand creato in precedenza.

Esempi

Nell'esempio seguente viene creata una classe SqlCeDataAdapter e ne vengono impostate alcune proprietà.

Dim cmd As SqlCeCommand = Nothing
Dim adp As SqlCeDataAdapter = Nothing

Try
    adp = New SqlCeDataAdapter()
    Dim conn As New SqlCeConnection("Data Source = MyDatabase.sdf")

    ' Create the SelectCommand
    '
    cmd = conn.CreateCommand()
    cmd.CommandText = "SELECT * FROM Orders WHERE [Ship Country] = @country AND [Ship City] = @city"
    cmd.Parameters.Add("@country", SqlDbType.NVarChar, 15)
    cmd.Parameters.Add("@city", SqlDbType.NVarChar, 15)

    cmd.Parameters("@country").Value = "UK"
    cmd.Parameters("@city").Value = "London"

    adp.SelectCommand = cmd

    ' Create the DeleteCommand
    '
    cmd = conn.CreateCommand()
    cmd.CommandText = "DELETE FROM Orders WHERE [Order ID] = @orderID"

    Dim p As SqlCeParameter = cmd.Parameters.Add("@orderID", SqlDbType.NChar, 5, "Order ID")
    p.SourceVersion = DataRowVersion.Original

    adp.DeleteCommand = cmd

    ' Populate the dataset with the results from the SELECT statement
    '
    Dim ds As New DataSet()
    adp.Fill(ds)

    ' Modify the dataset
    '
    MessageBox.Show("Number of rows: " & ds.Tables(0).Rows.Count)

    ' Delete some rows
    '
    ds.Tables(0).Rows(3).Delete()
    ds.Tables(0).Rows(4).Delete()

    ' This will execute two DELETE statements 
    '
    adp.Update(ds.Tables(0))
Catch e As Exception
    MessageBox.Show(e.Message)
Finally
    If Not Nothing Is adp.SelectCommand Then
        adp.SelectCommand.Dispose()
    End If
    If Not Nothing Is adp.DeleteCommand Then
        adp.DeleteCommand.Dispose()
    End If
End Try

SqlCeCommand cmd = null;
SqlCeDataAdapter adp = null;

try
{
    adp = new SqlCeDataAdapter();
    SqlCeConnection conn = new SqlCeConnection("Data Source = MyDatabase.sdf");

    // Create the SelectCommand
    //
    cmd = conn.CreateCommand();
    cmd.CommandText = "SELECT * FROM Orders WHERE [Ship Country] = @country AND [Ship City] = @city";
    cmd.Parameters.Add("@country", SqlDbType.NVarChar, 15);
    cmd.Parameters.Add("@city", SqlDbType.NVarChar, 15);

    cmd.Parameters["@country"].Value = "UK";
    cmd.Parameters["@city"].Value = "London";

    adp.SelectCommand = cmd;

    // Create the DeleteCommand
    //
    cmd = conn.CreateCommand();
    cmd.CommandText = "DELETE FROM Orders WHERE [Order ID] = @orderID";

    SqlCeParameter p = cmd.Parameters.Add("@orderID", SqlDbType.NChar, 5, "Order ID");
    p.SourceVersion = DataRowVersion.Original;

    adp.DeleteCommand = cmd;

    // Populate the dataset with the results from the SELECT statement
    //
    DataSet ds = new DataSet();
    adp.Fill(ds);

    // Modify the dataset
    //
    MessageBox.Show("Number of rows: " + ds.Tables[0].Rows.Count);

    // Delete some rows
    //
    ds.Tables[0].Rows[3].Delete();
    ds.Tables[0].Rows[4].Delete();

    // This will execute two DELETE statements 
    //
    adp.Update(ds.Tables[0]);
}
catch (Exception e)
{
    MessageBox.Show(e.Message);
}
finally
{
    if (null != adp.SelectCommand) adp.SelectCommand.Dispose();
    if (null != adp.DeleteCommand) adp.DeleteCommand.Dispose();
}

Vedere anche

Riferimento

SqlCeDataAdapter Classe

Spazio dei nomi System.Data.SqlServerCe

InsertCommand

SelectCommand

UpdateCommand

Condividi tramite