LinqDataSource.TableName LinqDataSource.TableName LinqDataSource.TableName LinqDataSource.TableName Property

定義

データ コンテキスト クラス内でデータ コレクションを表すプロパティまたはフィールドの名前を取得または設定します。Gets or sets the name of the property or field in the data context class that represents a data collection.

public:
 property System::String ^ TableName { System::String ^ get(); void set(System::String ^ value); };
public string TableName { get; set; }
member this.TableName : string with get, set
Public Property TableName As String

プロパティ値

データ コレクションを含むプロパティの名前を示す文字列。A string that contains the name of the property that contains the data collection.

次の例ではLinqDataSource 、2つのコントロールを示します。The following example shows two LinqDataSource controls. 1つLinqDataSourceのコントロールでTableNameは、プロパティはクラスのプロパティに設定されます。In one LinqDataSource control, the TableName property is set to a property in a class. このプロパティは、文字列の配列を返します。That property returns an array of strings. もう一方LinqDataSourceのコントロールTableNameでは、プロパティはデータベーステーブルを表すプロパティに設定されます。In the other LinqDataSource control, the TableName property is set to a property that represents a database table.

<!-- Retrieve and display data from array of string values -->
<asp:LinqDataSource 
    ContextTypeName="MovieLibrary" 
    TableName="AvailableGenres" 
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:DropDownList 
    DataSourceID="LinqDataSource1"
    runat="server" 
    ID="DropDownList1">
</asp:DropDownList>

<!-- Retrieve and display data from database -->
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Movies" 
    Select="Title"
    ID="LinqDataSource2" 
    runat="server">
</asp:LinqDataSource>
<asp:DropDownList 
    DataSourceID="LinqDataSource2"
    runat="server" 
    ID="DropDownList2">
</asp:DropDownList>
<!-- Retrieve and display data from array of string values -->
<asp:LinqDataSource 
    ContextTypeName="MovieLibrary" 
    TableName="AvailableGenres" 
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:DropDownList 
    DataSourceID="LinqDataSource1"
    runat="server" 
    ID="DropDownList1">
</asp:DropDownList>

<!-- Retrieve and display data from database -->
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Movies" 
    Select="Title"
    ID="LinqDataSource2" 
    runat="server">
</asp:LinqDataSource>
<asp:DropDownList 
    DataSourceID="LinqDataSource2"
    runat="server" 
    ID="DropDownList2">
</asp:DropDownList>

この例でExampleDataContextは、データベーステーブルを表すという名前のクラスは示されていません。The class named ExampleDataContext that represents the database table is not shown in this example. この例を使用するには、Example .dbml という名前の LINQ to SQL クラスを追加し、Movie という名前のテーブルをにO/R デザイナーO/R Designerドラッグして、このクラスを作成する必要があります。For this example to work, you must create this class by adding a LINQ to SQL class named Example.dbml and dragging a table named Movie onto the O/R デザイナーO/R Designer. という名前ExampleDataContext Moviesのプロパティを持つという名前のクラスが生成されます。A class named ExampleDataContext with a property named Movies is generated.

次の例は、 MovieLibrary LinqDataSourceコントロールで参照されるという名前のクラスを示しています。The following example shows the class named MovieLibrary that is referenced in the LinqDataSource control.

public class MovieLibrary
{
    string[] _availableGenres = { "Comedy", "Drama", "Romance" };

    public MovieLibrary()
    {
    }

    public string[] AvailableGenres
    {
        get
        {
            return _availableGenres;
        }
    }
}
Public Class MovieLibrary
    Dim _availableGenres() As String = {"Comedy", "Drama", "Romance"}

    Public ReadOnly Property AvailableGenres() As String()
        Get
            Return _availableGenres
        End Get
    End Property
    
End Class

注釈

TableNameプロパティに、取得するデータを表すプロパティまたはフィールドの名前を設定します。Set the TableName property to the name of the property or field that represents the data that you want to retrieve. データベーステーブルに接続する場合、プロパティの名前は通常、テーブルの名前と同じになります。When you are connecting to a database table, the name of the property is usually the same as the name of the table. メモリ内データコレクションに接続する場合は、 TableNameプロパティを、データコレクションを返すプロパティまたはフィールドの名前に設定します。When you are connecting to an in-memory data collection, set the TableName property to the name of the property or field that returns the data collection.

取得操作のTableNameプロパティには、任意の型を返すプロパティを割り当てることができます。You can assign a property that returns any type to the TableName property for retrieval operations. プロパティによって表されるオブジェクトがIEnumerable LinqDataSourceを実装していない場合、コントロールはオブジェクトのIEnumerableインスタンスにオブジェクトを自動的にラップします。If the object that is represented by the property does not implement IEnumerable, the LinqDataSource control will automatically wrap the object in an instance of an IEnumerable object.

更新、挿入、または削除の自動操作を有効にするにはContextTypeName 、プロパティに割り当てられているクラスがからDataContext派生し、 TableNameプロパティに割り当てらTable<TEntity>れたプロパティがから派生している必要があります。To enable automatic update, insert, or delete operations, the class that is assigned to the ContextTypeName property must derive from DataContext and the property that is assigned to the TableName property must derive from Table<TEntity>.

クラスのインスタンスからデータを選択する方法の詳細については、 Resultプロパティを参照してください。For information about how to select data from an instance of a class, see the Result property.

適用対象