Språk

LinqDataSource.AutoGenerateWhereClause Egenskap

Definition

Hämtar eller anger ett värde som anger om LinqDataSource kontrollen dynamiskt skapar en Where-sats baserat på värden som definierats i WhereParameters samlingen.

public:
 property bool AutoGenerateWhereClause { bool get(); void set(bool value); };
public bool AutoGenerateWhereClause { get; set; }
member this.AutoGenerateWhereClause : bool with get, set
Public Property AutoGenerateWhereClause As Boolean

Egenskapsvärde

true LinqDataSource om kontrollen skapar Where-satsen, annars . false Standardvärdet är false.

Implementeringar

Exempel

I följande exempel visas en LinqDataSource kontroll med värdet AutoGenerateWhereClausetrue. En GridView kontroll är bunden till LinqDataSource kontrollen för att visa de data som returneras från frågan. En DropDownList kontroll ingår som fylls i med tre värden. En parameter ingår i WhereParameters samlingen med namnet inställt Category, på som matchar en av egenskaperna för dataobjektet. Dess ControlID egenskap är inställd på kontrollens DropDownList ID. Kontrollen LinqDataSource skapar Where automatiskt egenskapen för att filtrera poster baserat på det värde som användaren väljer från DropDownList kontrollen. Frågan returnerar de poster vars Category egenskap matchar det värde som användaren har valt från DropDownList kontrollen.

<asp:DropDownList AutoPostBack="true" ID="DropDownList1" runat="server">
    <asp:ListItem Value="Sports"></asp:ListItem>
    <asp:ListItem Value="Garden"></asp:ListItem>
    <asp:ListItem Value="Auto"></asp:ListItem>
</asp:DropDownList>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    AutoGenerateWhereClause="true"
    ID="LinqDataSource1" 
    runat="server">
    <WhereParameters>
        <asp:ControlParameter 
            Name="Category" 
            ControlID="DropDownList1" 
            Type="String" />
    </WhereParameters>
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>
<asp:DropDownList AutoPostBack="true" ID="DropDownList1" runat="server">
    <asp:ListItem Value="Sports"></asp:ListItem>
    <asp:ListItem Value="Garden"></asp:ListItem>
    <asp:ListItem Value="Auto"></asp:ListItem>
</asp:DropDownList>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    AutoGenerateWhereClause="true"
    ID="LinqDataSource1" 
    runat="server">
    <WhereParameters>
        <asp:ControlParameter 
            Name="Category" 
            ControlID="DropDownList1" 
            Type="String" />
    </WhereParameters>
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

Kommentarer

När du anger AutoGenerateWhereClause egenskapen till trueLinqDataSource skapar kontrollen dynamiskt Where-satsen från parametrarna WhereParameters i samlingen. Varje parameter som du lägger till i WhereParameters samlingen måste ha dess Name egenskap inställd på ett värde som matchar en egenskap i dataobjektet som efterfrågas. Den automatiskt genererade Where-satsen kontrollerar om värdet som anges i WhereParameters samlingen är lika med värdet för den matchande egenskapen i dataobjektet. Om du anger mer än en parameter länkas parametrarna med en logisk AND åtgärd. Parametrar som innehåller null eller ett tomt värde ingår inte i Where-satsen.

Den automatiskt genererade Where satsen kan endast testas för likhet och kan endast länka parametrar till åtgärden AND . Ange AutoGenerateWhereClause inte egenskapen till true om du måste lägga till ett villkor som inte testas för likhet eller om du måste relatera parametrar till åtgärden OR . Du kan utföra dessa uppgifter genom att ange AutoGenerateWhereClause egenskapen till och lägga till false platshållare i Where egenskapen för varje parameter i WhereParameters samlingen. I egenskapen Where förordar du varje platshållarnamn med @-symbolen.

Du anger Where inte egenskapen när AutoGenerateWhereClause egenskapen är true, eftersom parsern dynamiskt skapar Where-satsen. Kontrollen LinqDataSource utlöser ett undantag om egenskapen AutoGenerateWhereClause är true och egenskapen Where tilldelas värden.

Gäller för