Compartilhar via


LinqDataSource.SelectParameters Propriedade

Definição

Obtém a coleção de parâmetros usados durante uma operação de recuperação de dados.

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

Valor da propriedade

Os parâmetros usados para criar a cláusula Select.

Atributos

Exemplos

O exemplo a seguir mostra como usar um valor fornecido pelo usuário para calcular um valor nos dados retornados. O usuário pode inserir um valor na caixa de texto que representa o número de dias de fabricação. Esse valor é dividido por um valor de um banco de dados que representa o número de dias para fabricar um produto. O valor retornado indica quantos produtos podem ser fabricados durante o número especificado de dias. A entrada do usuário está incluída no comando Selecionar por meio da SelectParameters coleção.

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>

Comentários

O LinqDataSource controle usa parâmetros na SelectParameters coleção para criar a cláusula Select em tempo de execução. Adicione parâmetros à SelectParameters coleção quando quiser usar valores de tempo de execução na cláusula Select. Por exemplo, você pode adicionar um parâmetro à SelectParameters coleção para representar uma propriedade no perfil do usuário. Em seguida, você pode usar essa propriedade e um valor da fonte de dados para calcular um novo valor.

Se você não precisar definir um valor em tempo de execução na cláusula Select, não precisará usar a SelectParameters coleção. Você pode definir as propriedades a serem recuperadas na Select propriedade . Por exemplo, para retornar os FirstName valores e LastName de uma tabela de banco de dados, defina Select como "FirstName, LastName" sem parâmetros.

Para definir valores na SelectParameters coleção, adicione um espaço reservado na Select propriedade para o parâmetro nomeado. Na cláusula Select, preceda cada nome de parâmetro com o símbolo @.

Você não pode usar um parâmetro na SelectParameters coleção para representar um nome de propriedade. Para definir dinamicamente a Select propriedade como o nome de uma propriedade, crie um manipulador de eventos para o Selecting evento e personalize a Select propriedade conforme necessário.

Aplica-se a