This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

SqlDataSource.UpdateParameters الخاصية

Visual Studio 2010

The UpdateCommand عنصر تحكم, which the SqlDataSourceView هو حدود إلى, acts كـ a عامل تصفية for what هو displayed في the SqlDataSource عنصر تحكم.

مساحة الاسم:  System.Web.UI.WebControls
التجميع:  System.Web (في System.Web.dll)

[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
public ParameterCollection UpdateParameters { get; }

قيمة الخاصية

النوع: System.Web.UI.WebControls.ParameterCollection
ParameterCollection خاصية هو أحد قيم المعرفة في UpdateCommand.

If the UpdateCommand property contains a parameterized SQL query, the UpdateParameters collection contains any Parameter objects that correspond to the parameter placeholders in the SQL string.

Parameter names might be affected by the OldValuesParameterFormatString property, specifically if the name identifies a primary key, such as a key specified using the DataKeyNames property of the data-bound control, or in delete and update scenarios where the ConflictDetection property is set to the CompareAllValues value and a set of oldValues are passed to the corresponding data method. يمكنك معالجة هذا حدث إلى فحص قيم المعلمات و إلى القيام بأي preprocessing قبل oldValuesتشغيل.

الحصول أو تعيين اسم مخزن معلمة الإجراء يستخدم لفرز البيانات المستردة عند إجراء استرداد البيانات باستخدام إجراء مخزّن.UpdateParameters يحصل على مجموعة من الأسماء التي تمثل قائمة عرض الكائنات المرتبطة ب System.Data.OleDbعنصر تحكم.System.Data.Odbc System.Data.SqlClient الذي يحتوي على أسماء طرق العرض المقترنة مع SqlDataSource. للحصول على أكثر المعلومات حول استعلامات SQL بمعلمات الأوامر، راجع استخدام معلمات مع التحكم SqlDataSource.

إذا قمت بتغيير UpdateParametersخاصية، UpdateParametersحدث هو raهوed، يسبب أية عناصر تحكم ترتبط SqlDataSourceViewrebind.SqlDataSource

ملاحظة الأمانملاحظة الأمان

يوضح المثال تعليمات برمجية التالي كيفية تعيين خاصية عنصر تحكم إلى القيمة لهذا سيناريو، مع عنصر تحكم يتطلب لا فرز والترحيل، ولا تصفية. تنفيذ عملية يحذف استخدام Filteringسلسلة SQL و أي المعلمات الموجودة مجموعة. لمزيد من المعلومات، راجع نظرة عامة حول عمليات استغلال البرنامج النصي.

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. The UpdateCommand is set with a parameterized SQL statement and two ControlParameter parameters are added to the UpdateParameters collection. When the Submit button is clicked, the OnClick event is handled to call the Update method explicitly.

ملاحظة الأمانملاحظة الأمان

يمكنك إلغاء الأمر الأسلوب بتعيين خاصية كائن ل . تنفيذ عملية يحذف استخدام Insertingسلسلة SQL و أي المعلمات الموجودة مجموعة. لمزيد من المعلومات، راجع نظرة عامة حول عمليات استغلال البرنامج النصي.


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


نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0
إظهار: