DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Metod

Definition

Utför en uppdateringsåtgärd i listan över data som DataSourceView objektet representerar.

protected:
 virtual int ExecuteUpdate(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);
protected virtual int ExecuteUpdate(System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);
abstract member ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
override this.ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
Protected Overridable Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer

Parametrar

keys
IDictionary

Ett IDictionary objekt eller radnycklar som ska uppdateras av uppdateringsåtgärden.

values
IDictionary

Ett IDictionary namn/värde-par som representerar dataelement och deras nya värden.

oldValues
IDictionary

Ett IDictionary namn/värde-par som representerar dataelement och deras ursprungliga värden.

Returer

Antalet objekt som uppdaterades i den underliggande datalagringen.

Undantag

Exempel

Följande kodexempel visar hur en klass som utökar DataSourceView klassen kan åsidosätta CanUpdate egenskapen och ExecuteUpdate metoden. Det här kodexemplet är en del av ett större exempel för DataSourceView klassen.

// The CsvDataSourceView does not currently
// permit update operations. You can modify or
// extend this sample to do so.
public override bool CanUpdate {
    get {
        return false;
    }
}
protected override int ExecuteUpdate(IDictionary keys, IDictionary values, IDictionary oldValues)
{
    throw new NotSupportedException();
}
   ' The CsvDataSourceView does not currently
   ' permit update operations. You can modify or
   ' extend this sample to do so.
   Public Overrides ReadOnly Property CanUpdate() As Boolean
      Get
         Return False
      End Get
   End Property

   Protected Overrides Function ExecuteUpdate(keys As IDictionary, _
                                              values As IDictionary, _
                                              oldValues As IDictionary) As Integer
      Throw New NotSupportedException()
   End Function 'ExecuteUpdate

End Class

Kommentarer

Databundna kontroller kan avgöra om ExecuteUpdate åtgärden stöds av en datakällakontroll med hjälp DataSourceControl.GetView av metoden för att hämta DataSourceView objektet och kontrollera värdet för CanUpdate egenskapen.

Parametern keys representerar objekt- eller radnycklarna för de data som ska uppdateras. För datakällor som representerar relationsdata, till exempel SqlDataSource kontrollen, är parametern keys en samling primära databasnycklar. I andra scenarier är parametern keys en samling namn/värde-par och används för att filtrera en lista med data. Alla data som matchar ett namn/värde-par uppdateras med värdena som finns i parametern values , vilket är en uppsättning namn/värde-par som representerar nya värden för befintliga fält eller kolumner.

Note

Klassens DataSourceView standardimplementering är att utlösa ett NotSupportedException undantag. Om du utökar DataSourceView klassen åsidosätter ExecuteUpdate du metoden om klassen stöder uppdatering av data i den underliggande datalagringen.

Gäller för

Se även