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::DataSourceExpression
public class ControlFilterExpression : System.Web.UI.WebControls.Expressions.DataSourceExpression
type ControlFilterExpression = class
inherit DataSourceExpression
Public Class ControlFilterExpression
Inherits DataSourceExpression
- Vererbung
Beispiele
Im folgenden Beispiel wird gezeigt, wie die ControlFilterExpression -Klasse verwendet wird, um auf ein quelldatengebundenes Steuerelement zu verweisen, bei dem der Datenschlüssel ausgewählt ist. Das QueryExtender Steuerelement verweist auf ein Zieldatenquellen-Steuerelement, das Daten erhält, die mithilfe des ausgewählten Datenschlüssels gefiltert werden. Im Beispiel verweist das datengebundene Quellsteuerelement 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, bei 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 -Klasse definiert ist QueryExtender und mit dem ausgewählten Datenschlüssel erstellt wird.
Führen Sie die folgenden Schritte aus, um die -Klasse auf einer Seite zu ControlFilterExpression verwenden:
Fügen Sie das QueryExtender Steuerelement zur Seite hinzu.
Legen Sie die
TargetControlID
-Eigenschaft des QueryExtender Steuerelements auf die ID des Zieldatenquellen-Steuerelements fest.Fügen Sie dem Steuerelement eine ControlFilterExpression -Instanz QueryExtender hinzu.
Legen Sie die
ControlID
-Eigenschaft des ControlFilterExpression -Elements auf das quelldatengebundene Steuerelement fest.
Konstruktoren
ControlFilterExpression() |
Initialisiert eine neue Instanz der ControlFilterExpression-Klasse. |
Eigenschaften
Column |
Ruft den Namen der Spalte ab, auf der die Abfrage basiert, oder legt diesen fest. |
Context |
Ruft die HttpContext-Instanz des Besitzersteuerelements ab. (Geerbt von DataSourceExpression) |
ControlID |
Ruft die ID des datengebundenen Steuerelements der Quelle 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 die Änderungen des Ansichtszustands durch ein Datenquellen-Ausdrucksobjekt verfolgt werden. (Geerbt von DataSourceExpression) |
Owner |
Ruft das Besitzersteuerelement ab. (Geerbt von DataSourceExpression) |
ViewState |
Ruft eine Instanz der StateBag-Klasse ab, die die aktuellen Informationen zum Ansichtszustand enthält. (Geerbt von DataSourceExpression) |
Methoden
Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
GetQueryable(IQueryable) |
Ruft die zu ändernde Datenquellenabfrage ab. |
GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
LoadViewState(Object) |
Stellt den zuvor gespeicherten Ansichtszustand wieder her. |
MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
SaveViewState() |
Speichert die Änderungen am Ansichtszustand ab dem Zeitpunkt, zu dem die Seite an den Server gesendet wurde. |
SetContext(Control, HttpContext, IQueryableDataSource) |
Initialisiert den Filterausdruck mit Datenquelleninformationen. |
SetDirty() |
Markiert das DataSourceExpression-Objekt, sodass 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 an seinem Ansichtszustand nachverfolgt, damit diese im Ansichtszustandobjekt des Steuerelements gespeichert und über Anforderungen der gleichen Seite hinweg beibehalten werden. |
Explizite Schnittstellenimplementierungen
IStateManager.IsTrackingViewState |
Ruft bei der Implementierung durch eine Klasse einen Wert ab, der angibt, ob die Änderungen des Ansichtszustands durch ein Datenquellen-Ausdrucksobjekt verfolgt werden. (Geerbt von DataSourceExpression) |
IStateManager.LoadViewState(Object) |
Bei einer Implementierung durch eine Klasse wird der zuvor gespeicherte Ansichtszustand des Datenquellen-Ausdrucksobjekts geladen. (Geerbt von DataSourceExpression) |
IStateManager.SaveViewState() |
Speichert bei der Implementierung durch eine Klasse den aktuellen Ansichtszustand des DataSourceExpression-Objekts. (Geerbt von DataSourceExpression) |
IStateManager.TrackViewState() |
Verfolgt bei der Implementierung durch eine Klasse die Änderungen des Ansichtszustands des DataSourceExpression-Objekts, sodass die Änderungen im StateBag-Objekt für das Datenquellen-Ausdrucksobjekt gespeichert werden können. (Geerbt von DataSourceExpression) |