LinqDataSource Sınıf

Tanım

public ref class LinqDataSource : System::Web::UI::DataSourceControl, System::Web::DynamicData::IDynamicDataSource

public ref class LinqDataSource : System::Web::UI::WebControls::ContextDataSource, System::Web::DynamicData::IDynamicDataSource

[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.LinqDataSource), "LinqDataSource.ico")]
public class LinqDataSource : System.Web.UI.DataSourceControl, System.Web.DynamicData.IDynamicDataSource

[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.LinqDataSource), "LinqDataSource.bmp")]
public class LinqDataSource : System.Web.UI.WebControls.ContextDataSource, System.Web.DynamicData.IDynamicDataSource

[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.LinqDataSource), "LinqDataSource.ico")>]
type LinqDataSource = class
    inherit DataSourceControl
    interface IDynamicDataSource
    interface IDataSource

[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.LinqDataSource), "LinqDataSource.bmp")>]
type LinqDataSource = class
    inherit ContextDataSource
    interface IDynamicDataSource
    interface IDataSource

Public Class LinqDataSource
Inherits DataSourceControl
Implements IDynamicDataSource

Public Class LinqDataSource
Inherits ContextDataSource
Implements IDynamicDataSource

Devralma

Object

Control

DataSourceControl

LinqDataSource

Devralma

Object

Control

DataSourceControl

QueryableDataSource

ContextDataSource

LinqDataSource

Öznitelikler

ToolboxBitmapAttribute

Uygulamalar

IDynamicDataSource IDataSource

Örnekler

Aşağıdaki örnekte adlı Productsbir LinqDataSource varlık sınıfından veri alan bir denetim gösterilmektedir. Varlık sınıfı, O/R Tasarım Aracı veya SqlMetal.exe yardımcı programı kullanılarak oluşturulmuş olabilir. Where özelliği, yalnızca özelliğinde değeri 50'den Price büyük olan kayıtları döndürecek şekilde ayarlanır. Bir GridView denetim, verileri görüntülemek için denetime bağlıdır LinqDataSource .

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    Where="Price > 50"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    Where="Price > 50"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

Aşağıdaki örnekte, kullanıcıların veri kaynağındaki kayıtları güncelleştirmesine, silmesine ve eklemesine olanak tanıyan bir LinqDataSource denetim gösterilmektedir. Denetim DetailsView denetime LinqDataSource bağlıdır ve kullanıcıların verileri görmesine ve değiştirmesine olanak tanır. Kayıtları seçmek, güncelleştirmek, silmek veya eklemek için sql komutu gerekmemektedir.

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    EnableUpdate="true"
    EnableInsert="true"
    EnableDelete="true"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:DetailsView 
    DataKeyNames="ProductID"
    AutoGenerateEditButton="true"
    AutoGenerateDeleteButton="true"
    AutoGenerateInsertButton="true"
    AllowPaging="true"
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:DetailsView>

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    EnableUpdate="true"
    EnableInsert="true"
    EnableDelete="true"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:DetailsView 
    DataKeyNames="ProductID"
    AutoGenerateEditButton="true"
    AutoGenerateDeleteButton="true"
    AutoGenerateInsertButton="true"
    AllowPaging="true"
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:DetailsView>

Aşağıdaki örnekte, veri nesnesini Web sayfasındaki bir değere göre ayarlayan olay için Selecting bir olay işleyicisi gösterilmektedir.

public partial class Default3 : System.Web.UI.Page
{
    string[] citiesArray = 
    { 
        "Atlanta", 
        "Charlotte", 
        "Denver", 
        "New York", 
        "San Francisco" 
    };

    protected void Page_Load(object sender, EventArgs e)
    {
    }

    protected void LinqDataSource_Selecting(object sender, LinqDataSourceSelectEventArgs e)
    {
        var cities = from city in citiesArray
                     where city.CompareTo("B") > 0
                     select city;
        e.Result = cities;
        // Or we could set e.Result = citiesArray to return all rows.
    }
}

