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ünlerinin 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 Select 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 parametreler eklersiniz. Örneğin, kullanıcının profilindeki SelectParameters bir özelliği temsil etmek için koleksiyona bir parametre ekleyebilirsiniz. Daha sonra bu özelliği ve veri kaynağındaki bir değeri kullanarak yeni bir değer hesaplayabilirsiniz.

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 parametresiz olarak "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 önüne @ simgesi koyun.

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