LinqDataSource.TableName Property

Definition

Возвращает или задает имя свойства или поля в классе контекста данных, представляющем коллекцию данных.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

Property Value

String

Строка, содержащую имя свойства, содержащего коллекцию данных.A string that contains the name of the property that contains the data collection.

Examples

В следующем примере показаны два элемента управления LinqDataSource.The following example shows two LinqDataSource controls. В одном 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. Чтобы этот пример работал, необходимо создать этот класс, добавив LINQ to SQL класс с именем example. dbml и перетащив таблицу с именем Movie на Реляционный конструктор объектов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 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

Remarks

Задайте для свойства 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.

Applies to