LinqDataSource.SelectParameters Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.Extensions.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die Auflistung der während eines Datenabrufvorgangs verwendeten Parameter ab.

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

Eigenschaftswert

ParameterCollection

Die Parameter, die zum Erstellen der Select-Klausel verwendet werden.

Attribute: BrowsableAttribute PersistenceModeAttribute

Beispiele

Das folgende Beispiel zeigt, wie Sie einen vom Benutzer bereitgestellten Wert verwenden, um einen Wert in den zurückgegebenen Daten zu berechnen. Der Benutzer kann einen Wert in das Textfeld eingeben, das die Anzahl der Fertigungstage darstellt. Dieser Wert wird durch einen Wert aus einer Datenbank unterteilt, die die Anzahl der Tage darstellt, um ein Produkt herzustellen. Der zurückgegebene Wert gibt an, wie viele Produkte während der angegebenen Anzahl von Tagen hergestellt werden können. Die Eingabe des Benutzers wird über die SelectParameters Auflistung im Befehl "Auswählen" enthalten.

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>

Hinweise

Das LinqDataSource Steuerelement verwendet Parameter in der SelectParameters Auflistung, um die Select-Klausel zur Laufzeit zu erstellen. Sie fügen der SelectParameters Auflistung Parameter hinzu, wenn Sie Laufzeitwerte in der Select-Klausel verwenden möchten. Sie können der Auflistung beispielsweise einen Parameter SelectParameters hinzufügen, um eine Eigenschaft im Profil des Benutzers darzustellen. Anschließend können Sie diese Eigenschaft und einen Wert aus der Datenquelle verwenden, um einen neuen Wert zu berechnen.

Wenn Sie keinen Wert zur Laufzeit in der Select-Klausel festlegen müssen, müssen Sie die SelectParameters Auflistung nicht verwenden. Sie können die Eigenschaften definieren, die in der Select Eigenschaft abgerufen werden sollen. Wenn Sie z. B. die FirstName Werte LastName aus einer Datenbanktabelle zurückgeben möchten, legen Select Sie ohne Parameter auf "FirstName, LastName" fest.

Zum Festlegen von Werten in der SelectParameters Auflistung fügen Sie einen Platzhalter in der Select Eigenschaft für den benannten Parameter hinzu. Stellen Sie in der Select-Klausel jeden Parameternamen mit dem @-Symbol vor.

Sie können keinen Parameter in der SelectParameters Auflistung verwenden, um einen Eigenschaftsnamen darzustellen. Um die Select Eigenschaft dynamisch auf den Namen einer Eigenschaft festzulegen, erstellen Sie einen Ereignishandler für das Selecting Ereignis, und passen Sie die Select Eigenschaft bei Bedarf an.

Gilt für: