Compartilhar via


Estender a funcionalidade de um TableAdapter

 

Publicado: abril de 2016

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 alterações são 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 ao arquivo de classe parcial do TableAdapter.

(Classes parciais permitem codificar uma classe específica ser dividida entre arquivos físicos múltiplos. Para obter mais informações, consulte Parcial ou partial (tipo).)

Localizando TableAdapters no código

Enquanto TableAdapters são criados com o Dataset Designer, as classes TableAdapter geradas não são geradas como classes aninhadas 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, o TableAdapters deve estar localizado no HRDataSetTableAdapters namespace. (A convenção de nomeação segue este padrão: DatasetName + TableAdapters).

O exemplo a seguir supõ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 seu projeto, escolhendo Add Class do projeto menu.

  2. Nomeie a classe CustomersTableAdapterExtended.

  3. Clique em Adicionar.

  4. Substitua o código com o namespace apropriado e o nome de classe parcial para seu projeto. Por exemplo:

    namespace NorthwindDataSetTableAdapters
    {
        public partial class CustomersTableAdapter
        {
            // Add user code here. For example:
            public override string ToString()
            {
                return "Overridden in the partial class.";
            }
        }
    }
    
    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
    

Consulte também

Preencher datasets usando TableAdapters