DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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
Åtgärden ExecuteUpdate(IDictionary, IDictionary, IDictionary) stöds inte av DataSourceView.
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.