DynamicQueryStringParameter Kelas

Referensi

Definisi

Ruang nama:: System.Web.DynamicData

Rakitan:: System.Web.DynamicData.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Secara otomatis menghasilkan kumpulan parameter yang digunakan untuk membuat Where klausa untuk kontrol sumber data dengan mengambil nilai string kueri.

public ref class DynamicQueryStringParameter : System::Web::UI::WebControls::Parameter, System::Web::DynamicData::IWhereParametersProvider

public class DynamicQueryStringParameter : System.Web.UI.WebControls.Parameter, System.Web.DynamicData.IWhereParametersProvider

type DynamicQueryStringParameter = class
    inherit Parameter
    interface IWhereParametersProvider

Public Class DynamicQueryStringParameter
Inherits Parameter
Implements IWhereParametersProvider

Warisan: Object

Parameter
DynamicQueryStringParameter

Penerapan: IWhereParametersProvider

Contoh

Contoh berikut menunjukkan cara menggunakan DynamicQueryStringParameter objek sebagai filter saat menampilkan data dalam GridView kontrol. GridView Kontrol berisi TemplateField objek yang membuat tautan yang mengatur nilai string kueri dengan menggunakan nilai kunci asing.

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

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
 
  Protected Sub Page_Init(ByVal sender As Object, ByVal e As System.EventArgs)
    ' 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    
  End Sub

  Protected Function GetFilterPath() As String
    ' Retrieves the current data item.
    Dim productItem = CType(GetDataItem(), Product)
    If Not (productItem.ProductCategory Is Nothing) Then
      ' Creates a URL that has a query string value
      ' set to the foreign key value.
      Return Request.Path + "?ProductCategoryID=" + productItem.ProductCategoryID.ToString()
    End If
    Return String.Empty

  End Function

  Protected Function GetProductCategory() As String
    ' Returns the value for the Name column
    ' in the relationship table.
    Dim productItem = CType(GetDataItem(), Product)
    If Not (productItem.ProductCategory Is Nothing) Then
      Return productItem.ProductCategory.Name
    End If
    Return String.Empty
  End Function
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head 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>

Keterangan

Kelas DynamicQueryStringParameter digunakan oleh halaman yang menggunakan fitur data dinamis ASP.NET. Kelas DynamicQueryStringParameter akan menghasilkan kumpulan Parameter objek untuk kunci primer, kunci asing, dan kolom Boolean tabel dengan mengambil nilai string kueri.

Untuk kunci primer, Anda cukup menambahkan DynamicQueryStringParameter objek tanpa menyediakan parameter lain. Data Dinamis akan menghasilkan parameter untuk kunci atau kunci primer. Untuk kunci asing atau kolom Boolean, Anda harus mengatur Name properti ke nama kolom yang ingin Anda filter.

Untuk menggunakan DynamicQueryStringParameter kelas , Anda harus menambahkan DynamicDataManager kontrol ke halaman dan Anda harus mendaftarkan kontrol terikat data dengan DynamicDataManager kontrol dengan menggunakan DynamicDataManager.RegisterControl metode .

Lihat contoh kode run-time fitur ini: Jalankan.

Konstruktor

DynamicQueryStringParameter()

Menginisialisasi instans baru kelas DynamicQueryStringParameter.

Properti

ConvertEmptyStringToNull	Mendapatkan atau menetapkan nilai yang menunjukkan apakah nilai yang Parameter terikat objek harus dikonversi ke `null` jika itu adalah Empty. (Diperoleh dari Parameter)
DbType	Mendapatkan atau mengatur jenis database parameter. (Diperoleh dari Parameter)
DefaultValue	Menentukan nilai default untuk parameter, jika nilai parameter terikat untuk tidak diinisialisasi saat Evaluate(HttpContext, Control) metode dipanggil. (Diperoleh dari Parameter)
Direction	Menunjukkan apakah Parameter objek digunakan untuk mengikat nilai ke kontrol, atau kontrol dapat digunakan untuk mengubah nilai. (Diperoleh dari Parameter)
IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah Parameter objek menyimpan perubahan pada status tampilannya. (Diperoleh dari Parameter)
Name	Mendapatkan atau mengatur nama parameter. (Diperoleh dari Parameter)
Size	Mendapatkan atau mengatur ukuran parameter. (Diperoleh dari Parameter)
Type	Mendapatkan atau mengatur jenis parameter. (Diperoleh dari Parameter)
ViewState	Mendapatkan kamus informasi status yang memungkinkan Anda menyimpan dan memulihkan status Parameter tampilan objek di beberapa permintaan untuk halaman yang sama. (Diperoleh dari Parameter)

Metode

Clone()	Mengembalikan duplikat instans saat ini Parameter . (Diperoleh dari Parameter)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
Evaluate(HttpContext, Control)	InvalidOperationException Memberikan pengecualian dalam semua kasus.
GetDatabaseType()	Mendapatkan nilai yang setara dengan jenis CLR instans DbType saat ini Parameter . (Diperoleh dari Parameter)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
GetWhereParameters(IDynamicDataSource)	Mengembalikan kumpulan Parameter objek yang secara otomatis dihasilkan untuk kolom tabel dengan mengambil nilai string kueri.
LoadViewState(Object)	Memulihkan status tampilan sumber data yang sebelumnya disimpan. (Diperoleh dari Parameter)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
OnParameterChanged()	OnParametersChanged(EventArgs) Memanggil metode ParameterCollection koleksi yang berisi Parameter objek . (Diperoleh dari Parameter)
SaveViewState()	Menyimpan perubahan ke Parameter status tampilan objek sejak halaman diposting kembali ke server. (Diperoleh dari Parameter)
SetDirty()	Parameter Menandai objek sehingga statusnya akan direkam dalam status tampilan. (Diperoleh dari Parameter)
ToString()	Mengonversi nilai instans ini ke representasi string yang setara. (Diperoleh dari Parameter)
TrackViewState()	Parameter Menyebabkan objek melacak perubahan pada status tampilannya sehingga dapat disimpan di objek kontrol ViewState dan bertahan di seluruh permintaan untuk halaman yang sama. (Diperoleh dari Parameter)

Implementasi Antarmuka Eksplisit

ICloneable.Clone()	Mengembalikan duplikat instans saat ini Parameter . (Diperoleh dari Parameter)
IStateManager.IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah Parameter objek menyimpan perubahan pada status tampilannya. (Diperoleh dari Parameter)
IStateManager.LoadViewState(Object)	Memulihkan status tampilan sumber data yang sebelumnya disimpan. (Diperoleh dari Parameter)
IStateManager.SaveViewState()	Menyimpan perubahan ke Parameter status tampilan objek sejak halaman diposting kembali ke server. (Diperoleh dari Parameter)
IStateManager.TrackViewState()	Parameter Menyebabkan objek melacak perubahan pada status tampilannya sehingga dapat disimpan di objek kontrol ViewState dan bertahan di seluruh permintaan untuk halaman yang sama. (Diperoleh dari Parameter)

Berlaku untuk

Bagikan melalui