LinqDataSource.TableName Propriété

Définition

Espace de noms:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Obtient ou définit le nom de la propriété ou du champ de la classe de contexte de données qui représente une collection de données.

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

Valeur de propriété

String

Chaîne comportant le nom de la propriété qui contient la collection de données.

Exemples

L’exemple suivant montre deux LinqDataSource contrôles. Dans un LinqDataSource contrôle, la TableName propriété est définie sur une propriété dans une classe. Cette propriété retourne un tableau de chaînes. Dans l’autre LinqDataSource contrôle, la TableName propriété est définie sur une propriété qui représente une table de 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 sur le Concepteur O/R. Une classe nommée avec une propriété nommée ExampleDataContext Movies est générée.

L’exemple suivant montre la classe nommée MovieLibrary qui est 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

Définissez la TableName propriété sur le nom de la propriété ou du champ qui représente les données que vous souhaitez récupérer. Lorsque vous vous connectez à une table de base de données, le nom de la propriété est généralement identique au nom de la table. Lorsque vous vous connectez à une collection de données en mémoire, définissez la TableName propriété sur le nom de la propriété ou du champ qui retourne la collection de données.

Vous pouvez affecter une propriété qui retourne n’importe quel type à la propriété pour les TableName opérations de récupération. Si l’objet représenté par la propriété n’implémente IEnumerablepas, le LinqDataSource contrôle encapsule automatiquement l’objet dans une instance d’un IEnumerable objet.

Pour activer les opérations de mise à jour, d’insertion ou de suppression automatiques, la classe affectée à la ContextTypeName propriété doit dériver DataContext et la propriété affectée à la TableName propriété doit dériver de Table<TEntity>.

Pour plus d’informations sur la sélection de données à partir d’une instance d’une classe, consultez la Result propriété.