SqlDataSourceView.Update(IDictionary, IDictionary, IDictionary) Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

SQL dizesini UpdateCommand , koleksiyondaki UpdateParameters tüm parametreleri ve belirtilen keys, valuesve oldValues koleksiyonlarındaki değerleri kullanarak bir güncelleştirme işlemi gerçekleştirir.

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

Parametreler

keys
IDictionary

IDictionary Güncelleştirme veritabanı işlemini gerçekleştirmek için özelliğiyle UpdateCommand kullanılacak birincil anahtarlardan biri. Sorguyla ilişkilendirilmiş anahtar yoksa veya parametresiz bir SQL sorgusu değilse UpdateCommand geçirin null.

values
IDictionary

Güncelleştirme veritabanı işlemini gerçekleştirmek için özelliğiyle UpdateCommand kullanılacak değerlerden biriIDictionary. Sorguyla ilişkilendirilmiş parametre yoksa veya parametresiz bir SQL sorgusu değilse UpdateCommand , geçirin null.

oldValues
IDictionary

IDictionary Veritabanındaki özgün değerleri temsil eden bir. Sorguyla ilişkilendirilmiş parametre yoksa veya parametresiz bir SQL sorgusu değilse UpdateCommand , geçirin null.

Döndürülenler

Int32

Temel alınan veritabanında güncelleştirilen satır sayısını temsil eden bir değer.

Özel durumlar

InvalidOperationException

, SqlDataSource temel alınan veri kaynağıyla bağlantı kuramıyor.

NotSupportedException

CanUpdate özelliğidirfalse.

Örnekler

Aşağıdaki kod örneği, bir SqlDataSource denetimdeki DropDownList verileri görüntülemek ve Gönder düğmesine tıklandığında verileri güncelleştirmek için denetimin nasıl kullanılacağını gösterir. UpdateCommand özelliği parametreli bir SQL deyimiyle ayarlanır ve koleksiyona UpdateParameters iki ControlParameter parametre eklenir. Gönder düğmesine tıklandığında, OnClick yöntemi açıkça çağırmak Update için olay işlenir.

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

Açıklamalar

Update yöntemi, , valuesve oldValues parametrelerini geçirerek keysyöntemini çağırırExecuteUpdate. Daha fazla bilgi için bkz. SqlDataSource.UpdateCommand.

Şunlara uygulanır

Ayrıca bkz.