DynamicFilterExpression Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ändert eine Datenbankabfrage mithilfe eines Werts aus dem angegebenen Filtersteuerelement.
public ref class DynamicFilterExpression : System::Web::UI::WebControls::Expressions::DataSourceExpression
public class DynamicFilterExpression : System.Web.UI.WebControls.Expressions.DataSourceExpression
type DynamicFilterExpression = class
inherit DataSourceExpression
Public Class DynamicFilterExpression
Inherits DataSourceExpression
- Vererbung
Beispiele
Das folgende Beispiel zeigt, wie Sie mithilfe des DynamicFilterExpression Steuerelements eine Filtervorlage auf einer Seite auswählen. Die Filtervorlage wird durch das DynamicFilter Steuerelement ausgewählt, das durch DynamicFilterExpression das Steuerelement über seine ControlID Eigenschaft identifiziert wird.
<asp:QueryExtender ID="QueryExtender1"
TargetControlID="GridDataSource" runat="server">
<asp:DynamicFilterExpression ControlID="CategoryFilterID" />
</asp:QueryExtender>
Hinweise
Mit der DynamicFilterExpression Klasse können Sie eine Datenbankabfrage mithilfe der Werte ändern, die in einem DynamicFilter Steuerelement zugewiesen sind. Dieses Steuerelement delegiert die Aufgabe der Erstellung der IQueryable Abfrage an ein spezialisiertes Steuerelement wie QueryableFilterRepeater Steuerelement oder DynamicFilter Steuerelement.
Die Filtersteuerelemente delegieren wiederum das Erstellen der Abfrage an die Filtervorlage, auf die sie verweisen. Die Abfrage wird dann vom Datenquellensteuerelement ausgeführt, auf das vom QueryExtender Steuerelement verwiesen wird.
Um den Kurs auf einer Seite zu verwenden, führen Sie die DynamicFilterExpression folgenden Schritte aus:
Fügen Sie der Seite ein QueryExtender Steuerelement hinzu.
Legen Sie die
TargetControlIDEigenschaft des QueryExtender Steuerelements fest, um auf das Datenquellensteuerelement zu verweisen.Fügen Sie ein DynamicFilterExpression Objekt als untergeordnetes Element des QueryExtender Steuerelements hinzu.
Legen Sie die
ControlIDEigenschaft des DynamicFilterExpression Objekts fest, um auf das Filtersteuerelement zu verweisen.
In den vorherigen Schritten wird davon ausgegangen, dass die zugehörigen Filtersteuerelemente, datengebundenen Steuerelemente und Datenquellensteuerelemente auf der Seite definiert sind.
Konstruktoren
| Name | Beschreibung |
|---|---|
| DynamicFilterExpression() |
Initialisiert eine neue Instanz der DynamicFilterExpression-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Context |
Ruft die HttpContext Instanz des Besitzersteuerelements ab. (Geerbt von DataSourceExpression) |
| ControlID |
Dient zum Abrufen oder Festlegen des Filtersteuerelementbezeichners. |
| DataSource |
Ruft das Datenquellenobjekt ab, das dem Besitzersteuerelement zugeordnet ist. (Geerbt von DataSourceExpression) |
| IsTrackingViewState |
Ruft einen Wert ab, der angibt, ob ein Datenquellenausdrucksobjekt seine Ansichtszustandsänderungen nachverfolgt. (Geerbt von DataSourceExpression) |
| Owner |
Ruft das Besitzersteuerelement ab. (Geerbt von DataSourceExpression) |
| ViewState |
Ruft eine Instanz der StateBag Klasse ab, die die aktuellen Ansichtsstatusinformationen enthält. (Geerbt von DataSourceExpression) |
Methoden
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetQueryable(IQueryable) |
Ruft die geänderte Abfrage mit dem aktuellen Filterwert ab. |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| LoadViewState(Object) |
Lädt den Status der Werte im DataSourceExpression Objekt, die beibehalten werden müssen. (Geerbt von DataSourceExpression) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| SaveViewState() |
Speichert den aktuellen Ansichtszustand des DataSourceExpression Objekts. (Geerbt von DataSourceExpression) |
| SetContext(Control, HttpContext, IQueryableDataSource) |
Initialisiert den Ausdruck mit Datenquelleninformationen. |
| SetDirty() |
Markiert das DataSourceExpression Objekt so, dass sein Zustand im Ansichtszustand gespeichert wird. (Geerbt von DataSourceExpression) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| TrackViewState() |
Verfolgt Ansichtsstatusänderungen des DataSourceExpression Objekts nach, sodass die Änderungen im StateBag Objekt für das Datenquellenausdrucksobjekt gespeichert werden können. (Geerbt von DataSourceExpression) |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| IStateManager.IsTrackingViewState |
Wenn sie von einer Klasse implementiert wird, wird ein Wert abgerufen, der angibt, ob ein Datenquellenausdrucksobjekt seine Ansichtszustandsänderungen nachverfolgt. (Geerbt von DataSourceExpression) |
| IStateManager.LoadViewState(Object) |
Wenn sie von einer Klasse implementiert wird, wird der zuvor gespeicherte Ansichtszustand des Datenquellenausdrucksobjekts geladen. (Geerbt von DataSourceExpression) |
| IStateManager.SaveViewState() |
Wenn sie von einer Klasse implementiert wird, wird der aktuelle Ansichtsstatus des DataSourceExpression Objekts gespeichert. (Geerbt von DataSourceExpression) |
| IStateManager.TrackViewState() |
Wenn sie von einer Klasse implementiert wird, werden Ansichtsstatusänderungen des DataSourceExpression Objekts nachverfolgt, sodass die Änderungen im StateBag Objekt für das Datenquellenausdrucksobjekt gespeichert werden können. (Geerbt von DataSourceExpression) |