Partager via


LinqDataSource.SelectParameters Propriété

Définition

Obtient la collection de paramètres utilisés lors d'une opération de récupération de données.

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

Valeur de propriété

Paramètres utilisés pour créer la clause Select.

Attributs

Exemples

L’exemple suivant montre comment utiliser une valeur fournie par l’utilisateur pour calculer une valeur dans les données retournées. L’utilisateur peut entrer une valeur dans la zone de texte qui représente le nombre de jours de fabrication. Cette valeur est divisée par une valeur d’une base de données qui représente le nombre de jours de fabrication d’un produit. La valeur retournée indique le nombre de produits pouvant être fabriqués pendant le nombre de jours spécifié. L’entrée de l’utilisateur est incluse dans la commande Sélectionner via la SelectParameters collection.

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>

Remarques

Le LinqDataSource contrôle utilise des paramètres dans la SelectParameters collection pour créer la clause Select au moment de l’exécution. Vous ajoutez des paramètres à la SelectParameters collection lorsque vous souhaitez utiliser des valeurs d’exécution dans la clause Select. Par exemple, vous pouvez ajouter un paramètre à la SelectParameters collection pour représenter une propriété dans le profil de l’utilisateur. Vous pouvez ensuite utiliser cette propriété et une valeur de la source de données pour calculer une nouvelle valeur.

Si vous n’avez pas besoin de définir une valeur au moment de l’exécution dans la clause Select, vous n’avez pas besoin d’utiliser la SelectParameters collection. Vous pouvez définir les propriétés à récupérer dans la Select propriété . Par exemple, pour retourner les FirstName valeurs et LastName d’une table de base de données, définissez Select sur « FirstName, LastName » sans aucun paramètre.

Pour définir des valeurs dans la SelectParameters collection, vous ajoutez un espace réservé dans la Select propriété pour le paramètre nommé. Dans la clause Select, faites précéder chaque nom de paramètre du symbole @.

Vous ne pouvez pas utiliser un paramètre dans la SelectParameters collection pour représenter un nom de propriété. Pour définir dynamiquement la Select propriété sur le nom d’une propriété, créez un gestionnaire d’événements pour l’événement Selecting et personnalisez la Select propriété en fonction des besoins.

S’applique à