SqlDataSourceView.Update(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 met behulp van de UpdateCommand SQL-tekenreeks, parameters in de UpdateParameters verzameling en de waarden die zich in de opgegeven keys, valuesen oldValues verzamelingen bevinden.
public:
int Update(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);public int Update(System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);override this.Update : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> intPublic Function Update (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As IntegerParameters
- keys
- IDictionary
Een IDictionary van de primaire sleutels die moeten worden gebruikt met de UpdateCommand eigenschap om de updatedatabasebewerking uit te voeren. Als er geen sleutels zijn gekoppeld aan de query of als het UpdateCommand geen geparameteriseerde SQL-query is, geeft u deze nulldoor.
- values
- IDictionary
Een IDictionary van de waarden die moeten worden gebruikt met de UpdateCommand eigenschap om de updatedatabasebewerking uit te voeren. Als er geen parameters zijn gekoppeld aan de query of als het UpdateCommand geen geparameteriseerde SQL-query is, geeft u deze door null.
- oldValues
- IDictionary
Een IDictionary die de oorspronkelijke waarden in de database vertegenwoordigt. Als er geen parameters zijn gekoppeld aan de query of als het UpdateCommand geen geparameteriseerde SQL-query is, geeft u deze door null.
Retouren
Een waarde die het aantal rijen aangeeft dat is bijgewerkt in de onderliggende database.
Uitzonderingen
Er SqlDataSource kan geen verbinding worden tot stand gebracht met de onderliggende gegevensbron.
De eigenschap CanUpdate is false.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u een SqlDataSource besturingselement gebruikt om gegevens in een DropDownList besturingselement weer te geven en gegevens bij te werken wanneer op de knop Verzenden wordt geklikt. De UpdateCommand eigenschap wordt ingesteld met een geparameteriseerde SQL-instructie en er worden twee ControlParameter parameters toegevoegd aan de UpdateParameters verzameling. Wanneer op de knop Verzenden wordt geklikt, wordt de OnClick gebeurtenis verwerkt om de Update methode expliciet aan te roepen.
<%@Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
private void On_Click(Object source, EventArgs e) {
try {
SqlDataSource1.Update();
}
catch (Exception except) {
// Handle the Exception.
}
Label2.Text="The record was updated successfully!";
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:SqlDataSource
id="SqlDataSource1"
runat="server"
ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
SelectCommand="SELECT EmployeeID, LastName, Address FROM Employees"
UpdateCommand="UPDATE Employees SET Address=@Address WHERE EmployeeID=@EmployeeID">
<UpdateParameters>
<asp:ControlParameter Name="Address" ControlId="TextBox1" PropertyName="Text"/>
<asp:ControlParameter Name="EmployeeID" ControlId="DropDownList1" PropertyName="SelectedValue"/>
</UpdateParameters>
</asp:SqlDataSource>
<asp:DropDownList
id="DropDownList1"
runat="server"
DataTextField="LastName"
DataValueField="EmployeeID"
DataSourceID="SqlDataSource1">
</asp:DropDownList>
<br />
<asp:Label id="Label1" runat="server" Text="Enter a new address for the selected user."
AssociatedControlID="TextBox1" />
<asp:TextBox id="TextBox1" runat="server" />
<asp:Button id="Submit" runat="server" Text="Submit" OnClick="On_Click" />
<br /><asp:Label id="Label2" runat="server" Text="" />
</form>
</body>
</html>
<%@Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub On_Click(ByVal source As Object, ByVal e As EventArgs)
Try
SqlDataSource1.Update()
Catch except As Exception
' Handle the Exception.
End Try
Label2.Text="The record was updated successfully!"
End Sub 'On_Click
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:SqlDataSource
id="SqlDataSource1"
runat="server"
ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
SelectCommand="SELECT EmployeeID, LastName, Address FROM Employees"
UpdateCommand="UPDATE Employees SET Address=@Address WHERE EmployeeID=@EmployeeID">
<UpdateParameters>
<asp:ControlParameter Name="Address" ControlId="TextBox1" PropertyName="Text"/>
<asp:ControlParameter Name="EmployeeID" ControlId="DropDownList1" PropertyName="SelectedValue"/>
</UpdateParameters>
</asp:SqlDataSource>
<asp:DropDownList
id="DropDownList1"
runat="server"
DataTextField="LastName"
DataValueField="EmployeeID"
DataSourceID="SqlDataSource1">
</asp:DropDownList>
<br />
<asp:Label id="Label1" runat="server" Text="Enter a new address for the selected user."
AssociatedControlID="TextBox1" />
<asp:TextBox id="TextBox1" runat="server" />
<asp:Button id="Submit" runat="server" Text="Submit" OnClick="On_Click" />
<br /><asp:Label id="Label2" runat="server" Text="" />
</form>
</body>
</html>
Opmerkingen
De Update methode roept de ExecuteUpdate methode aan, waarbij de keys, valuesen oldValues parameters worden doorgegeven. Zie SqlDataSource.UpdateCommand voor meer informatie.