Partial Class Default3
    Inherits System.Web.UI.Page

    Dim citiesArray() As String = _
    { _
        "Atlanta", _
        "Charlotte", _
        "Denver", _
        "New York", _
        "San Francisco" _
    }


    Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
       
    End Sub

    
    Protected Sub LinqDataSource_Selecting(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LinqDataSourceSelectEventArgs) Handles LinqDataSource1.Selecting
        Dim cities = From city In citiesArray _
                     Where city > "B" _
                     Select city
        e.Result = cities
        ' Or we could set e.Result = citiesArray to return all rows.
    End Sub
    
End Class

Aşağıdaki örnekte, iki sütuna göre gruplandırmak üzere yapılandırılmış bir LinqDataSource denetim gösterilmektedir. Key özelliği, ve Coloriki özelliği ProductCategory olan bir nesneye başvurur. tarafından It temsil edilen nesne olarak yeniden adlandırılır (diğer adla adlandırılır).Products Yeniden adlandırılan Products nesne, bir gruplandırmadaki tek tek kayıtların koleksiyonunu içerir. Her örnek, tablodaki tüm sütunları Products içerir.

<asp:LinqDataSource 
  ContextTypeName="ExampleDataContext" 
  TableName="Products" 
  GroupBy="new(ProductCategory, Color)"
  Select="new(Key,
          It As Products,
          Max(ListPrice) As MaxListPrice, 
          Min(ListPrice) As MinListPrice)"
  ID="LinqDataSource1" 
  runat="server">
</asp:LinqDataSource>

<asp:LinqDataSource 
  ContextTypeName="ExampleDataContext" 
  TableName="Products" 
  GroupBy="new(ProductCategory, Color)"
  Select="new(Key,
          It As Products,
          Max(ListPrice) As MaxListPrice, 
          Min(ListPrice) As MinListPrice)"
  ID="LinqDataSource1" 
  runat="server">
</asp:LinqDataSource>

Aşağıdaki örnekte, önceki örnekte yer alan denetimden verileri LinqDataSource görüntüleyen iki ListView denetim gösterilmektedir. Denetimlerden biri ListView gruplandırılmış verileri, diğer ListView denetim ise o gruba ait ürünlerin tek tek adlarını görüntüler. İç içe veriye bağlı denetimin DataSource özelliği, nesnenin diğer adı It olan olarak ayarlanırProducts.

<asp:ListView 
    DataSourceID="LinqDataSource1" 
    ID="ListView1" runat="server">

    <LayoutTemplate>
      <table id="Table1" 
          style="background-color:Teal;color:White" 
          runat="server" 
          class="Layout">
          
        <thead>
          <tr>
            <th><b>Product Category</b></th>
            <th><b>Color</b></th>
            <th><b>Highest Price</b></th>
            <th><b>Lowest Price</b></th>
          </tr>
        </thead>
        <tr runat="server" id="itemPlaceholder">
        </tr>
        
      </table>
    </LayoutTemplate>

    <ItemTemplate>
      <tr>
        <td><%# Eval("key.ProductCategory") %></td>
        <td><%# Eval("key.Color") %></td>
        <td><%# Eval("MaxListPrice") %></td>
        <td><%# Eval("MinListPrice") %></td>
      </tr>
      <tr>
        
        <td colspan="4" style="width:100%;background-color:White;color:Black">
          <asp:ListView 
            DataSource='<%# Eval("Products") %>' 
            runat="server" 
            ID="ListView2">

            <LayoutTemplate>
              <div runat="server" id="itemPlaceholder" />
            </LayoutTemplate>

            <ItemTemplate>
              <%# Eval("ProductName") %><br />
            </ItemTemplate>

          </asp:ListView> 
        </td>
      </tr>
    </ItemTemplate>
  </asp:ListView>

