(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

LinqDataSource.WhereParameters-Eigenschaft

Ruft die Auflistung von Parametern ab, die zum Erstellen der Where-Klausel verwendet werden.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web.Extensions (in System.Web.Extensions.dll)

[BrowsableAttribute(false)]
[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
public ParameterCollection WhereParameters { get; }

Eigenschaftswert

Typ: System.Web.UI.WebControls.ParameterCollection
Eine Auflistung der Parameter, die zum Erstellen der Where-Klausel in der Where-Eigenschaft verwendet werden.

Implementiert

IDynamicDataSource.WhereParameters

Das LinqDataSource-Steuerelement verwendet Parameter in der WhereParameters-Auflistung, um die Where-Klausel zur Laufzeit zu erstellen. Sie fügen der WhereParameters-Auflistung Parameter hinzu, wenn Sie eine oder mehrere Bedingungen in der Where-Klausel programmgesteuert festlegen möchten. Zum Beispiel können Sie eine Datenbanktabelle nach Datensätzen durchsuchen, in denen der Nachname gleich dem Wert in einem TextBox-Steuerelement ist. In diesem Fall fügen Sie der WhereParameters-Auflistung einen Parameter für den Textfeldwert hinzu.

Wenn Sie zur Laufzeit keinen Wert in der Where-Klausel festlegen müssen, müssen Sie die WhereParameters-Auflistung nicht verwenden. Sie können die Felder definieren, die in der Where-Eigenschaft abgerufen werden sollen. Um z. B. Werte von einer Datenbanktabelle zurückzugeben, bei denen LastName gleich "Adams" im Markup ist, legen Sie die Where-Eigenschaft auf 'LastName = "Adams"' ohne Parameter fest.

Wenn Sie Werte in der WhereParameters-Auflistung festlegen möchten, weisen Sie jedem Parameter einen Namen zu, und fügen Sie dann in der Where-Eigenschaft für diesen Parameter einen Platzhalter hinzu. Stellen Sie in der Where-Klausel jedem Parameternamen das @-Symbol voran.

Das folgende Beispiel zeigt, wie die WhereParameters-Auflistung verwendet wird, um die Where-Klausel dynamisch zu erstellen. Das LinqDataSource-Steuerelement gibt alle Datensätze zurück, die in der Price-Spalte einen Wert aufweisen, der größer als der vom Benutzer in einem DropDownList-Steuerelement ausgewählte Wert ist.


<asp:DropDownList AutoPostBack="true" ID="DropDownList1" runat="server">
    <asp:ListItem Value="0"></asp:ListItem>
    <asp:ListItem Value="25"></asp:ListItem>
    <asp:ListItem Value="100"></asp:ListItem>
    <asp:ListItem Value="400"></asp:ListItem>
</asp:DropDownList>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    Where="Price>@UserPrice"
    ID="LinqDataSource1" 
    runat="server">
    <WhereParameters>
        <asp:ControlParameter 
            Name="UserPrice" 
            DefaultValue="0" 
            ControlID="DropDownList1" 
            Type="Int32" />
    </WhereParameters>
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>


.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft