Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

DynamicQueryStringParameter-Klasse

 

Veröffentlicht: Oktober 2016

Generiert automatisch eine Auflistung von Parametern, die verwendet wird, um die Where-Klausel für das Datenquellensteuerelement durch Abrufen von Abfragezeichenfolgenwerten zu erstellen.

Namespace:   System.Web.DynamicData
Assembly:  System.Web.DynamicData (in System.Web.DynamicData.dll)

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

public class DynamicQueryStringParameter : Parameter, IWhereParametersProvider

NameBeschreibung
System_CAPS_pubmethodDynamicQueryStringParameter()

Initialisiert eine neue Instanz der DynamicQueryStringParameter-Klasse.

NameBeschreibung
System_CAPS_pubpropertyConvertEmptyStringToNull

Ruft ab oder legt einen Wert, der angibt, ob der Wert, der Parameter -Objekt gebunden ist, konvertiert wird, um null ist dies String.Empty.(Geerbt von „Parameter“.)

System_CAPS_pubpropertyDbType

Ruft ab oder legt den Datenbanktyp des Parameters.(Geerbt von „Parameter“.)

System_CAPS_pubpropertyDefaultValue

Gibt einen Standardwert für den Parameter, sollte der Wert, der Parameter gebunden, nicht initialisiert sein, wenn die Evaluate Methode wird aufgerufen.(Geerbt von „Parameter“.)

System_CAPS_pubpropertyDirection

Gibt an, ob die Parameter -Objekt zum Binden eines Werts an ein Steuerelement oder das Steuerelement zum Ändern des Werts verwendet werden kann.(Geerbt von „Parameter“.)

System_CAPS_protpropertyIsTrackingViewState

Ruft einen Wert, der angibt, ob die Parameter Objekt speichert Änderungen an seinem Ansichtszustand.(Geerbt von „Parameter“.)

System_CAPS_pubpropertyName

Ruft den Namen des Parameters ab oder legt diesen fest.(Geerbt von „Parameter“.)

System_CAPS_pubpropertySize

Ruft ab oder legt die Größe des Parameters fest.(Geerbt von „Parameter“.)

System_CAPS_pubpropertyType

Ruft ab oder legt den Typ des Parameters fest.(Geerbt von „Parameter“.)

System_CAPS_protpropertyViewState

Ruft ein Wörterbuch von Zustandsinformationen, mit dem Sie zum Speichern und Wiederherstellen den Ansichtszustand für ein Parameter Objekt für mehrere Anforderungen der gleichen Seite.(Geerbt von „Parameter“.)

NameBeschreibung
System_CAPS_protmethodClone()

Gibt ein Duplikat des aktuellen Parameter Instanz.(Geerbt von „Parameter“.)

System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von „Object“.)

System_CAPS_protmethodEvaluate(HttpContext, Control)

Löst ein InvalidOperationException Ausnahme in allen Fällen.(Überschreibt Parameter.Evaluate(HttpContext, Control).)

System_CAPS_protmethodFinalize()

Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Geerbt von „Object“.)

System_CAPS_pubmethodGetDatabaseType()

Ruft den DbType -Wert, der den CLR-Typ des aktuellen entspricht Parameter Instanz.(Geerbt von „Parameter“.)

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von „Object“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodGetWhereParameters(IDynamicDataSource)

Gibt eine Auflistung von Parameter -Objekten, die für die Spalten einer Tabelle automatisch, durch Abrufen von generiert werden Abfragezeichenfolgenwerten.

System_CAPS_protmethodLoadViewState(Object)

Stellt der Datenquellensicht den vorher gespeicherten Ansichtszustand.(Geerbt von „Parameter“.)

System_CAPS_protmethodMemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.(Geerbt von „Object“.)

System_CAPS_protmethodOnParameterChanged()

Ruft die OnParametersChanged Methode der ParameterCollection Sammlung mit der Parameter Objekt.(Geerbt von „Parameter“.)

System_CAPS_protmethodSaveViewState()

Speichert die Änderungen an der Parameter des Objekts Ansichtszustand nach der letzten Seite an den Server zurückgesendet wurde.(Geerbt von „Parameter“.)

System_CAPS_protmethodSetDirty()

Markiert die Parameter Objekt, damit sein Zustand im Ansichtszustand aufgezeichnet wird.(Geerbt von „Parameter“.)

System_CAPS_pubmethodToString()

Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung.(Geerbt von „Parameter“.)

System_CAPS_protmethodTrackViewState()

Bewirkt, dass die Parameter -Objekt, das Änderungen am Ansichtszustand nachzuverfolgen, sodass sie in des Steuerelements gespeichert werden können ViewState Objekt und Anforderungen der gleichen Seite hinweg beibehalten.(Geerbt von „Parameter“.)

NameBeschreibung
System_CAPS_pubinterfaceSystem_CAPS_privmethodICloneable.Clone()

Gibt ein Duplikat des aktuellen Parameter Instanz.(Geerbt von „Parameter“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.LoadViewState(Object)

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Stellt der Datenquellensicht den vorher gespeicherten Ansichtszustand.(Geerbt von „Parameter“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.SaveViewState()

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Speichert die Änderungen an der Parameter des Objekts Ansichtszustand nach der letzten Seite an den Server zurückgesendet wurde.(Geerbt von „Parameter“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.TrackViewState()

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Bewirkt, dass die Parameter -Objekt, das Änderungen am Ansichtszustand nachzuverfolgen, sodass sie in des Steuerelements gespeichert werden können ViewState Objekt und Anforderungen der gleichen Seite hinweg beibehalten.(Geerbt von „Parameter“.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIStateManager.IsTrackingViewState

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Ruft einen Wert, der angibt, ob die Parameter Objekt speichert Änderungen an seinem Ansichtszustand.(Geerbt von „Parameter“.)

The T:System.Web.DynamicData.DynamicQueryStringParameter class is used by pages that are using ASP.NET Dynamic Data features. The T:System.Web.DynamicData.DynamicQueryStringParameter class will generate a collection of T:System.Web.UI.WebControls.Parameter objects for the primary keys, foreign keys, and Boolean columns of a table by retrieving query string values.

For primary keys, you can simply add a T:System.Web.DynamicData.DynamicQueryStringParameter object without supplying any other parameters. Dynamic Data will generate the parameters for the primary key or keys. For foreign keys or Boolean columns, you must set the P:System.Web.UI.WebControls.Parameter.Name property to the name of the column you want to filter.

In order to use the T:System.Web.DynamicData.DynamicQueryStringParameter class, you must add a T:System.Web.DynamicData.DynamicDataManager control to the page and you must register the data-bound control with the T:System.Web.DynamicData.DynamicDataManager control by using the M:System.Web.DynamicData.DynamicDataManager.RegisterControl(System.Web.UI.Control) method.

See a run-time code example of this feature: Runhttp://go.microsoft.com/fwlink/?LinkId=120736&sref=System.Web.DynamicData.DynamicQueryStringParameter.

The following example shows how to use the T:System.Web.DynamicData.DynamicQueryStringParameter object as filter when displaying data in a T:System.Web.UI.WebControls.GridView control. The T:System.Web.UI.WebControls.GridView control contains a T:System.Web.UI.WebControls.TemplateField object that creates a link that sets the query string value by using the foreign key value.

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

.NET Framework
Verfügbar seit 3.5

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: