LinqDataSource.SelectParameters Propriedade

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

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

Atributos

BrowsableAttribute PersistenceModeAttribute

Exemplos

O exemplo seguinte mostra como usar um valor fornecido pelo utilizador para calcular um valor nos dados devolvidos. O utilizador pode introduzir um valor na caixa de texto que representa o número de dias de fabrico. Esse valor é dividido por um valor de uma base de dados que representa o número de dias para fabricar um produto. O valor devolvido indica quantos produtos podem ser fabricados durante o número de dias especificado. A entrada do utilizador está incluída no comando Select através 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>

Observações

O LinqDataSource controlo utiliza parâmetros na SelectParameters coleção para criar a cláusula Select em tempo de execução. Adiciona-se parâmetros à SelectParameters coleção quando se quer usar valores de tempo de execução na cláusula Select. Por exemplo, pode adicionar um parâmetro à SelectParameters coleção para representar uma propriedade no perfil do utilizador. Pode então usar essa propriedade e um valor da fonte de dados para calcular um novo valor.

Se não tiver de definir um valor em tempo de execução na cláusula Select, não precisa de usar a SelectParameters coleção. Pode definir as propriedades a recuperar na Select propriedade. Por exemplo, para devolver os FirstName valores e LastName de uma tabela de base de dados, defina Select "PrimeiroNome, Apelido" sem quaisquer parâmetros.

Para definir valores na SelectParameters coleção, adiciona-se um marcador de posição na Select propriedade para o parâmetro nomeado. Na cláusula Select, introduza cada nome de parâmetro com o símbolo @.

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