<asp:ListView 
   DataSourceID="LinqDataSource1" 
   ID="ListView1" runat="server">

   <LayoutTemplate>
     <table id="Table1" 
         style="background-color:Teal;color:White" 
         runat="server" 
         class="Layout">
         
       <thead>
         <tr>
           <th><b>Product Category</b></th>
           <th><b>Color</b></th>
           <th><b>Highest Price</b></th>
           <th><b>Lowest Price</b></th>
         </tr>
       </thead>
       <tr runat="server" id="itemPlaceholder">
       </tr>
       
     </table>
   </LayoutTemplate>

   <ItemTemplate>
     <tr>
       <td><%# Eval("key.ProductCategory") %></td>
       <td><%# Eval("key.Color") %></td>
       <td><%# Eval("MaxListPrice") %></td>
       <td><%# Eval("MinListPrice") %></td>
     </tr>
     <tr>
       
       <td colspan="4" style="width:100%;background-color:White;color:Black">
         <asp:ListView 
           DataSource='<%# Eval("Products") %>' 
           runat="server" 
           ID="ListView2">

           <LayoutTemplate>
             <div runat="server" id="itemPlaceholder" />
           </LayoutTemplate>

           <ItemTemplate>
             <%# Eval("ProductName") %><br />
           </ItemTemplate>

         </asp:ListView> 
       </td>
     </tr>
   </ItemTemplate>
 </asp:ListView>

Açıklamalar

Bu konuda:

• Giriş

• İşlemlerin Sırası

• Verileri Sıralama

• Verileri Gruplandırma

• Veri Değişiklikleri

• Çalışma Zamanında Değerleri Değerlendirme

• Saklı Yordamlarla Çalışma

• Tanımlayıcı Sözdizimi

Giriş

Language-Integrated Sorgusu (LINQ), dolaşma, filtreleme ve yansıtma işlemlerinin herhangi bir içinde bildirim temelli bir şekilde ifade edilmesine olanak tanıyan bir dizi sorgu işlecini tanımlayan bir sorgu söz dizimidir. NET tabanlı programlama dili. Veri nesnesi bellek içi veri koleksiyonu veya veritabanındaki verileri temsil eden bir nesne olabilir. Her işlem için SQL komutları yazmak zorunda kalmadan verileri alabilir veya değiştirebilirsiniz.

Denetim, LinqDataSource işaretleme metninde özellikleri ayarlayarak ASP.NET Web sayfasında LINQ kullanmanızı sağlar. Denetim, LinqDataSource veri komutlarını otomatik olarak oluşturmak için LINQ to SQL kullanır. LINQ to SQL hakkında daha fazla bilgi için bkz. LINQ to SQL.

Bellek içi veri koleksiyonundan veri alırken, özelliğini veri koleksiyonunu içeren sınıfa ayarlarsınız ContextTypeName . Özelliği, veri koleksiyonunu döndüren özellik veya alana ayarlarsınız TableName . Örneğin, dize Person değerleri dizisi döndüren adlı özelliği içeren adlı FavoriteCities bir sınıfınız olabilir. Bu durumda, özelliğini olarak Person ve ContextTypeName özelliğini FavoriteCitiesolarak ayarlarsınızTableName.

Veritabanını sorgularken, önce veritabanını ve tablolarını temsil eden varlık sınıfları oluşturmanız gerekir. Bu sınıfları oluşturmak için Nesne İlişkisel Tasarımcısı veya SqlMetal.exe yardımcı programını kullanabilirsiniz. Ardından ContextTypeName , özelliğini veritabanını temsil eden sınıfa ve özelliğini de veritabanı tablosunu temsil eden özelliğe ayarlarsınız TableName .

İşlemlerin Sırası

Denetim, LinqDataSource veri işlemlerini aşağıdaki sırayla uygular:

1. Where (döndürülecek veri kayıtlarını belirtin).

2. Sıralama Ölçütü (sıralama).

3. Gruplandırma Ölçütü (değerleri paylaşan veri kayıtlarını toplama).

4. Grupları Sıralama Ölçütü (gruplandırılmış verileri sıralama).

5. Seçin (döndürülecek alanları veya özellikleri belirtin).

6. Otomatik sıralama (veri kayıtlarını kullanıcının seçtiği özelliğe göre sıralayın).

7. Otomatik sayfa (kullanıcı tarafından seçilen veri kayıtlarının bir alt kümesini alma).

Bir sorgudan döndürülen veri kayıtlarını filtrelemek için özelliğine koşullar Where ekleyebilirsiniz. Where Özelliği ayarlanmadıysa, LinqDataSource denetim veri nesnesinden her kaydı alır.

