LinqDataSource.SelectParameters 속성

정의

네임스페이스:

System.Web.UI.WebControls

어셈블리:

System.Web.Extensions.dll

데이터 검색 작업 중에 사용되는 매개 변수 컬렉션을 가져옵니다.

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

속성 값

ParameterCollection

Select 절을 만드는 데 사용되는 매개 변수입니다.

특성

BrowsableAttribute PersistenceModeAttribute

예제

다음 예제에서는 사용자가 제공한 값을 사용하여 반환된 데이터의 값을 계산하는 방법을 보여줍니다. 사용자는 제조 일 수를 나타내는 값을 입력할 수 있습니다. 해당 값은 제품을 제조할 일 수를 나타내는 데이터베이스의 값으로 나뉩니다. 반환된 값은 지정된 일 수 동안 제조할 수 있는 제품 수를 나타냅니다. 사용자의 입력은 컬렉션을 통해 Select 명령에 포함됩니다 SelectParameters .

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>

설명

컨트롤은 LinqDataSource 컬렉션의 매개 변수를 SelectParameters 사용하여 런타임에 Select 절을 만듭니다. Select 절에서 SelectParameters 런타임 값을 사용하려는 경우 컬렉션에 매개 변수를 추가합니다. 예를 들어 사용자 프로필의 속성을 나타내는 매개 변수 SelectParameters 를 컬렉션에 추가할 수 있습니다. 그런 다음 해당 속성과 데이터 원본의 값을 사용하여 새 값을 계산할 수 있습니다.

Select 절에서 런타임에 값을 설정할 필요가 없는 경우 컬렉션을 사용할 SelectParameters 필요가 없습니다. 속성에서 Select 검색할 속성을 정의할 수 있습니다. 예를 들어 데이터베이스 테이블에서 및 값을 반환 FirstName 하려면 매개 변수 없이 를 "FirstName, LastName"으로 설정합니다Select.LastName

컬렉션에서 SelectParameters 값을 설정하려면 명명된 매개 변수의 Select 속성에 자리 표시자를 추가합니다. Select 절에서 각 매개 변수 이름 앞에 @ 기호를 추가합니다.

속성 이름을 나타내기 위해 컬렉션에서 SelectParameters 매개 변수를 사용할 수 없습니다. 속성을 속성 이름으로 동적으로 설정 Select 하려면 이벤트에 대한 Selecting 이벤트 처리기를 만들고 필요에 따라 속성을 사용자 지정 Select 합니다.