ControlFilterExpression 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 des Datenschlüssels des Elements, das in einem datengebundenen Steuerelement ausgewählt ist.
public ref class ControlFilterExpression : System::Web::UI::WebControls::Expressions::DataSourceExpressionpublic class ControlFilterExpression : System.Web.UI.WebControls.Expressions.DataSourceExpressiontype ControlFilterExpression = class
inherit DataSourceExpressionPublic Class ControlFilterExpression
Inherits DataSourceExpression- Vererbung
Beispiele
Das folgende Beispiel zeigt, wie die ControlFilterExpression Klasse verwendet wird, um auf ein datenquellengebundenes Steuerelement zu verweisen, in dem der Datenschlüssel ausgewählt ist. Das QueryExtender Steuerelement verweist auf ein Zieldatenquellsteuerelement, das Daten abruft, die mithilfe des ausgewählten Datenschlüssels gefiltert werden. Im Beispiel verweist das datenquellengebundene Steuerelement auf eine übergeordnete Tabelle, und das zieldatengebundene Steuerelement verweist auf eine untergeordnete Tabelle.
<asp:QueryExtender ID="QueryExtenderID"
TargetControlID="TargetDataSourceID" runat="server">
<asp:ControlFilterExpression ControlID="SourceGridViewID" />
</asp:QueryExtender>
Hinweise
Die ControlFilterExpression Klasse, die verwendet werden soll, wenn eine Seite zwei datengebundene Steuerelemente enthält, z. B. ein GridView Steuerelement und ein ListView Steuerelement. Ein Steuerelement ist die Quelle, in der ein Datenschlüssel (Zeile) ausgewählt ist. Das andere Steuerelement ist das Ziel, auf dem die Daten basierend auf dem ausgewählten Datenschlüssel angezeigt werden. Die Zieldaten werden von einem Datenquellensteuerelement abgerufen, das die abfrage ausführt, die in der QueryExtender Klasse definiert ist und die mithilfe des ausgewählten Datenschlüssels erstellt wird.
Um den Kurs auf einer Seite zu verwenden, führen Sie die ControlFilterExpression folgenden Schritte aus:
Fügen Sie das QueryExtender Steuerelement zur Seite hinzu.
Legen Sie die
TargetControlIDEigenschaft des QueryExtender Steuerelements auf die ID des Zieldatenquellsteuerelements fest.Fügen Sie dem ControlFilterExpression Steuerelement eine QueryExtender Instanz hinzu.
Legen Sie die
ControlIDEigenschaft des ControlFilterExpression Elements auf das datenquellengebundene Steuerelement fest.
Konstruktoren
| Name | Beschreibung |
|---|---|
| ControlFilterExpression() |
Initialisiert eine neue Instanz der ControlFilterExpression-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Column |
Dient zum Abrufen oder Festlegen des Namens der Spalte, auf der die Abfrage basiert. |
| Context |
Ruft die HttpContext Instanz des Besitzersteuerelements ab. (Geerbt von DataSourceExpression) |
| ControlID |
Ruft die ID des quelldatengebundenen Steuerelements ab oder legt diese fest. |
| 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 dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetQueryable(IQueryable) |
Ruft die zu ändernde Datenquellenabfrage ab. |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| LoadViewState(Object) |
Stellt den zuvor gespeicherten Ansichtszustand wieder her. |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| SaveViewState() |
Speichert die Änderungen am Ansichtszustand seit dem Zeitpunkt, an dem die Seite auf dem Server gepostet wurde. |
| SetContext(Control, HttpContext, IQueryableDataSource) |
Initialisiert den Filterausdruck 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() |
Bewirkt, dass das ControlFilterExpression Objekt Änderungen am Ansichtszustand nachverfolgt, sodass sie im Ansichtszustandsobjekt des Steuerelements gespeichert und über Anforderungen für dieselbe Seite hinweg beibehalten werden können. |
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) |