Verileri Sıralama

Sıralama ölçütü olarak döndürülen verilerden özelliklerin adlarını belirtmek için özelliğini kullanırsınız OrderBy .

Verileri Gruplandırma

aynı değerlere GroupBy sahip veri kayıtlarını birleştirmek için hangi özelliklerin kullanılacağını belirtmek için özelliğini kullanırsınız. Verileri gruplandırırken, özelliğine dinamik olarak oluşturulan özellikler Select olan ve ItekleyebilirsinizKey. özelliği, Key özelliğindeki değerlere veya verileri gruplandırmak için kullanılan özelliklere başvurur. Örneğin, adlı CategoryKey bir özelliğe göre gruplandırıyorsanız, özelliği özelliğindeki Category tüm benzersiz değerleri içerir. özelliği, It bir veri grubundaki tek tek kayıtların koleksiyonunu ifade eder. Gruplandırma işleminde birleştirilmiş tek tek kayıtları almak için özelliğini yineleyebilirsiniz It . Örneğin, adlı CategoryIt bir özelliğe göre gruplandırma yaparsanız özelliği, özelliğinde Category ortak bir değeri paylaşan tüm tek tek kayıtları içerir.

Gruplandırılan verileri sıralamak için kullanılacak özellikleri belirtmek için özelliğini kullanırsınız OrderGroupsBy . Verileri gruplandırdığınızda özelliği, OrderBy gruplandırılmış veriler içindeki tek tek kayıtların nasıl sıralanacağını belirtir.

Varsayılan olarak, LinqDataSource denetim bir veri nesnesinden tüm özelliklerin değerlerini alır. Kullanılabilir özelliklerin Select bir alt kümesiyle çalışmak istiyorsanız döndürülecek özellikleri belirtmek için özelliğini kullanırsınız. Select işlemi Where, Order By ve Group By işlemlerinin ardından uygulanır. Bu nedenle, Select yan tümcesinde diğer ad oluşturursanız diğer ad diğer yan tümcelerde kullanılamaz.

Veri Değişiklikleri

, EnableInsertve EnableUpdate özelliklerini kullanarak veri değişikliklerinin EnableDeleteetkinleştirilip etkinleştirilmeyeceğini belirtebilirsiniz. Bir denetimdeki LinqDataSource verileri değiştirmek için kullanıcı arabirimi genellikle bir denetim gibi DetailsView veriye bağlı denetim aracılığıyla sağlanır. , EnableInsertveya EnableUpdate ayarına EnableDeletetrueek olarak, otomatik veri değişikliklerini etkinleştirmek için aşağıdaki koşullar gereklidir:

• Özelliğine Select bir değer atanamaz.

• Özelliğine GroupBy bir değer atanamaz.

• özelliğine atanan sınıfın ContextTypeName öğesinden DataContexttüretilmiş olması gerekir.

• özelliğine atanan özelliğinden TableNameTable<TEntity>türetilmelidir.

Veriye bağlı denetimde hangi özelliklerin görüntüleneceğini iki şekilde kısıtlayabilirsiniz. Özelliği özelliklerin Select bir alt kümesine ayarlayabilir veya denetim ekleyerek DataControlField veriye bağlı denetimin alanlarını tanımlayabilirsiniz. Ancak, özelliğini ayarlarsanız Select , bu otomatik güncelleştirme, ekleme ve silme işlemlerinin etkinleştirilemeyeceği anlamına gelir. Kullanılabilir özelliklerin bir alt kümesiyle çalışırken otomatik veri değişikliklerini etkinleştirmek istiyorsanız, özelliği ayarlamayın Select . Bunun yerine, veri nesnesinden tüm özellikleri alın ve veriye bağlı denetimi kullanarak hangilerinin görüntüleneceğini yönetin. Denetimi veya GridView denetimi kullandığınızdaDetailsView, veya AutoGenerateColumns özelliklerini falseolarak da ayarlamanız AutoGenerateRows gerekir. Bu, veriye bağlı denetimin verileri düzenlemeye ve silmeye yönelik düğmeleri otomatik olarak eklemesini önler. Veriye bağlı denetimde görüntülenmeyen tüm değerler görünüm durumunda depolanır. Bunlar, veri güncelleştirmesi gerçekleştirildiğinde veri kaynağına değiştirilmeden geçirilir.

