LinqDataSource.SelectParameters Eigenschap

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

Waarde van eigenschap

De parameters die worden gebruikt om de select-component te maken.

Kenmerken

BrowsableAttribute PersistenceModeAttribute

Voorbeelden

In het volgende voorbeeld ziet u hoe u een door de gebruiker geleverde waarde gebruikt om een waarde in de geretourneerde gegevens te berekenen. De gebruiker kan een waarde invoeren in het tekstvak dat het aantal productiedagen aangeeft. Deze waarde wordt gedeeld door een waarde uit een database die het aantal dagen aangeeft dat een product moet worden geproduceerd. De geretourneerde waarde geeft aan hoeveel producten kunnen worden vervaardigd gedurende het opgegeven aantal dagen. De invoer van de gebruiker wordt opgenomen in de opdracht Selecteren via de SelectParameters verzameling.

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>

Opmerkingen

Het LinqDataSource besturingselement gebruikt parameters in de SelectParameters verzameling om de select-component tijdens runtime te maken. U voegt parameters toe aan de SelectParameters verzameling wanneer u runtime-waarden wilt gebruiken in de select-component. U kunt bijvoorbeeld een parameter toevoegen aan de SelectParameters verzameling om een eigenschap in het profiel van de gebruiker weer te geven. Vervolgens kunt u die eigenschap en een waarde uit de gegevensbron gebruiken om een nieuwe waarde te berekenen.

Als u tijdens runtime geen waarde hoeft in te stellen in de Select-component, hoeft u de SelectParameters verzameling niet te gebruiken. U kunt de eigenschappen definiëren die moeten worden opgehaald in de Select eigenschap. Als u bijvoorbeeld de FirstName waarden LastName uit een databasetabel wilt retourneren, stelt u Select in op FirstName, LastName zonder parameters.

Als u waarden in de SelectParameters verzameling wilt instellen, voegt u een tijdelijke aanduiding toe aan de Select eigenschap voor de benoemde parameter. In de select-component moet u elke parameternaam vooraf laten gaan met het @-symbool.

U kunt geen parameter in de SelectParameters verzameling gebruiken om een eigenschapsnaam weer te geven. Als u de Select eigenschap dynamisch wilt instellen op de naam van een eigenschap, maakt u een gebeurtenis-handler voor de Selecting gebeurtenis en past u de Select eigenschap indien nodig aan.