DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Voert een updatebewerking uit op de lijst met gegevens die het DataSourceView object vertegenwoordigt.
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 -> intProtected Overridable Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As IntegerParameters
- keys
- IDictionary
Een IDictionary object- of rijsleutel die moet worden bijgewerkt door de updatebewerking.
- values
- IDictionary
Een IDictionary van naam-/waardeparen die gegevenselementen en hun nieuwe waarden vertegenwoordigen.
- oldValues
- IDictionary
Een IDictionary van naam-/waardeparen die gegevenselementen en de oorspronkelijke waarden vertegenwoordigen.
Retouren
Het aantal items dat is bijgewerkt in de onderliggende gegevensopslag.
Uitzonderingen
De ExecuteUpdate(IDictionary, IDictionary, IDictionary) bewerking wordt niet ondersteund door de DataSourceView.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe een klasse die de DataSourceView klasse uitbreidt, de CanUpdate eigenschap en de ExecuteUpdate methode kan overschrijven. Dit codevoorbeeld maakt deel uit van een groter voorbeeld voor de DataSourceView klasse.
// 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
Opmerkingen
Met gegevensgebonden besturingselementen kunt u bepalen of de ExecuteUpdate bewerking wordt ondersteund door een besturingselement voor gegevensbronnen met behulp van de DataSourceControl.GetView methode om het DataSourceView object op te halen en de waarde van de CanUpdate eigenschap te controleren.
De keys parameter vertegenwoordigt de object- of rijsleutels van de gegevens die moeten worden bijgewerkt. Voor gegevensbronnen die relationele gegevens vertegenwoordigen, zoals het SqlDataSource besturingselement, is de keys parameter een verzameling primaire databasesleutels. In andere scenario's is de keys parameter een verzameling naam-/waardeparen en wordt gebruikt om een lijst met gegevens te filteren. Alle gegevens die overeenkomen met een naam/waardepaar worden bijgewerkt met de waarden in de values parameter. Dit is een set naam-/waardeparen die nieuwe waarden vertegenwoordigt voor bestaande velden of kolommen.
Note
De standaardimplementatie van de DataSourceView klasse is het genereren van een NotSupportedException uitzondering. Als u de DataSourceView klasse uitbreidt, overschrijft u de ExecuteUpdate methode als uw klasse ondersteuning biedt voor het bijwerken van gegevens in de onderliggende gegevensopslag.
