Parcial (Visual Basic)

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.

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

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.

Confira também

• Instrução Class
• Instrução Structure
• Tipo de promoção
• Sombras
• Tipos genéricos no Visual Basic
• Métodos Parciais