LinqDataSource.ContextTypeName Propriété
Définition
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é
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é.