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, der die Anzahl der Fertigungstage darstellt. Dieser Wert wird durch einen Wert aus einer Datenbank geteilt, der die Anzahl der Tage für die Herstellung eines Produkts darstellt. Der zurückgegebene Wert gibt an, wie viele Produkte während der angegebenen Anzahl von Tagen hergestellt werden können. Die Eingabe des Benutzers ist im Befehl Auswählen über die SelectParameters Sammlung 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. Beispielsweise können Sie der SelectParameters Auflistung einen Parameter 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 zur Laufzeit keinen Wert in der Select-Klausel festlegen müssen, müssen Sie die SelectParameters Auflistung nicht verwenden. Sie können die abzurufenden Eigenschaften in der Select -Eigenschaft definieren. Um beispielsweise die FirstName Werte und LastName aus einer Datenbanktabelle zurückzugeben, legen Sie ohne Parameter auf "FirstName, LastName" fest Select .

Um Werte in der SelectParameters Auflistung festzulegen, fügen Sie in der Select -Eigenschaft einen Platzhalter für den benannten Parameter hinzu. Stellen Sie in der Select-Klausel jedem Parameternamen das @-Symbol voran.

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 nach Bedarf an.

Gilt für:

Freigeben über