Bagikan melalui

SqlDataSourceView.Update(IDictionary, IDictionary, IDictionary) Metode

Definisi

Ruang nama:
System.Web.UI.WebControls
Rakitan:
System.Web.dll

Melakukan operasi pembaruan menggunakan UpdateCommand string SQL, parameter apa pun yang ada dalam UpdateParameters koleksi, dan nilai yang ada dalam koleksi , , valuesdan oldValues yang ditentukankeys.

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

Kunci IDictionary primer yang akan digunakan dengan UpdateCommand properti untuk melakukan operasi database pembaruan. Jika tidak ada kunci yang terkait dengan kueri atau jika UpdateCommand bukan kueri SQL berparameter, lewati null.

values
IDictionary

Nilai IDictionary yang akan digunakan dengan UpdateCommand properti untuk melakukan operasi database pembaruan. Jika tidak ada parameter yang terkait dengan kueri atau jika UpdateCommand bukan kueri SQL berparameter, lewati null.

oldValues
IDictionary

Yang IDictionary mewakili nilai asli dalam database. Jika tidak ada parameter yang terkait dengan kueri atau jika UpdateCommand bukan kueri SQL berparameter, lewati null.

Mengembalikan

Int32

Nilai yang menunjukkan jumlah baris yang diperbarui dalam database yang mendasar.

Pengecualian

InvalidOperationException

SqlDataSource tidak dapat membuat koneksi dengan sumber data yang mendasar.

NotSupportedException

Properti CanUpdate adalah false.

Contoh

Contoh kode berikut menunjukkan cara menggunakan SqlDataSource kontrol untuk menampilkan data dalam DropDownList kontrol dan memperbarui data saat tombol Kirim diklik. Properti UpdateCommand diatur dengan pernyataan SQL berparameter dan dua ControlParameter parameter ditambahkan ke UpdateParameters koleksi. Saat tombol Kirim diklik, peristiwa ditangani OnClick untuk memanggil Update metode secara eksplisit.

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

Keterangan

Metode ini Update memanggil ExecuteUpdate metode , meneruskan keysparameter , values, dan oldValues . Untuk informasi selengkapnya, lihat SqlDataSource.UpdateCommand .

Berlaku untuk

Lihat juga