LinqDataSource.ContextTypeName Proprietà

Definizione

Ottiene o imposta il nome del tipo che contiene la proprietà il cui valore include i dati che si desidera recuperare.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

Valore della proprietà

Nome della classe da cui recuperare dati.The name of the class to retrieve data from.

Esempi

Nell'esempio seguente viene illustrato come impostare la proprietà ContextTypeName su una classe che contiene una matrice di stringhe.The following example shows how to set the ContextTypeName property to a class that contains an array of strings. Viene inoltre illustrato come impostare la proprietà su una classe (generata dal O/R DesignerO/R Designer) che rappresenta un database.It also shows how to set the property to a class (generated by the O/R DesignerO/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>

La classe denominata ExampleDataContext che rappresenta la tabella di database non è illustrata in questo esempio.The class named ExampleDataContext that represents the database table is not shown in this example. Per il corretto funzionamento di questo esempio, è necessario creare questa classe aggiungendo una classe LINQ to SQL denominata example. dbml e trascinando una tabella denominata Movie sul O/R DesignerO/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 DesignerO/R Designer. Viene generata una classe denominata ExampleDataContext con una proprietà denominata Movies.A class named ExampleDataContext with a property named Movies is generated.

Nell'esempio seguente viene illustrata la classe denominata MovieLibrary a cui viene fatto riferimento nel controllo 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

Commenti

Quando si utilizza il controllo LinqDataSource per recuperare dati da una raccolta di dati in memoria o da un database di, è necessario specificare due proprietà.When you use the LinqDataSource control to retrieve data from either an in-memory data collection or a database, you must specify two properties. Il primo è una classe del contesto dati che rappresenta l'origine dati.The first is a data context class that represents the data source. Il secondo è una proprietà nella classe del contesto dati che contiene i dati.The second is a property in the data context class that contains the data. Impostare la proprietà ContextTypeName sul nome della classe del contesto dati e impostare la proprietà TableName sulla raccolta di dati che contiene i dati.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.

Ad esempio, quando si recuperano dati da un database, impostare la proprietà ContextTypeName sul nome della classe che rappresenta il database.For example, when you retrieve data from a database, set the ContextTypeName property to the name of the class that represents the database. Impostare anche la proprietà TableName sulla proprietà che rappresenta la tabella nel database.Also set the TableName property to the property that represents the table in the database. Per generare classi da un database, utilizzare il O/R DesignerO/R Designer o l'utilità SqlMetal. exe per generare automaticamente tali classi.To generate classes from a database, use the O/R DesignerO/R Designer or the SqlMetal.exe utility to automatically generate those classes.

Quando si recuperano dati da una raccolta di dati in memoria, ad esempio una matrice, impostare la proprietà ContextTypeName sul nome della classe che contiene la proprietà di matrice.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. Impostare quindi la proprietà TableName sulla proprietà che ottiene la matrice.Then set the TableName property to the property that gets the array.

Per abilitare le operazioni automatiche di aggiornamento, inserimento o eliminazione tramite il controllo LinqDataSource, la classe assegnata alla proprietà ContextTypeName deve derivare da DataContext.To enable automatic update, insert, or delete operations through the LinqDataSource control, the class assigned to the ContextTypeName property must derive from DataContext. Inoltre, la proprietà assegnata alla proprietà TableName deve derivare da Table<TEntity>.In addition, the property assigned to the TableName property must derive from Table<TEntity>. Se non è necessario abilitare le operazioni automatiche di aggiornamento, inserimento o eliminazione, è possibile assegnare il nome di qualsiasi tipo di classe alla proprietà 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.

Per informazioni su come selezionare i dati da un'istanza di una classe, vedere la proprietà Result.For information about how to select data from an instance of a class, see the Result property.

Si applica a

Vedi anche