LinqDataSource.ContextTypeName Propriété

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.Extensions.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit le nom du type qui contient la propriété dont la valeur correspond aux données que vous souhaitez récupérer.

public:
 property System::String ^ ContextTypeName { System::String ^ get(); void set(System::String ^ value); };

public:
 virtual property System::String ^ ContextTypeName { System::String ^ get(); void set(System::String ^ value); };

public string ContextTypeName { get; set; }

public override string ContextTypeName { get; set; }

member this.ContextTypeName : string with get, set

Public Property ContextTypeName As String

Public Overrides Property ContextTypeName As String

Valeur de propriété

String

Nom de la classe à partir de laquelle récupérer les données.

Exemples

L’exemple suivant montre comment définir la ContextTypeName propriété sur une classe qui contient un tableau de chaînes. Il montre également comment définir la propriété sur une classe (générée par le Concepteur O/R) qui représente une base de données.

<!-- 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 nommée ExampleDataContext qui représente la table de base de données n’est pas affichée dans cet exemple. Pour que cet exemple fonctionne, vous devez créer cette classe en ajoutant une classe LINQ To SQL nommée Example.dbml et en faisant glisser une table nommée Movie vers le Concepteur O/R. Une classe nommée ExampleDataContext avec une propriété nommée Movies est générée.

L’exemple suivant montre la classe nommée MovieLibrary référencée dans le LinqDataSource contrôle.

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

Remarques

Lorsque vous utilisez le LinqDataSource contrôle pour récupérer des données à partir d’une collection de données en mémoire ou d’une base de données, vous devez spécifier deux propriétés. Le premier est une classe de contexte de données qui représente la source de données. La seconde est une propriété dans la classe de contexte de données qui contient les données. Vous définissez la ContextTypeName propriété sur le nom de la classe de contexte de données et vous définissez la TableName propriété sur la collection de données qui contient les données.

Par exemple, lorsque vous récupérez des données à partir d’une base de données, définissez la ContextTypeName propriété sur le nom de la classe qui représente la base de données. Définissez également la TableName propriété sur la propriété qui représente la table dans la base de données. Pour générer des classes à partir d’une base de données, utilisez le Concepteur O/R ou l’utilitaire SqlMetal.exe pour générer automatiquement ces classes.

Lorsque vous récupérez des données à partir d’une collection de données en mémoire telle qu’un tableau, définissez la ContextTypeName propriété sur le nom de la classe qui contient la propriété de tableau. Définissez ensuite la TableName propriété sur la propriété qui obtient le tableau.

Pour activer les opérations de mise à jour, d’insertion ou de suppression automatiques via le LinqDataSource contrôle, la classe affectée à la ContextTypeName propriété doit dériver de DataContext. En outre, la propriété affectée à la TableName propriété doit dériver de Table<TEntity>. Si vous n’avez pas besoin d’activer les opérations de mise à jour, d’insertion ou de suppression automatiques, vous pouvez affecter le nom d’un type quelconque de classe à la ContextTypeName propriété.

Pour plus d’informations sur la façon de sélectionner des données à partir d’une instance d’une classe, consultez la Result propriété.

S’applique à

Voir aussi

LINQ to SQL