LinqDataSource.ContextTypeName Свойство

Определение

Возвращает или задает имя типа, содержащего свойство, значение которого включает предназначенные для извлечения данные.Gets or sets the name of the type that contains the property whose value has the data that you want to retrieve.

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

Значение свойства

Имя класса, из которого должны извлекаться данные.The name of the class to retrieve data from.

Примеры

В следующем примере показано, как задать для свойства ContextTypeName класс, содержащий массив строк.The following example shows how to set the ContextTypeName property to a class that contains an array of strings. В нем также показано, как задать свойство для класса (созданного Реляционный конструктор объектовO/R Designer), который представляет базу данных.It also shows how to set the property to a class (generated by the Реляционный конструктор объектовO/R Designer) that represents a database.

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

Комментарии

При использовании элемента управления LinqDataSource для получения данных из коллекции данных в памяти или из базы данных необходимо указать два свойства.When you use the LinqDataSource control to retrieve data from either an in-memory data collection or a database, you must specify two properties. Первый — это класс контекста данных, представляющий источник данных.The first is a data context class that represents the data source. Второй является свойством в классе контекста данных, который содержит данные.The second is a property in the data context class that contains the data. Для свойства ContextTypeName задается имя класса контекста данных, а свойству TableName — набор данных, содержащий данные.You set the ContextTypeName property to the name of the data context class and you set the TableName property to the data collection that contains the data.

Например, при извлечении данных из базы данных задайте свойству ContextTypeName имя класса, представляющего базу данных.For example, when you retrieve data from a database, set the ContextTypeName property to the name of the class that represents the database. Также присвойте свойству TableName свойство, представляющее таблицу в базе данных.Also set the TableName property to the property that represents the table in the database. Чтобы создать классы из базы данных, используйте Реляционный конструктор объектовO/R Designer или программу SqlMetal. exe для автоматического создания этих классов.To generate classes from a database, use the Реляционный конструктор объектовO/R Designer or the SqlMetal.exe utility to automatically generate those classes.

При извлечении данных из коллекции данных в памяти, например массива, задайте для свойства ContextTypeName имя класса, содержащего свойство массива.When you retrieve data from an in-memory data collection such as an array, set the ContextTypeName property to the name of the class that contains the array property. Затем присвойте свойству TableName свойство, которое получает массив.Then set the TableName property to the property that gets the array.

Чтобы включить автоматическое обновление, вставку или удаление операций с помощью элемента управления LinqDataSource, класс, присвоенный свойству ContextTypeName, должен быть производным от DataContext.To enable automatic update, insert, or delete operations through the LinqDataSource control, the class assigned to the ContextTypeName property must derive from DataContext. Кроме того, свойство, присвоенное свойству TableName, должно быть производным от Table<TEntity>.In addition, the property assigned to the TableName property must derive from Table<TEntity>. Если не требуется включать автоматические операции обновления, вставки или удаления, можно присвоить имя любого типа класса свойству ContextTypeName.If you do not need to enable automatic update, insert, or delete operations, you can assign the name of any type of class to the ContextTypeName property.

Сведения о том, как выбрать данные из экземпляра класса, см. в описании свойства Result.For information about how to select data from an instance of a class, see the Result property.

Применяется к

Дополнительно