SqlDataSourceView.Update(IDictionary, IDictionary, IDictionary) Метод

Определение

Выполняет операцию обновления, используя SQL-строку UpdateCommand, все параметры, имеющиеся в коллекции UpdateParameters, и значения, содержащиеся в заданных коллекциях keys, values и oldValues.Performs an update operation using the UpdateCommand SQL string, any parameters that are in the UpdateParameters collection, and the values that are in the specified keys, values, and oldValues collections.

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

Параметры

keys
IDictionary

Объект IDictionary первичных ключей, используемых вместе со свойством UpdateCommand для выполнения операции обновления базы данных.An IDictionary of primary keys to use with the UpdateCommand property to perform the update database operation. Если с запросом не связан ни один ключ или если свойство UpdateCommand не является параметризованным SQL-запросом, передает значение null.If there are no keys associated with the query or if the UpdateCommand is not a parameterized SQL query, pass null.

values
IDictionary

Объект IDictionary значений, используемых вместе со свойством UpdateCommand для выполнения операции обновления базы данных.An IDictionary of values to use with the UpdateCommand property to perform the update database operation. Если с запросом не связан ни один параметр или если свойство UpdateCommand не является параметризованным SQL-запросом, передает значение null.If there are no parameters associated with the query or if the UpdateCommand is not a parameterized SQL query, pass null.

oldValues
IDictionary

Объект IDictionary, предоставляющий исходные значения в базе данных.An IDictionary that represents the original values in the database. Если с запросом не связан ни один параметр или если свойство UpdateCommand не является параметризованным SQL-запросом, передает значение null.If there are no parameters associated with the query or if the UpdateCommand is not a parameterized SQL query, pass null.

Возвращаемое значение

Значение, представляющее число строк, обновленных в основной базе данных.A value that represents the number of rows updated in the underlying database.

Исключения

Объекту SqlDataSource не удается установить подключение к базовому источнику данных.The SqlDataSource cannot establish a connection with the underlying data source.

Значение свойства CanUpdatefalse.The CanUpdate property is false.

Примеры

В следующем примере кода показано, как использовать SqlDataSource элемент управления для отображения данных DropDownList в элементе управления и обновления данных при нажатии кнопки " Отправить ".The following code example demonstrates how to use a SqlDataSource control to display data in a DropDownList control and update data when the Submit button is clicked. Свойство задается с параметризованной инструкцией SQL и двумя ControlParameter UpdateParameters параметрами добавляются в коллекцию. UpdateCommandThe UpdateCommand property is set with a parameterized SQL statement and two ControlParameter parameters are added to the UpdateParameters collection. При нажатии OnClick кнопки Submit событие Update обрабатывается для явного вызова метода.When the Submit button is clicked, the OnClick event is handled to call the Update method explicitly.

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

Комментарии

keys valuesМетод вызывает метод, передавая параметры, и oldValues. ExecuteUpdate UpdateThe Update method calls the ExecuteUpdate method, passing the keys, values, and oldValues parameters. Для получения дополнительной информации см. SqlDataSource.UpdateCommand.For more information, see SqlDataSource.UpdateCommand.

Применяется к

Дополнительно