Parcial (Visual Basic)

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

Você pode dividir a definição de um tipo entre várias declarações usando a Partial palavra-chave. Você pode usar quantas declarações parciais quiser, em quantos arquivos de origem diferentes desejar. No entanto, todas as declarações devem estar no mesmo assembly e no mesmo namespace.

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

Observações

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, como aquelas para uso e herança de modificadores, aplicam-se ao criar um tipo parcial.

Melhores práticas

• Em circunstâncias normais, você não deve dividir o desenvolvimento de um único tipo em duas ou mais declarações. Portanto, na maioria dos casos, você não precisa da Partial palavra-chave.

• Para facilitar a leitura, cada declaração parcial de um tipo deve incluir a palavra-chave Partial . O compilador permite que no máximo uma declaração parcial omita a palavra-chave; Se dois ou mais omitirem, o compilador sinaliza 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 aplica-se 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á automaticamente derrotada. Nesse caso, um conjunto de definições parciais pode causar resultados inesperados e até mesmo erros do compilador. Para obter mais informações, consulte Tipo de promoção.

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

A Partial palavra-chave pode ser usada nestes contextos:

Declaração de classe

Declaração de estrutura

Exemplo

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

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.

Consulte também

• Declaração de classe
• Declaração de estrutura
• Tipo de Promoção
• Sombras
• Tipos genéricos no Visual Basic
• Métodos parciais