LinqDataSource.WhereParameters Proprietà

Definizione

Spazio dei nomi:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Ottiene l'insieme di parametri utilizzato per creare la clausola Where.

public:
 property System::Web::UI::WebControls::ParameterCollection ^ WhereParameters { System::Web::UI::WebControls::ParameterCollection ^ get(); };

[System.ComponentModel.Browsable(false)]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.ParameterCollection WhereParameters { get; }

[<System.ComponentModel.Browsable(false)>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.WhereParameters : System.Web.UI.WebControls.ParameterCollection

Public ReadOnly Property WhereParameters As ParameterCollection

Valore della proprietà

ParameterCollection

Insieme dei parametri utilizzati per creare la clausola Where nella proprietà Where.

Implementazioni

WhereParameters

Attributi

BrowsableAttribute PersistenceModeAttribute

Esempio

Nell'esempio seguente viene illustrato come utilizzare la WhereParameters raccolta per creare dinamicamente la clausola Where. Il LinqDataSource controllo restituisce tutti i record con un valore nella Price colonna maggiore del valore selezionato dall'utente in un DropDownList controllo .

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

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

Commenti

Il LinqDataSource controllo usa i parametri nella WhereParameters raccolta per creare la clausola Where in fase di esecuzione. Aggiungere parametri alla WhereParameters raccolta quando si desidera impostare a livello di codice una o più condizioni nella clausola Where. Ad esempio, è possibile cercare record in una tabella di database con un cognome uguale al valore di un TextBox controllo . In tal caso, si aggiunge un parametro alla WhereParameters raccolta per il valore della casella di testo.

Se non è necessario impostare un valore in fase di esecuzione nella clausola Where, non è necessario utilizzare la WhereParameters raccolta. È possibile definire i campi da recuperare nella Where proprietà . Ad esempio, per restituire valori da una tabella di database in cui LastName è uguale a "Adams" nel markup, impostare la Where proprietà su 'LastName = "Adams"' senza parametri.

Per impostare i valori nella WhereParameters raccolta, assegnare un nome a ogni parametro e quindi aggiungere un segnaposto nella Where proprietà per tale parametro. Nella clausola Where anteporre ogni nome di parametro con il simbolo @.