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.

Parameter.Name الخاصية

Visual Studio 2010

الحصول أو تعيين اسم معلمة.

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

public string Name { get; set; }

قيمة الخاصية

النوع: System.String
اسم المعلمة القيمة الافتراضية هي String.Empty.

Parameter الالكائنات غير مطلوبة للحصول على اسم؛ على الرغم من ذلك، مصدر بيانات عناصر التحكم قد تستخدم اسم المعامل لتتوافق معParameterكائن في مجموعة مع معلمة في SQL الاستعلام أو عمل أسلوب توقيع. على سبيل المثال، SqlDataSourceعنصر تحكم يمكن استخدام الاسم Parameterالكائن بحيث تتطابق مع عنصر نائب في معلمات SQL الاستعلام. وبنفس الطريقة، SqlDataSourceعنصر تحكم يمكن استخدام الاسم Parameterالكائن في FilterParametersمجموعة بحيث تتطابق مع عنصر نائب في FilterExpressionخاصية. في بعض الحالات، الاسم هو غير مستخدمة والترتيب Parameterالكائن هو تمت الإضافة إلى ParameterCollectionمجموعة هو أكثر أهمية. للمزيد من المعلومات، راجع استخدام معلمات مع التحكم SqlDataSource واستخدام معلمات مع التحكم ObjectDataSource.

إذا كان اسم معلمة هو تم تغييره OnParameterChangedأسلوب هو تسمى.

يوضح المثال تعليمات برمجية التالي كيفية عرض بيانات التي تم تصفيتها باستخدام ObjectDataSourceعنصر تحكم لاسترداد بيانات من كائن أعمال الطبقة المتوسطة و GridViewعنصر تحكم لعرض نتائج. مثال التعليمة البرمجية يتكون من TextBoxعنصر تحكم، GridViewعنصر التحكم، ObjectDataSourceعنصر التحكم، وإرسال زر. بشكل افتراضي، TextBoxعنصر التحكم هو يتم تعبئة مع اسم واحد Northwindالموظفين. GridView عنصر تحكم يعرض معلومات حول الموظف التعرف بواسطة الاسم في TextBoxعنصر التحكم. استرداد بيانات تشغيل موظف آخر، أدخل الاسم الكامل للموظف في TextBoxعنصر تحكم وانقر فوق الزر.

FilterExpression تحدد خاصية تعبير يستخدم إلى تصفية بيانات التي تم استردادها بواسطة SelectMethodخاصية. فهو يستخدم معلمة عناصر نائبة خاصة بتقييم إلى المعلمات الموجودة في FilterParametersمجموعة. في هذا المثال، يتم تقييد العنصر النائب الخاص بالمعلمة بواسطة بين علامات اقتباس مفردة للآن نوع معلمة هو نوع سلسلة التي قد تحتوي على مسافات. إذا كان نوع معلمة هو نوع التاريخ أو، قم بإحاطة الاقتباس علامات غير ضرورية.

Th هو المثال رمز هو جزءا من بقعة صغيرة مثال عن توفير FilterExpressionخاصية ObjectDataSourceفئة.


<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS" Assembly="Samples.AspNet.CS" %>
<%@ 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">

    protected void ObjectDataSource1_Filtering(object sender, ObjectDataSourceFilteringEventArgs e)
    {
        if (Textbox1.Text == "")
        {
            e.ParameterValues.Clear();
            e.ParameterValues.Add("FullName", "Nancy Davolio");
        }
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ObjectDataSource - C# Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <p>Show all users with the following name.</p>

        <asp:textbox id="Textbox1" runat="server" text="Nancy Davolio" />

        <asp:gridview
          id="GridView1"
          runat="server"
          datasourceid="ObjectDataSource1"
          autogeneratecolumns="False">
          <columns>
            <asp:boundfield headertext="ID" datafield="EmpID" />
            <asp:boundfield headertext="Name" datafield="FullName" />
            <asp:boundfield headertext="Street Address" datafield="Address" />
          </columns>
        </asp:gridview>

        <!-- Security Note: The ObjectDataSource uses a FormParameter,
             Security Note: which does not perform validation of input from the client. -->

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetAllEmployeesAsDataSet"
          typename="Samples.AspNet.CS.EmployeeLogic"
          filterexpression="FullName='{0}'" OnFiltering="ObjectDataSource1_Filtering">
            <filterparameters>
              <asp:formparameter name="FullName" formfield="Textbox1" defaultvalue="Nancy Davolio" />
            </filterparameters>
        </asp:objectdatasource>

        <p><asp:button id="Button1" runat="server" text="Search" /></p>

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