LinqDataSource.TableName Propriedade

Definição

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Obtém ou define o nome da propriedade ou campo na classe de contexto de dados que representa uma coleção de dados.

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

Valor da propriedade

String

Uma cadeia de caracteres que contém o nome da propriedade que contém a coleção de dados.

Exemplos

O exemplo a seguir mostra dois LinqDataSource controles. Em um LinqDataSource controle, a TableName propriedade é definida como uma propriedade em uma classe. Essa propriedade retorna uma matriz de cadeias de caracteres. No outro LinqDataSource controle, a TableName propriedade é definida como uma propriedade que representa uma tabela de banco de dados.

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

A classe nomeada ExampleDataContext que representa a tabela de banco de dados não é mostrada neste exemplo. Para que este exemplo funcione, você deve criar essa classe adicionando uma classe LINQ to SQL chamada Example.dbml e arrastando uma tabela chamada Movie para o Designer O/R. Uma classe nomeada ExampleDataContext com uma propriedade nomeada Movies é gerada.

O exemplo a seguir mostra a classe nomeada MovieLibrary que é referenciada no LinqDataSource controle.

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

Comentários

Defina a TableName propriedade como o nome da propriedade ou campo que representa os dados que você deseja recuperar. Quando você está se conectando a uma tabela de banco de dados, o nome da propriedade geralmente é o mesmo que o nome da tabela. Quando estiver se conectando a uma coleta de dados na memória, defina a TableName propriedade como o nome da propriedade ou campo que retorna a coleta de dados.

Você pode atribuir uma propriedade que retorna qualquer tipo à TableName propriedade para operações de recuperação. Se o objeto representado pela propriedade não for implementado IEnumerable, o LinqDataSource controle encapsulará automaticamente o objeto em uma instância de um IEnumerable objeto.

Para habilitar operações automáticas de DataContext atualização, inserção ou exclusão, a classe atribuída à ContextTypeName propriedade deve derivar e a propriedade atribuída à TableName propriedade deve derivar de Table<TEntity>.

Para obter informações sobre como selecionar dados de uma instância de uma classe, consulte a Result propriedade.