Språk

SqlDataSourceView.Update(IDictionary, IDictionary, IDictionary) Metod

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Utför en uppdateringsåtgärd med sql-strängen UpdateCommand , alla parametrar som finns i UpdateParameters samlingen och de värden som finns i de angivna keys, valuesoch oldValues samlingarna.

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 -> int
Public Function Update (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer

Parametrar

keys
IDictionary

En IDictionary av de primära nycklar som ska användas med UpdateCommand egenskapen för att utföra uppdateringsdatabasåtgärden. Om det inte finns några nycklar som är associerade med frågan eller om det UpdateCommand inte är en parameteriserad SQL-fråga skickar du null.

values
IDictionary

Ett IDictionary värde som ska användas med UpdateCommand egenskapen för att utföra uppdateringsdatabasåtgärden. Om det inte finns några parametrar som är associerade med frågan eller om det UpdateCommand inte är en parameteriserad SQL-fråga skickar du null.

oldValues
IDictionary

En IDictionary som representerar de ursprungliga värdena i databasen. Om det inte finns några parametrar som är associerade med frågan eller om det UpdateCommand inte är en parameteriserad SQL-fråga skickar du null.

Returer

Int32

Ett värde som representerar antalet rader som uppdateras i den underliggande databasen.

Undantag

InvalidOperationException

Det SqlDataSource går inte att upprätta en anslutning till den underliggande datakällan.

NotSupportedException

Egenskapen CanUpdate är false.

Exempel

Följande kodexempel visar hur du använder en SqlDataSource kontroll för att visa data i en DropDownList kontroll och uppdatera data när knappen Skicka klickas. Egenskapen UpdateCommand anges med en parameteriserad SQL-instruktion och två ControlParameter parametrar läggs till i UpdateParameters samlingen. När knappen Skicka klickas OnClick hanteras händelsen för att anropa Update metoden explicit.

<%@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>

Kommentarer

Metoden Update anropar ExecuteUpdate metoden och skickar parametrarna keys, valuesoch oldValues . Mer information finns i SqlDataSource.UpdateCommand.

Gäller för

Se även