LinqDataSource.SelectParameters Свойство

Определение

Пространство имен:

System.Web.UI.WebControls

Сборка:

System.Web.Extensions.dll

Возвращает коллекцию параметров, которые используются во время операции извлечения данных.

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

Значение свойства

ParameterCollection

Параметры, которые используются для создания предложения Select.

Атрибуты

BrowsableAttribute PersistenceModeAttribute

Примеры

В следующем примере показано, как использовать предоставленное пользователем значение для вычисления значения в возвращаемых данных. Пользователь может ввести в текстовое поле значение, представляющее количество производственных дней. Это значение делится на значение из базы данных, представляющее количество дней на производство продукта. Возвращаемое значение указывает, сколько продуктов можно изготовить в течение указанного количества дней. Входные данные пользователя включаются в команду Select в 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>

Комментарии

Элемент LinqDataSource управления использует параметры в SelectParameters коллекции для создания предложения Select во время выполнения. Параметры добавляются в коллекцию SelectParameters , если требуется использовать значения времени выполнения в предложении Select. Например, можно добавить параметр в коллекцию SelectParameters , чтобы представить свойство в профиле пользователя. Затем можно использовать это свойство и значение из источника данных для вычисления нового значения.

Если вам не нужно задавать значение во время выполнения в предложении Select, вам не нужно использовать коллекцию SelectParameters . В свойстве можно определить извлекаемые Select свойства. Например, чтобы вернуть FirstName значения и LastName из таблицы базы данных, задайте значение Select FirstName, LastName без каких-либо параметров.

Чтобы задать значения в SelectParameters коллекции, добавьте заполнитель в Select свойство именованного параметра. В предложении Select перед именем каждого параметра перед символом @.

Нельзя использовать параметр в SelectParameters коллекции для представления имени свойства. Чтобы динамически задать Select для свойства имя свойства, создайте обработчик событий для Selecting события и настройте Select свойство по мере необходимости.