LinqDataSource.SelectParameters Özellik

Tanım

Ad Alanı:

System.Web.UI.WebControls

Bütünleştirilmiş Kod:

System.Web.Extensions.dll

Veri alma işlemi sırasında kullanılan parametrelerin koleksiyonunu alır.

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

Özellik Değeri

ParameterCollection

Select yan tümcesini oluşturmak için kullanılan parametreler.

Öznitelikler

BrowsableAttribute PersistenceModeAttribute

Örnekler

Aşağıdaki örnekte, döndürülen verilerdeki bir değeri hesaplamak için kullanıcı tarafından sağlanan bir değerin nasıl kullanılacağı gösterilmektedir. Kullanıcı, metin kutusuna üretim günü sayısını temsil eden bir değer girebilir. Bu değer, bir ürünün üretildiği gün sayısını temsil eden veritabanındaki bir değere bölünür. Döndürülen değer, belirtilen gün sayısı boyunca kaç ürünün üretilebileceğini gösterir. Kullanıcının girişi koleksiyon aracılığıyla Seç komutuna SelectParameters eklenir.

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>

Açıklamalar

Denetim, LinqDataSource çalışma zamanında Select yan tümcesini oluşturmak için koleksiyondaki SelectParameters parametreleri kullanır. Select yan tümcesinde SelectParameters çalışma zamanı değerlerini kullanmak istediğinizde koleksiyona parametre eklersiniz. Örneğin, kullanıcının profilindeki SelectParameters bir özelliği temsil etmek için koleksiyona bir parametre ekleyebilirsiniz. Daha sonra yeni bir değer hesaplamak için bu özelliği ve veri kaynağındaki bir değeri kullanabilirsiniz.

Select yan tümcesinde çalışma zamanında bir değer ayarlamanız gerekmezse, koleksiyonu kullanmanız SelectParameters gerekmez. özelliğinde Select alınacak özellikleri tanımlayabilirsiniz. Örneğin, bir veritabanı tablosundan FirstName ve LastName değerlerini döndürmek için parametre olmadan "FirstName, LastName" olarak ayarlayın Select .

Koleksiyondaki SelectParameters değerleri ayarlamak için, adlandırılmış parametrenin özelliğine Select bir yer tutucu eklersiniz. Select yan tümcesinde, her parametre adının başına @ simgesi koyun.

Bir özellik adını temsil etmek için koleksiyonda SelectParameters parametre kullanamazsınız. Özelliği bir özelliğin Select adına dinamik olarak ayarlamak için olay için Selecting bir olay işleyicisi oluşturun ve özelliği gerektiği gibi özelleştirin Select .