LinqDataSource クラス

定義

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

継承

Object

Control

DataSourceControl

LinqDataSource

継承

Object

Control

DataSourceControl

QueryableDataSource

ContextDataSource

LinqDataSource

属性

ToolboxBitmapAttribute

実装

IDynamicDataSource IDataSource

例

次の例は、 という名前ProductsのLinqDataSourceエンティティ クラスからデータを取得するコントロールを示しています。 エンティティ クラスは、O/R Designerまたは SqlMetal.exe ユーティリティを使用して生成された可能性があります。 プロパティは Where 、 プロパティの値 Price が 50 より大きいレコードのみを返すように設定されています。 GridViewコントロールは、データを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>

次の例は、 LinqDataSource ユーザーがデータ ソース内のレコードを更新、削除、および挿入できるようにするコントロールを示しています。 DetailsViewコントロールはコントロールにLinqDataSourceバインドされ、ユーザーはデータを表示および変更できます。 レコードを選択、更新、削除、または挿入するために SQL コマンドは必要ありません。

<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>

次の例は、Web ページの値に Selecting 基づいてデータ オブジェクトを設定する イベントのイベント ハンドラーを示しています。

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

次の例は、 LinqDataSource 2 つの列でグループ化するように構成されているコントロールを示しています。 プロパティは Key 、 と という 2 つのプロパティ ProductCategory を持つオブジェクトを Color参照します。 によって It 表されるオブジェクトの名前が に変更 (別名指定) Productsされます。 名前が変更された Products オブジェクトには、グループ化された個々のレコードのコレクションが含まれています。 各インスタンスには、テーブルのすべての列が Products 含まれます。

<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>

次の例は、前の例のコントロールのデータを表示する LinqDataSource 2 つのListViewコントロールを示しています。 1 つの ListView コントロールにはグループ化されたデータが表示され、もう 1 つの ListView コントロールにはそのグループに属する製品の個々の名前が表示されます。 入れ子になったデータ バインド コントロールの DataSource プロパティは、 オブジェクトのエイリアスItである にProducts設定されます。

<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>

注釈

このトピックの内容:

• はじめに

• 演算の順序

• データの順序付け

• データのグループ化

• データ変更

• 実行時の値の評価

• ストアド プロシージャの操作

• 宣言構文

はじめに

Language-Integrated クエリ (LINQ) は、走査、フィルター、プロジェクションの各操作を任意の で宣言的な方法で表現できるようにするクエリ演算子のセットを定義するクエリ構文です。NET ベースのプログラミング言語。 データ オブジェクトには、インメモリ データ コレクション、またはデータベースからのデータを表す オブジェクトを指定できます。 操作ごとに SQL コマンドを記述しなくても、データを取得または変更できます。

LinqDataSourceコントロールを使用すると、マークアップ テキストでプロパティを設定することで、ASP.NET Web ページで LINQ を使用できます。 コントロールはLinqDataSource、LINQ to SQLを使用してデータ コマンドを自動的に生成します。 LINQ to SQLの詳細については、「LINQ to SQL」を参照してください。

インメモリ データ コレクションからデータを取得する場合は、 プロパティを ContextTypeName 、データ コレクションを含むクラスに設定します。 プロパティは、 TableName データ コレクションを返すプロパティまたはフィールドに設定します。 たとえば、文字列値の配列を返す という名前 Person のプロパティを含む という名前 FavoriteCities のクラスがあるとします。 その場合は、 プロパティを にContextTypeNamePerson設定し、 プロパティを にFavoriteCities設定しますTableName。

データベースに対してクエリを実行する場合は、まず、データベースとそのテーブルを表すエンティティ クラスを作成する必要があります。 オブジェクト リレーショナル デザイナーまたは SqlMetal.exe ユーティリティを使用して、これらのクラスを生成できます。 次に、 プロパティを ContextTypeName データベースを表す クラスに設定し、 プロパティを TableName データベース テーブルを表す プロパティに設定します。

演算の順序

コントロールは LinqDataSource 、次の順序でデータ操作を適用します。

1. Where (返すデータ レコードを指定します)。

2. 並べ替え (並べ替え)。

3. グループ化 (値を共有するデータ レコードの集計)。

4. グループ化の並べ替え (グループ化されたデータの並べ替え)。

5. を選択します (返すフィールドまたはプロパティを指定します)。

6. 自動並べ替え (ユーザーが選択したプロパティでデータ レコードを並べ替えます)。

7. 自動ページ (ユーザーが選択したデータ レコードのサブセットを取得します)。

プロパティに条件を Where 追加して、クエリから返されるデータ レコードをフィルター処理できます。 プロパティが Where 設定されていない場合、コントロールは LinqDataSource データ オブジェクトからすべてのレコードを取得します。

データの順序付け

プロパティを OrderBy 使用して、並べ替えの基準となる返されるデータのプロパティの名前を指定します。

データのグループ化

