LinqDataSource.SelectParameters Propriété

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.Extensions.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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é

ParameterCollection

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

Attributs: BrowsableAttribute PersistenceModeAttribute

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 à