Compartilhar via


Como: estender a funcionalidade de um TableAdapter

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

O código que define um TableAdapter é regenerado quando quaisquer alterações forem feitas no TableAdapter (no Dataset Designer) ou quando alterações são feitas durante a execução de qualquer assistente que 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 para o arquivo de classe parcial do TableAdapter.

(Classes parciais permitem codificar uma classe específica para ser dividida entre arquivos físicos múltiplos.Para obter mais informações, consulte Parcial (Visual Basic) ou parcial (referência de C#) (tipo).

Localizando TableAdapters no Código

Enquanto TableAdapters são criados com o DataSet Designer, as classes TableAdapter geradas não serão geradas como classes aninhados do DataSet.TableAdapters estão localizados em um namespace baseado no nome do DataSet associado do TableAdapter.Por exemplo, se seu aplicativo contém um conjunto de dados chamado HRDataSet, os TableAdapters estariam localizados no namespace HRDataSetTableAdapters.(A convenção de nomeclatura segue este padrão: DatasetName + TableAdapters).

O exemplo a seguir pressupõe um TableAdapter chamado CustomersTableAdapter em um projeto com um NorthwindDataSet.

Para criar uma classe parcial para um TableAdapter

  1. Adicione uma nova classe ao projeto, escolhendo Add Class no menu Project.

  2. Nomeie a classe CustomersTableAdapterExtended.

  3. Clique em Adicionar.

  4. Substitua no código o namespace adequado e nome da classe parcial para seu projeto.Por exemplo:

    Namespace NorthwindDataSetTableAdapters
    
        Partial Class CustomersTableAdapter
    
            ' Add user code here. For example:
            Public Overrides Function ToString() As String
                Return "Overridden in the partial class."
            End Function
        End Class
    End Namespace
    
    namespace NorthwindDataSetTableAdapters
    {
        public partial class CustomersTableAdapter
        {
            // Add user code here. For example:
            public override string ToString()
            {
                return "Overridden in the partial class.";
            }
        }
    }
    

Consulte também

Tarefas

Como: criar TableAdapters

Como: criar consultas TableAdapter

Como: estender a funcionalidade de um Dataset.

Conceitos

Visão geral do TableAdapter

Vinculando controles do Windows Forms a dados em Visual Studio

Preparando seu aplicativo para receber dados

Buscando dados em seu aplicativo.

Controles de vinculação de dados de Visual Studio

Edição de dados em seu aplicativo.

Validação de dados

Salvar dados

Outros recursos

Explicações passo a passo de dados

Visão geral dos aplicativos de dados em Visual Studio

Connecting to Data in Visual Studio