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 الفئة

Visual Studio 2010

توفر تقنية التي تستخدم عناصر تحكم مصدر بيانات يربط تطبيق متغيرات هويات المستخدمين والخيارات وبيانات غير ذلك. يعمل كفئة أساسية لكافة أنواع المعلمات ASP.NET.

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

public class Parameter : ICloneable, IStateManager

Parameter تمثل الفئة معلمة في استعلام معلمات SQL، تعبير تصفية، أو يستخدم استدعاء أسلوب كائن عمل عنصر تحكم مصدر بيانات ASP.NET إلى حدد تصفية أو تعديل البيانات. Parameter كائنات مضمنة فيParameterCollectionالكائن. Parameter يتم تقييم الكائنات وقت التشغيل، وهي تمثل بأي طريقة لضم قيم المتغيرات هو المستخدمة من قبل عنصر تحكم مصدر بيانات للتعامل مع البيانات.

استخدم الفئات ينحدر من Parameterبمصدر بيانات وحدود بيانات عناصر التحكم لبناء تطبيقات بيانات المستندة إلى ويب. فئات هذه معلمة مستخدمة من قبل مصدر بيانات عناصر التحكم لضم أنواع معينة من قيم الموجودة في تطبيقات ويب لعناصر نائبة في سلاسل استعلام SQL معلمات الأسلوب لكائن الأعمال والمزيد. الجدول التالي قوائم معلمة الأنواع التي تم تضمينها في ASP.NET.

ControlParameter

قم بربط أي خاصية عامة من عنصر تحكم الخادم ويب.

FormParameter

قم بربط حقل نموذج.

SessionParameter

قم بربط حقل الولاية جلسة عمل.

RouteParameter

قم بربط معلمة محدد موقع معلومات توجيه.

CookieParameter

قم بربط حقل ملف تعريف ارتباط.

QueryStringParameter

قم بربط معلمة سلسلة استعلام.

ProfileParameter

قم بربط حقل ملف تعريف.

قم بتوسيع قاعدة Parameterالفئة عندما تريد إلى تطبيق الخاص بك أنواع المعلمة cusإلىm.

Parameter الكائنات بسيطة جداً: أن يكون Nameو Typeخاصية، يمكن تمثيل بشكل إلزامي، ويمكنك مقطع صوتي الحالة عبر طلبات HTTP متعددة. تدعم الجميع المعلمات DefaultValueخاصية، بالنسبة للحالات عند معلمة هو مرتبطة بقيمة، ولكن القيمة التي يتم تقييمها إلى nullفي وقت التشغيل.

عند استخدام مجموعة من Parameterالكائنات مع مصدر بيانات عنصر تحكم، فقد ترتيبها في المجموعة المتخصصين. لمزيد من المعلومات حول كيف يتم معلمات يتم استخدامها، راجع استخدام معلمات مع التحكم SqlDataSourceو استخدام معلمات مع التحكم ObjectDataSource.

يظهر المثال التالي كيفية استخدام القيمة المحددة من DropDownListعنصر تحكم W hereعبارة عن استعلام SQL. مثال يستخدم ControlParameterفئة مشتقة من ControlParameterclass.

SelectCommand العنصر بتعريف الاستعلام باستخدام معلمة المسمى "@ بعنوان" الموقع القيمة من DropDownList1يجب انتقال. ControlParameter عنصر تعين أنه سيتم استبدال العنصر النائب "عنوان @" بالقيمة SelectedValueخاصية DropDownList1عنصر تحكم. ControlParameter عنصر هو تمت الإضافة إلى SelectParametersمجموعة SqlDataSourceعنصر التحكم.


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <p><asp:dropdownlist
          id="DropDownList1"
          runat="server"
          autopostback="True">
          <asp:listitem selected="True">Sales Representative</asp:listitem>
          <asp:listitem>Sales Manager</asp:listitem>
          <asp:listitem>Vice President, Sales</asp:listitem>
      </asp:dropdownlist></p>

      <asp:sqldatasource
          id="SqlDataSource1"
          runat="server"
          connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
          selectcommand="SELECT LastName FROM Employees WHERE Title = @Title">
          <selectparameters>
              <asp:controlparameter name="Title" controlid="DropDownList1" propertyname="SelectedValue"/>
          </selectparameters>
      </asp:sqldatasource>

      <p><asp:listbox
          id="ListBox1"
          runat="server"
          datasourceid="SqlDataSource1"
          datatextfield="LastName">
      </asp:listbox></p>

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