プロパティを GroupBy 使用して、同じ値を持つデータ レコードを統合するために使用するプロパティを指定します。 データをグループ化するときに、 プロパティに、 プロパティを動的に作成する と ItをSelect含Keyめることができます。 プロパティは Key 、データのグループ化に使用された プロパティまたはプロパティの値を参照します。 たとえば、 という名前 Categoryのプロパティでグループ化した場合、 Key プロパティには プロパティ内のすべての一意の値が Category 含まれます。 プロパティは It 、データのグループ内の個々のレコードのコレクションを参照します。 プロパティを It 反復処理して、グループ化操作で統合された個々のレコードを取得できます。 たとえば、 という名前 Categoryのプロパティでグループ化した場合、 It プロパティには、 プロパティ内の共通の値を共有するすべての個々のレコードが Category 含まれます。

プロパティを OrderGroupsBy 使用して、グループ化されたデータの並べ替えに使用するプロパティを指定します。 データをグループ化する場合、 プロパティは OrderBy 、グループ化されたデータ内の個々のレコードの並べ替え方法を指定します。

既定では、コントロールは LinqDataSource データ オブジェクトからすべてのプロパティの値を取得します。 プロパティを Select 使用して、使用可能なプロパティのサブセットを操作する場合に返すプロパティを指定します。 Select 操作は、Where、Order By、Group By の各操作の後に適用されます。 したがって、Select 句で別名を作成した場合、その別名は他の句では使用できません。

データ変更

、、および EnableUpdate の各プロパティを使用して、データ変更をEnableDeleteEnableInsert有効にするかどうかを指定できます。 コントロールから LinqDataSource データを変更するためのユーザー インターフェイスは、通常、コントロールなどのデータ バインド コントロールを DetailsView 介して提供されます。 、、または EnableUpdate を にtrue設定EnableDeleteEnableInsertするだけでなく、データの自動変更を有効にするには、次の条件が必要です。

• プロパティに Select 値を割り当てることはできません。

• プロパティに GroupBy 値を割り当てることはできません。

• プロパティに割り当てられる ContextTypeName クラスは、 から DataContext派生する必要があります。

• プロパティに割り当てられる TableName プロパティは、 から Table<TEntity>派生する必要があります。

データ バインド コントロールに表示されるプロパティは、2 つの方法で制限できます。 プロパティを Select プロパティのサブセットに設定することも、コントロールを追加 DataControlField してデータ バインド コントロールのフィールドを定義することもできます。 ただし、 プロパティを Select 設定した場合は、自動更新、挿入、および削除操作を有効にできないことを意味します。 使用可能なプロパティのサブセットを操作しているときにデータの自動変更を有効にする場合は、 プロパティを Select 設定しないでください。 代わりに、データ オブジェクトからすべてのプロパティを取得し、データ バインド コントロールを使用して表示されるプロパティを管理します。 コントロールまたは コントロールをDetailsView使用するGridView場合は、 または AutoGenerateColumns プロパティも に設定AutoGenerateRowsするfalse必要があります。 これにより、データを編集および削除するためのボタンがデータ バインド コントロールに自動的に含まれるのを防ぎます。 データ バインド コントロールに表示されない値は、ビューステートに格納されます。 これらは、データ更新の実行時にデータ ソースに変更されずに渡されます。

実行時の値の評価

値の順序付け、フィルター処理、またはグループ化のために実行時に値を評価する必要がある場合は、、、または OrderByParameters コレクションにパラメーターをOrderGroupsByParametersWhereParametersGroupByParameters追加できます。

既定値を指定する場合は、コレクションにパラメーターを InsertParameters 追加できます。

データ操作を実行する前に値を調べたり変更したりする場合は、、または Updating イベントをInsertingDeletingSelecting処理できます。 これらのイベントを処理して、データ操作を取り消したり、ユーザー入力に基づいてデータ クラスのプロパティを設定したときに発生した検証エラーを調べたりすることもできます。

データ操作の完了後に値を調べるには、または Updated イベントをInsertedDeletedSelected処理します。

ストアド プロシージャの操作

コントロールを使用して、イベントの LinqDataSource イベント ハンドラーを作成することで、ストアド プロシージャからデータを Selecting 取得します。 イベント ハンドラーでは、ストアド プロシージャを表すデータ コンテキスト クラスで メソッドを呼び出し、結果を オブジェクトの LinqDataSourceSelectEventArgs プロパティにResult設定します。 データの自動更新、挿入、および削除操作を有効にする場合、メソッドから返される型は、 プロパティで TableName 指定された型と一致する必要があります。 データ コンテキスト メソッドの作成の詳細については、「方法: ストアド プロシージャと関数にマップされた DataContext メソッドを作成する (O/R Designer)」を参照してください。

宣言構文

<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>  

コンストラクター

プロパティ

メソッド

イベント

明示的なインターフェイスの実装

拡張メソッド

適用対象

こちらもご覧ください

• LINQ to SQL