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.UpdateCommand الخاصية

Visual Studio 2010

SqlDataSource تمثل خاصية استعلام SQL أو اسم إجراء مخزّن، و هو المستخدمة من قبل أسلوب استرجاع البيانات من قاعدة بيانات SQL الخادم.

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

public string UpdateCommand { get; set; }
<asp:SqlDataSource UpdateCommand="String" />

قيمة الخاصية

النوع: System.String
المثال رمز أول يوضح كيفية تعيين SqlDataSourceإلى استعلام SQL أساسية لاسترداد البيانات من قاعدة بيانات متوافقة مع ODBC وعرضه في نص عنصر تحكم.

للحصول على المعلومات حول المحتويات سلاسل اتصال، راجع UpdateCommandالخاصية Updateفئة، خاصية فئة، خاصية فئة، أو خاصية class.

بسبب استخدام منتجات قاعدة بيانات مختلفة الأنواع المختلفة من SQL ، بناء جملة سلسلة SQL يعتمد تشغيل الحالي ADO.NET موفر قيد الاستخدام، والتي يتم تعريفها بواسطة ProviderNameالخاصية. إذا كانت سلسلة SQL استعلام ذي معلمات أو الأمر عنصر نائب المعلمة أيضاً تعتمد تشغيل موفر ADO.NET قيد الاستخدام. For example, if the provider is the System.Data.SqlClient, which is the default provider for the SqlDataSource class, the placeholder of the parameter is '@parameterName'. المثال رمز أول يوضح كيفية تعيين System.Data.Odbcالخاصية للاتصال بقاعدة بيانات "الخادم SQL Microsoft Office 2010 Suite" وعرض نتائج System.Data.OleDbخاصية في '?'عنصر تحكم. للحصول على أكثر المعلومات حول استعلامات SQL بمعلمات الأوامر، راجع استخدام معلمات مع التحكم SqlDataSource.

InsertingUpdateCommand

The UpdateCommand property delegates to the UpdateCommand property of the SqlDataSourceView object that is associated with the SqlDataSource control.

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

في ترتيب هو سبيل المثال، UpdateCommandيحتوي على عنصر نائب لمعلمة عامل تصفية، الذي هو الموجودة في مجموعة. يوضح مثال التعليمة البرمجية التالية سيناريو أكثر تعقيداً من المثال تعليمات برمجية السابق، بحيث يكون استخدام عنصر التحكم لعرض وتحديث البيانات في أحد محمي بكلمة مرور الوصول إلى قاعدة بيانات.

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

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

هذا مقطع يحتوي على الثاني بالتعليمات البرمجية الأمثلة. المثال تعليمات برمجية الثاني يوضح كيفية تعيين UpdateCommandنص إلى اسم إجراء مخزّن و SqlDataSourceخاصية GridViewقيمة لاسترداد البيانات من Microsoft SQL Server قاعدة البيانات وعرضها في عنصر التحكم. في كل من الأمثلة، هناك هو لا توجد حاجة للاتصال بشكل واضح GridViewأسلوب نظراً لأن التحكم عناصر تحكم حدود بيانات المتصلة بمصدر بيانات من خلال سيقوم تلقائياً باستدعاء خاصية أسلوب أثناء المرحلة.

يوضح المثال تعليمات برمجية التالي كيفية تعيين UpdateCommandإلى استعلام SQL أساسية لاسترداد البيانات من قاعدة بيانات متوافقة مع ODBC وعرضه في نص SqlDataSourceعنصر تحكم.GridView The GridView automatically populates the UpdateParameters collection, inferring the parameters from the BoundField objects, and calls the Update method when the Update link on the editable GridView is selected. يمكن أن تكون خاصية استعلام SQL أو اسم إجراء مخزّن، إذا كان مصدر بيانات يعتمد الإجراءات المخزنة. يحدث عندما يكون لإجراء عملية استرداد بيانات مكتمل.


<%@Page  Language="C#" %>
<%@Import Namespace="System.Web.Mail" %>
<!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 OnDSUpdatedHandler(Object source, SqlDataSourceStatusEventArgs e) {
    if (e.AffectedRows > 0) {
        // Perform any additional processing, 
        // such as setting a status label after the operation.
        Label1.Text = Request.LogonUserIdentity.Name +
            " changed user information successfully!";    
    }
    else {
        Label1.Text = "No data updated!";
    }
 }
</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"
          DataSourceMode="DataSet"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT EmployeeID,FirstName,LastName,Title FROM Employees"
          UpdateCommand="Update Employees SET FirstName=@FirstName,LastName=@LastName,Title=@Title WHERE EmployeeID=@EmployeeID"
          OnUpdated="OnDSUpdatedHandler">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AutoGenerateColumns="False"
          DataKeyNames="EmployeeID"
          AutoGenerateEditButton="True"
          DataSourceID="SqlDataSource1">
          <columns>
              <asp:BoundField HeaderText="First Name" DataField="FirstName" />
              <asp:BoundField HeaderText="Last Name" DataField="LastName" />
              <asp:BoundField HeaderText="Title" DataField="Title" />
          </columns>
      </asp:GridView>

      <asp:Label
          id="Label1"
          runat="server">
      </asp:Label>

    </form>
  </body>
</html>


معالجة GridViewالحدث إلى فحص قيم معلمات الإخراج بعد اكتمال عملية استرداد بيانات. The ProviderName is set to the ADO.NET provider for ODBC, the System.Data.Odbc, and the ConnectionString property is set to the name of an ODBC data source name (DSN).


<%@Page  Language="C#" %>
<%@Import Namespace="System.Web.Mail" %>
<!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 OnDSUpdatedHandler(Object source, SqlDataSourceStatusEventArgs e) {
    if (e.AffectedRows > 0) {
        // Perform any additional processing, such as sending an e-mail notification.
        Label1.Text = Request.LogonUserIdentity.Name +
            " changed user information sucessfully!";
    }
    else {
        Label1.Text = "No data updated!";
    }
 }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <!-- This example uses a Northwind database that is hosted by an ODBC-compliant
         database. To run this sample, create an ODBC DSN to any database that hosts
         the Northwind database, including Microsoft SQL Server or Microsoft Access,
         change the name of the DSN in the ConnectionString, and view the page.
    -->
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ProviderName="System.Data.Odbc"
          DataSourceMode="DataSet"
          ConnectionString="dsn=myodbc3dsn;"
          SelectCommand="SELECT EmployeeID,FirstName,LastName,Title FROM Employees"
          UpdateCommand="Update Employees SET FirstName=?,LastName=?,Title=? WHERE EmployeeID=?"
          OnUpdated="OnDSUpdatedHandler">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AutoGenerateColumns="False"
          DataKeyNames="EmployeeID"
          AutoGenerateEditButton="True"
          DataSourceID="SqlDataSource1">
          <columns>
              <asp:BoundField HeaderText="First Name" DataField="FirstName" />
              <asp:BoundField HeaderText="Last Name" DataField="LastName" />
              <asp:BoundField HeaderText="Title" DataField="Title" />
          </columns>
      </asp:GridView>

      <asp:Label
          id="Label1"
          runat="server">
      </asp:Label>

    </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
إظهار: