Parcial (Visual Basic)

Artigo
06/08/2015

Indica que uma declaração de classe ou estrutura é uma definição de classe ou estrutura parcial.

Você pode dividir a definição de uma classe ou estrutura entre diversas declarações usando a Partial palavra-chave. Você pode usar declarações parciais de tantas quantas desejar, nos arquivos de origem diferentes quantos desejar. No entanto, todas as declarações devem estar no mesmo assembly e o mesmo namespace.

Dica

Suporta Visual Basic métodos parciais, que são geralmente implementados em classes parciais.Para obter mais informações, consulte Métodos parciais (Visual Basic) e Instrução Sub (Visual Basic).

[ <attrlist> ] [ accessmodifier ] [ Shadows ] [ MustInherit | NotInheritable ] _
Partial { Class | Structure } 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 essa classe ou estrutura. Você deve colocar o Lista de atributos (Visual Basic) Entre colchetes angulares (< >).
accessmodifier	Opcional. Especifica o código pode acessar essa classe ou estrutura. Consulte Níveis de acesso no Visual Basic.
Shadows	Opcional. Consulte Sombras (Visual Basic).
MustInherit	Opcional. Consulte MustInherit (Visual Basic).
NotInheritable	Opcional. Consulte NotInheritable (Visual Basic).
name	Obrigatório. Nome dessa classe ou estrutura. Deve corresponder ao nome definido na todas as outras declarações parciais da mesma classe ou estrutura.
Of	Opcional. Especifica que esta é uma classe genérica ou estrutura. Consulte Tipos genéricos no Visual Basic (Visual Basic).
typelist	Necessário se você usar de. Consulte Lista de tipos (Visual Basic).
Inherits	Opcional. Consulte Instrução Inherits.
classname	Necessário se você usar Inherits. O nome da classe ou de interface do qual deriva dessa classe.
Implements	Opcional. Consulte Instrução Implements.
interfacenames	Necessário se você usar Implements. Os nomes das interfaces que essa estrutura implementa.
variabledeclarations	Opcional. As instruções que declarar variáveis adicionais e eventos para a classe ou estrutura.
proceduredeclarations	Opcional. As instruções que declare e definem procedimentos adicionais para a classe ou estrutura.
End ClassouEnd Structure	Encerra este Class parcial ou Structure definição.

Comentários

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

Todas as regras para criação de classe e estrutura, como aqueles para uso de modificador e herança, se aplicam ao criar um classe parcial ou estrutura.

Práticas recomendadas

Em circunstâncias normais, você não deve dividir o desenvolvimento de uma única classe ou estrutura entre dois ou mais declarações. Portanto, na maioria dos casos você não precisa a Partial palavra-chave.
Para facilitar a leitura, cada declaração parcial de uma classe ou estrutura deve incluir a Partial palavra-chave. O compilador permite no máximo uma declaração parcial omitir a palavra-chave; se duas ou mais omiti-lo o compilador sinaliza um erro.

Comportamento

União de declaração. O compilador trata a classe ou estrutura como a união de todas as suas declarações parciais. Cada modificador de cada definição parcial aplica à toda a classe ou estrutura, e cada membro de cada definição parcial está disponível para a toda a classe ou estrutura.
Promoção tipo não permitida para tipos parciais em módulos. Se for uma definição parcial em um módulo, promoção de tipos da classe ou estrutura será automaticamente derrotada. Em tais casos, um conjunto de definições parciais pode causar resultados inesperados e até mesmo Erros de compilador. Para obter mais informações, consulte Promoção de tipos (Visual Basic).

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

A palavra-chave Partial pode ser usada nesses contextos:

Declaração de Classe

Instrução Structure

Exemplo

O exemplo a seguir divide a definição de classe sampleClass em duas declarações, cada um deles define um Sub procedimento 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 pode ser no mesmo arquivo de origem ou nos dois arquivos de origem diferentes.