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.

DynamicQueryStringParameter الفئة

Visual Studio 2010

يقوم تلقائياً بإنشاء مجموعة من المعلمات التي هو المستخدمة لإنشاء Whereعبارة عن عنصر تحكم مصدر بيانات باسترداد قيم سلسلة إستعلام.

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

public class DynamicQueryStringParameter : Parameter, 
	IWhereParametersProvider

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

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

لكي تتمكن من استخدام DynamicQueryStringParameterفئة، يجب إضافة DynamicDataManagerعنصر تحكم للصفحة والتي يجب أن تسجل ربط البيانات عنصر تحكم مع DynamicDataManagerعنصر تحكم باستخدام DynamicDataManager.RegisterControlالأسلوب.

راجع المثال البرمجي لوقت التشغيل لهذه الميزة: تشغيل.

يظهر المثال التالي كيفية استخدام DynamicQueryStringParameterالكائن كعامل التصفية عند عرض بيانات في GridViewعنصر تحكم. GridView عنصر تحكم يحتوي على TemplateFieldالكائن الذي يقوم بإنشاء ارتباط الذي يقوم بتعيين القيمة سلسلة إستعلام باستخدام الخارجي القيمة المفتاح.


<%@ 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 Page_Init(object sender, EventArgs e)
  {
    // Registers the data-bound control with
    // the DynamicDataManager control.
    DynamicDataManager1.RegisterControl(ProductsGridView);

    // Initializes the URL for the View All link 
    // to the current page.
    ViewAllLink.NavigateUrl = Request.Path;

  }

  protected string GetFilterPath()
  {
    // Retrieves the current data item.
    var productItem = (Product)GetDataItem();
    if (productItem.ProductCategory != null)
    {
      // Creates a URL that has a query string value
      // set to the foreign key value.      
      return Request.Path + "?ProductCategoryID=" 
        + productItem.ProductCategoryID.ToString();
    }
    return string.Empty;
  }

  protected string GetProductCategory()
  {
    // Returns the value for the Name column
    // in the relationship table.    
    var productItem = (Product)GetDataItem();
    if (productItem.ProductCategory != null)
    {
      return productItem.ProductCategory.Name;
    }
    return string.Empty;
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
  <title>DynamicQueryStringParameter Example</title>
  <link href="~/Site.css" rel="stylesheet" type="text/css" />
</head>
<body class="template">
  <form id="form1" runat="server">
    <div>

      <h2>DynamicQueryStringParameter Example</h2>

      <asp:DynamicDataManager ID="DynamicDataManager1" runat="server"
        AutoLoadForeignKeys="true" />

      <asp:GridView ID="ProductsGridView" runat="server"
        AutoGenerateColumns="false"
        DataSourceID="ProductsDataSource"
        AllowPaging="true"
        CssClass="gridview">
        <Columns>
          <asp:DynamicField DataField="Name" />
          <asp:DynamicField DataField="ProductNumber" />
          <asp:DynamicField DataField="Color" />
          <asp:TemplateField HeaderText="Category">
            <ItemTemplate>
              <a runat="server" href='<%# GetFilterPath() %>'>
                <asp:Label runat="server" ID="ProductCategory" Text='<%# GetProductCategory() %>' />
              </a>
            </ItemTemplate>
          </asp:TemplateField>
        </Columns>
      </asp:GridView>
      <br />

      <div class="bottomhyperlink">
        <asp:HyperLink runat="server" ID="ViewAllLink" Text="View All Records" />
      </div>


      <!-- This example uses Microsoft SQL Server and connects   -->
      <!-- to the AdventureWorksLT sample database.              -->
      <asp:LinqDataSource ID="ProductsDataSource" runat="server" 
        TableName="Products"
        ContextTypeName="AdventureWorksLTDataContext" >
        <WhereParameters>
          <asp:DynamicQueryStringParameter Name="ProductCategory" />
        </WhereParameters>
      </asp:LinqDataSource>

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


System.Object
  System.Web.UI.WebControls.Parameter
    System.Web.DynamicData.DynamicQueryStringParameter

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

نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008, نظام التشغيل Windows Server 2003

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

.NET Framework

مدعوم في: 4, 3.5 المزود بحزمة الخدمة SP1
إظهار: