Compartilhar via

Estender a funcionalidade de um TableAdapter em aplicativos do .NET Framework

Observação

A DataSet classe e as classes relacionadas são tecnologias herdadas do .NET Framework do início dos anos 2000 que permitem que os aplicativos trabalhem com dados na memória enquanto os aplicativos são desconectados do banco de dados. As tecnologias são especialmente úteis para aplicativos que permitem que os usuários modifiquem dados e persistam as alterações no banco de dados. Embora os conjuntos de dados sejam uma tecnologia comprovadamente bem-sucedida, a abordagem recomendada para novos aplicativos .NET é usar o Entity Framework Core. O Entity Framework fornece uma maneira mais natural de trabalhar com dados tabulares como modelos de objeto e tem uma interface de programação mais simples.

Você pode estender a funcionalidade de um TableAdapter adicionando código ao arquivo de classe parcial do TableAdapter.

O código que define um TableAdapter é regenerado quando quaisquer alterações são feitas no TableAdapter no Designer de Conjunto de Dados ou quando um assistente modifica a configuração de um TableAdapter. Para impedir que seu código seja excluído durante a regeneração de um TableAdapter, adicione código ao arquivo de classe parcial do TableAdapter.

Classes parciais permitem que o código de uma classe específica seja dividido entre vários arquivos físicos. Para obter mais informações, consulte Partial ou partial (tipo).

Localizar TableAdapters no código

Embora os TableAdapters sejam projetados com o Dataset Designer, as classes TableAdapter geradas não são classes aninhadas de DataSet. TableAdapters estão localizados em um namespace com base no nome do conjunto de dados associado do TableAdapter. Por exemplo, se o aplicativo contiver um conjunto de dados chamado HRDataSet, os TableAdapters estarão localizados no HRDataSetTableAdapters namespace. (A convenção de nomenclatura segue este padrão: DatasetName + TableAdapters).

O exemplo a seguir pressupõe que um TableAdapter nomeado CustomersTableAdapter esteja em um projeto com NorthwindDataSet.

Para criar uma classe parcial para um TableAdapter

  1. Adicione uma nova classe ao projeto acessando o menu Projeto e selecionando Adicionar Classe.

  2. Nomeie a classe CustomersTableAdapterExtended.

  3. Selecione Adicionar.

  4. Substitua o código pelo namespace correto e pelo nome de classe parcial do projeto da seguinte maneira:

    namespace NorthwindDataSetTableAdapters
{
    public partial class CustomersTableAdapter
    {
        // Add user code here. For example:
        public override string ToString()
        {
            return "Overridden in the partial class.";
        }
    }
}

Conteúdo relacionado

  • Last updated on