Çalışma Zamanında Değerleri Değerlendirme

Değerleri sıralamak, filtrelemek veya gruplandırmak için çalışma zamanında değerlendirmeniz gerekiyorsa, , GroupByParameters, OrderGroupsByParametersveya OrderByParameters koleksiyonlarına WhereParametersparametre ekleyebilirsiniz.

Varsayılan değerleri belirtmek istiyorsanız koleksiyona InsertParameters parametre ekleyebilirsiniz.

Veri işlemi yürütülmeden önce değerleri incelemek veya değiştirmek istiyorsanız , Inserting, Selectingveya Updating olaylarını Deletingişleyebilirsiniz. Veri işlemini iptal etmek veya kullanıcı girişine göre veri sınıfında özellikleri ayarladığınızda oluşan doğrulama hatalarını incelemek için de bu olayları işleyebilirsiniz.

Veri işlemi tamamlandıktan sonra değerleri incelemek için , Inserted, Selectedveya Updated olaylarını Deletedişleyebilirsiniz.

Saklı Yordamlarla Çalışma

Denetimi, olay için bir olay işleyicisi oluşturarak saklı yordamdan veri almak için Selecting kullanırsınızLinqDataSource. Olay işleyicisinde, saklı yordamı temsil eden veri bağlamı sınıfında yöntemini çağırır ve sonucu nesnenin ResultLinqDataSourceSelectEventArgs özelliğine ayarlarsınız. Veriler için otomatik güncelleştirme, ekleme ve silme işlemlerini etkinleştirmek istiyorsanız, yönteminden döndürülen türün özelliğinde belirtilen türle TableName eşleşmesi gerekir. Veri bağlamı yöntemleri oluşturma hakkında daha fazla bilgi için bkz. Nasıl yapılır: Saklı yordamlara ve işlevlere eşlenen DataContext yöntemleri oluşturma (O/R Tasarım Aracı).

Tanımlayıcı Sözdizimi

<asp:LinqDataSource  
    AutoGenerateOrderByClause="True|False"  
    AutoGenerateWhereClause="True|False"  
    AutoPage="True|False"  
    AutoSort="True|False"  
    ContextTypeName="string"  
    EnableDelete="True|False"  
    EnableInsert="True|False"  
    EnableTheming="True|False"  
    EnableUpdate="True|False"  
    EnableViewState="True|False"  
    GroupBy="string"  
    ID="string"  
    OnContextCreated="ContextCreated event handler"  
    OnContextCreating="ContextCreating event handler"  
    OnContextDisposing="ContextDisposing event handler"  
    OnDataBinding="DataBinding event handler"  
    OnDeleted="Deleted event handler"  
    OnDeleting="Deleting event handler"  
    OnDisposed="Disposed event handler"  
    OnInit="Init event handler"  
    OnInserted="Inserted event handler"  
    OnInserting="Inserting event handler"  
    OnLoad="Load event handler"  
    OnPreRender="PreRender event handler"  
    OnSelected="Selected event handler"  
    OnSelecting="Selecting event handler"  
    OnUnload="Unload event handler"  
    OnUpdated="Updated event handler"  
    OnUpdating="Updating event handler"  
    OrderBy="string"  
    runat="server"  
    Select="string"  
    SkinID="string"  
    StoreOriginalValuesInViewState="True|False"  
    TableName="string"  
    Visible="True|False"  
    Where="string"  
>  
        <GroupByParameters />  
        <InsertParameters />  
        <OrderByParameters />  
        <SelectParameters />  
        <WhereParameters />  
</asp:LinqDataSource>  

Oluşturucular

Özellikler

Yöntemler

Ekinlikler

Belirtik Arabirim Kullanımları

Uzantı Metotları

Şunlara uygulanır

Ayrıca bkz.

• LINQ to SQL