Parcial (Visual Basic)

Artigo
04/07/2023

Indica que uma declaração de tipo é uma definição parcial do tipo.

É possível dividir a definição de um tipo entre diversas declarações usando a palavra-chave Partial. É possível usar quantas declarações parciais você desejar, em quantos arquivos de origem diferentes desejar. No entanto, todas as declarações devem estar no mesmo assembly e no mesmo namespace.

Observação

O Visual Basic dá suporte a métodos parciais, que normalmente são implementados em classes parciais. Para obter mais informações, consulte Métodos Parciais e Sub instrução.

Sintaxe

[ <attrlist> ] [ accessmodifier ] [ Shadows ] [ MustInherit | NotInheritable ] _  
Partial { Class | Structure | Interface | Module } name [ (Of typelist) ]  
    [ Inherits classname ]  
    [ Implements interfacenames ]  
    [ variabledeclarations ]  
    [ proceduredeclarations ]  
{ End Class | End Structure }

Partes

Termo	Definição
`attrlist`	Opcional. Lista de atributos que se aplicam a esse tipo. Você deve colocar a Lista de Atributos entre colchetes angulares (`< >`).
`accessmodifier`	Opcional. Especifica qual código pode acessar esse tipo. Confira Níveis de acesso no Visual Basic.
`Shadows`	Opcional. Confira Sombras.
`MustInherit`	Opcional. Confira MustInherit.
`NotInheritable`	Opcional. Confira NotInheritable.
`name`	Obrigatórios. Nome desse tipo. Deve corresponder ao nome definido em todas as outras declarações parciais do mesmo tipo.
`Of`	Opcional. Especifica que esse é um tipo genérico. Confira Tipos genéricos no Visual Basic.
`typelist`	Obrigatório se você usar Of. Confira Lista de tipos.
`Inherits`	Opcional. Confira Instrução Inherits.
`classname`	Obrigatório se você usar `Inherits`. O nome da classe ou interface da qual essa classe deriva.
`Implements`	Opcional. Consulte Instrução implementa.
`interfacenames`	Obrigatório se você usar `Implements`. Os nomes das interfaces que esse tipo implementa.
`variabledeclarations`	Opcional. Instruções que declaram variáveis e eventos adicionais para o tipo.
`proceduredeclarations`	Opcional. Instruções que declaram e definem procedimentos adicionais para o tipo.
`End Class` ou `End Structure`	Termina essa definição parcial `Class` ou `Structure`.

Comentários

O Visual Basic usa definições de classe parcial para separar o código gerado do código criado pelo usuário em arquivos de origem separados. Por exemplo, o Windows Form Designer define classes parciais para controles, como Form. Você não deve modificar o código gerado nesses controles.

Todas as regras para criação de classe, estrutura, interface e módulo, bem como as que são para uso e herança do modificador, se aplicam ao criar um tipo parcial.

Práticas Recomendadas

Em circunstâncias normais, você não deve dividir o desenvolvimento de um tipo simples em duas ou mais declarações. Portanto, na maioria dos casos, você não precisa da palavra-chave Partial.
Para legibilidade, cada declaração parcial de um tipo deve incluir a palavra-chave Partial. O compilador permite, no máximo, uma declaração parcial omitir a palavra-chave; se dois ou mais omitirem, o compilador sinalizará um erro.

Comportamento

União de Declarações. O compilador trata o tipo como a união de todas as suas declarações parciais. Cada modificador de cada definição parcial se aplica ao tipo inteiro e cada membro de cada definição parcial está disponível para o tipo inteiro.
Promoção de tipo não permitida para tipos parciais em módulos. Se uma definição parcial estiver dentro de um módulo, a promoção de tipo desse tipo será derrotada automaticamente. Nesse caso, um conjunto de definições parciais pode causar resultados inesperados e até erros do compilador. Para obter mais informações, confira Promoção de tipos.

O compilador mescla definições parciais somente quando seus caminhos totalmente qualificados são idênticos.

A palavra-chave Partial pode ser usada nestes dois contextos:

Instrução Class

Instrução Structure

Exemplo

O exemplo a seguir divide a definição da classe sampleClass em duas declarações, cada uma das quais define um procedimento Sub diferente.

Partial Public Class sampleClass
    Public Sub sub1()
    End Sub
End Class
Partial Public Class sampleClass
    Public Sub sub2()
    End Sub
End Class

As duas definições parciais no exemplo anterior podem estar no mesmo arquivo de origem ou em dois arquivos de origem diferentes.

Compartilhar via