LinqDataSource.SelectParameters Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.Extensions.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera kolekcję parametrów używanych podczas operacji pobierania danych.

public:
 property System::Web::UI::WebControls::ParameterCollection ^ SelectParameters { 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 SelectParameters { get; }

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

Public ReadOnly Property SelectParameters As ParameterCollection

Wartość właściwości

ParameterCollection

Parametry używane do utworzenia klauzuli Select.

Atrybuty: BrowsableAttribute PersistenceModeAttribute

Przykłady

W poniższym przykładzie pokazano, jak użyć wartości dostarczonej przez użytkownika do obliczenia wartości w zwróconych danych. Użytkownik może wprowadzić wartość w polu tekstowym reprezentującym liczbę dni produkcyjnych. Ta wartość jest podzielona przez wartość z bazy danych, która reprezentuje liczbę dni do produkcji produktu. Zwrócona wartość wskazuje, ile produktów można wyprodukować w określonej liczbie dni. Dane wejściowe użytkownika są uwzględniane w poleceniu Select za pośrednictwem kolekcji SelectParameters .

Enter number of manufacturing days:
<asp:TextBox Text="1" ID="TextBox1" runat="server"></asp:TextBox><br />
<asp:Button ID="Button1" runat="server" Text="Refresh" /><br />
<asp:GridView ID="GridView1" runat="server" AllowPaging="True" 
    AllowSorting="True" AutoGenerateColumns="False" DataSourceID="LinqDataSource1">
    <Columns>
        <asp:boundfield DataField="Name" 
            HeaderText="Name" 
            ReadOnly="True" 
            SortExpression="Name">
        </asp:boundfield>
        <asp:boundfield DataField="NumberToManufacture" 
            HeaderText="Number to Manufacture" 
            ReadOnly="True" 
            SortExpression="NumberToManufacture">
        </asp:boundfield>
    </Columns>
</asp:GridView>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products"
    Where="DaysToManufacture > 0 "
    Select="new (Name, @Days / DaysToManufacture As NumberToManufacture)" 
    ID="LinqDataSource1" 
    runat="server">
  <SelectParameters>
    <asp:ControlParameter 
        Type="Decimal" 
        Name="Days" 
        ControlID="TextBox1" 
        DefaultValue="1" />
  </SelectParameters>
</asp:LinqDataSource>

Enter number of manufacturing days:
<asp:TextBox Text="1" ID="TextBox1" runat="server"></asp:TextBox><br />
<asp:Button ID="Button1" runat="server" Text="Refresh" /><br />
<asp:GridView ID="GridView1" runat="server" AllowPaging="True" 
    AllowSorting="True" AutoGenerateColumns="False" DataSourceID="LinqDataSource1">
    <Columns>
        <asp:boundfield DataField="Name" 
            HeaderText="Name" 
            ReadOnly="True" 
            SortExpression="Name">
        </asp:boundfield>
        <asp:boundfield DataField="NumberToManufacture" 
            HeaderText="Number to Manufacture" 
            ReadOnly="True" 
            SortExpression="NumberToManufacture">
        </asp:boundfield>
    </Columns>
</asp:GridView>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products"
    Where="DaysToManufacture > 0 "
    Select="new (Name, @Days / DaysToManufacture As NumberToManufacture)" 
    ID="LinqDataSource1" 
    runat="server">
  <SelectParameters>
    <asp:ControlParameter 
        Type="Decimal" 
        Name="Days" 
        ControlID="TextBox1" 
        DefaultValue="1" />
  </SelectParameters>
</asp:LinqDataSource>

Uwagi

Kontrolka LinqDataSource używa parametrów w kolekcji SelectParameters do utworzenia klauzuli Select w czasie wykonywania. Parametry są dodawane do SelectParameters kolekcji, gdy chcesz użyć wartości czasu wykonywania w klauzuli Select. Można na przykład dodać parametr do SelectParameters kolekcji, aby reprezentować właściwość w profilu użytkownika. Następnie możesz użyć tej właściwości i wartości ze źródła danych, aby obliczyć nową wartość.

Jeśli nie musisz ustawiać wartości w czasie wykonywania w klauzuli Select, nie musisz używać kolekcji SelectParameters . Właściwości do pobrania we Select właściwości można zdefiniować. Aby na przykład zwrócić FirstName wartości i LastName z tabeli bazy danych, ustaw wartość Select "FirstName, LastName" bez żadnych parametrów.

Aby ustawić wartości w kolekcji SelectParameters , należy dodać symbol zastępczy we Select właściwości nazwanego parametru. W klauzuli Select należy wstępnie wpisać każdą nazwę parametru z symbolem @.

Nie można użyć parametru w kolekcji SelectParameters do reprezentowania nazwy właściwości. Aby dynamicznie ustawić Select właściwość na nazwę właściwości, utwórz procedurę obsługi zdarzeń dla Selecting zdarzenia i dostosuj Select właściwość zgodnie z potrzebami.

Dotyczy

Share via