LinqDataSource.TableName Propriedade

Definição

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 de Propriedade

Uma cadeia que contém o nome da propriedade que contém a recolha de dados.

Exemplos

O exemplo seguinte mostra dois LinqDataSource controlos. Num LinqDataSource dos controlos, a TableName propriedade é definida como uma propriedade de uma classe. Essa propriedade devolve um array de cadeias. No outro LinqDataSource controlo, a TableName propriedade é definida para uma propriedade que representa uma tabela de base 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 da base de dados não é mostrada neste exemplo. Para que este exemplo funcione, deve criar esta classe adicionando uma classe LINQ para SQL chamada Example.dbml e arrastando uma tabela chamada Movie para o O/R Designer. Uma classe nomeada ExampleDataContext com uma propriedade nomeada Movies é gerada.

O exemplo seguinte mostra a classe nomeada MovieLibrary que é referenciada no LinqDataSource controlo.

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

Observações

Defina a TableName propriedade para o nome da propriedade ou campo que representa os dados que pretende recuperar. Quando se liga a uma tabela de base de dados, o nome da propriedade é geralmente o mesmo que o nome da tabela. Quando estiver a ligar-se a uma coleção de dados em memória, defina a TableName propriedade para o nome da propriedade ou campo que devolve a recolha de dados.

Pode atribuir uma propriedade que devolve qualquer tipo à TableName propriedade para operações de recuperação. Se o objeto representado pela propriedade não implementar IEnumerable, o LinqDataSource controlo irá automaticamente envolver o objeto numa instância de um IEnumerable objeto.

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

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

Aplica-se a