المثال التالي هو مثل السابق، ولكنه يستخدم تعليمات برمجية بدلاً من ترميز. عند تحميل الصفحة للمرة الأولى، DropDownListعنصر التحكم يحتوي على لا قيم محددة، و DefaultValueخاصية Parameterالكائن هو المستخدمة.


<%@ Page Language="C#" CodeFile="param1acs.aspx.cs" Inherits="param1acs_aspx" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <asp:DropDownList
          runat="server"
          AutoPostBack="True"
          id="DropDownList1">
            <asp:ListItem Value="USA">USA</asp:ListItem>
            <asp:ListItem Value="UK">UK</asp:ListItem>
         </asp:DropDownList>

        <asp:DataGrid
          runat="server"
          id="DataGrid1" />    
    </div>
    </form>
</body>
</html>


يلي تعليمات برمجية يظهر تعليمات برمجية-خلف فئة للصفحة في المثال السابق.


public partial class param1acs_aspx : System.Web.UI.Page 
{
    private void Page_Load(object sender, System.EventArgs e)
    {
        SqlDataSource sqlSource = new SqlDataSource(
          ConfigurationManager.ConnectionStrings["MyNorthwind"].ConnectionString,
          "SELECT FirstName, LastName FROM Employees WHERE Country = @country;");

        ControlParameter country = new ControlParameter();
        country.Name = "country";
        country.Type = TypeCode.String;
        country.ControlID = "DropDownList1";
        country.PropertyName = "SelectedValue";

        // If the DefaultValue is not set, the DataGrid does not
        // display anything on the first page load. This is because
        // on the first page load, the DropDownList has no
        // selected item, and the ControlParameter evaluates to
        // String.Empty.
        country.DefaultValue = "USA";

        sqlSource.SelectParameters.Add(country);

        // Add the SqlDataSource to the page controls collection.
        Page.Controls.Add(sqlSource);

        DataGrid1.DataSource = sqlSource;
        DataGrid1.DataBind();
    }
}


يوضح المثال تعليمات برمجية التالي كيفية توسيع Parameterالفئة لإنشاء نوع معامل جديد التي يمكن استخدامها بواسطة عناصر تحكم مصدر بيانات و غير ذلك عناصر التحكم بربط بيانات سيناريوهات. يمكن استخدام عنصر تحكم مصدر بيانات StaticParameterمعلمة إلى يربط إلى التصريح عن القيمة أي كائن، عادة سلسلة، وتشغيل صفحة "نماذج ويب".


namespace Samples.AspNet {

  using System;
  using System.ComponentModel;
  using System.Security.Permissions;
  using System.Web;
  using System.Web.UI;
  using System.Web.UI.WebControls;

  [AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
  public class StaticParameter : Parameter {

    public StaticParameter() {
    }
    // The StaticParameter(string, object) constructor
    // initializes the DataValue property and calls the
    // Parameter(string) constructor to initialize the Name property.
    public StaticParameter(string name, object value) : base(name) {
      DataValue = value;
    }
    // The StaticParameter(string, TypeCode, object) constructor
    // initializes the DataValue property and calls the
    // Parameter(string, TypeCode) constructor to initialize the Name and
    // Type properties.
    public StaticParameter(string name, TypeCode type, object value) : base(name, type) {
      DataValue = value;
    }
    // The StaticParameter copy constructor is provided to ensure that
    // the state contained in the DataValue property is copied to new
    // instances of the class.
    protected StaticParameter(StaticParameter original) : base(original) {
      DataValue = original.DataValue;
    }

    // The Clone method is overridden to call the
    // StaticParameter copy constructor, so that the data in
    // the DataValue property is correctly transferred to the
    // new instance of the StaticParameter.
    protected override Parameter Clone() {
      return new StaticParameter(this);
    }
    // The DataValue can be any arbitrary object and is stored in ViewState.
    public object DataValue {
      get {
        return ViewState["Value"];
      }
      set {
        ViewState["Value"] = value;
      }
    }
    // The Value property is a type safe convenience property
    // used when the StaticParameter represents string data.
    // It gets the string value of the DataValue property, and
    // sets the DataValue property directly.
    public string Value {
      get {
        object o = DataValue;
        if (o == null || !(o is string))
          return String.Empty;
        return (string)o;
      }
      set {
        DataValue = value;
        OnParameterChanged();
      }
    }

    // The Evaluate method is overridden to return the
    // DataValue property instead of the DefaultValue.
    protected override object Evaluate(HttpContext context, Control control) {

      if (context.Request == null)
          return null;

      return DataValue;
    }
  }
}


يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في Visual Basic) من هذا النوع. لن يتم ضمان تأمين العملية الجزئية لأي عضو مثيل.

نظام التشغيل 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
إظهار: