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 partial (tipo) (Referência de C#).

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 conjunto de dados

Conceitos

Visão geral de TableAdapter

Associando controles dos Windows Forms a dados no Visual Studio

Preparando o aplicativo para receber dados

Buscando dados no aplicativo

Associando controles a dados no Visual Studio

Editando dados no aplicativo

Validando dados

Salvando dados

Outros recursos

Instruções passo a passo de dados

Visão geral de aplicativos de dados no Visual Studio

Conectando a dados no Visual Studio