Freigeben über

SqlDataSourceView.Update(IDictionary, IDictionary, IDictionary) Methode

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Führt einen Aktualisierungsvorgang mit der UpdateCommand SQL-Zeichenfolge, allen Parametern in der UpdateParameters Auflistung und den Werten aus, die sich in den angegebenen keys, valuesund oldValues Auflistungen befinden.

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

Parameter

keys
IDictionary

Ein IDictionary Primärschlüssel, der mit der UpdateCommand Eigenschaft zum Ausführen des Aktualisierungsdatenbankvorgangs verwendet werden soll. Wenn der Abfrage keine Schlüssel zugeordnet sind oder wenn es UpdateCommand sich nicht um eine parametrisierte SQL-Abfrage handelt, übergeben nullSie .

values
IDictionary

Ein IDictionary Wert, der mit der UpdateCommand Eigenschaft zum Ausführen des Aktualisierungsdatenbankvorgangs verwendet werden soll. Wenn der Abfrage keine Parameter zugeordnet sind oder wenn es UpdateCommand sich nicht um eine parametrisierte SQL-Abfrage handelt, übergeben Sie null.

oldValues
IDictionary

Ein IDictionary Wert, der die ursprünglichen Werte in der Datenbank darstellt. Wenn der Abfrage keine Parameter zugeordnet sind oder wenn es UpdateCommand sich nicht um eine parametrisierte SQL-Abfrage handelt, übergeben Sie null.

Gibt zurück

Int32

Ein Wert, der die Anzahl der Zeilen darstellt, die in der zugrunde liegenden Datenbank aktualisiert wurden.

Ausnahmen

InvalidOperationException

Die SqlDataSource Verbindung mit der zugrunde liegenden Datenquelle kann nicht hergestellt werden.

NotSupportedException

Die CanUpdate Eigenschaft ist false.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe eines SqlDataSource Steuerelements Daten in einem DropDownList Steuerelement anzeigen und Daten aktualisieren können, wenn auf die Schaltfläche " Absenden " geklickt wird. Die UpdateCommand Eigenschaft wird mit einer parametrisierten SQL-Anweisung festgelegt, und der Auflistung werden zwei ControlParameter Parameter hinzugefügt UpdateParameters . Wenn auf die Schaltfläche " Absenden " geklickt wird, wird das OnClick Ereignis behandelt, um die Update Methode explizit aufzurufen.

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

Hinweise

Die Update Methode ruft die ExecuteUpdate Methode auf, und übergeben Sie die keysParameter values.oldValues Weitere Informationen finden Sie unter SqlDataSource.UpdateCommand.

Gilt für:

Weitere Informationen