Compartilhar via


Partial (Visual Basic)

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 várias declarações usando a Partial palavra-chave. Você pode usar declarações parcial quantas desejar, nos arquivos de fonte diferentes quantas desejar.No entanto, todas as declarações devem estar no mesmo assembly e o mesmo namespace.

Observação:

Visual Basic 2008 apresenta métodos parcial para uso em classes parcial.Para obter mais informações, consulte Métodos parciais e Sub-rotina demonstrativo (Visual Basic).

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

Partes

  • attrlist
    Opcional.Lista de atributos que se aplicam a essa classe ou estrutura.Você deve colocar o Lista de atributos Entre colchetes angulares (< >).

  • accessmodifier
    Opcional.Especifica o código pode acessar essa classe ou estrutura.SeeNíveis de acesso em Visual Basic.

  • Shadows
    Opcional.SeeSombras.

  • MustInherit
    Opcional.SeeMustInherit.

  • NotInheritable
    Opcional.SeeNotInheritable.

  • 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.SeeTipos genéricos no Visual Basic.

  • typelist
    Necessário se você usar de.SeeLista de tipos.

  • Inherits
    Opcional.SeeDeclaração Inherits.

  • classname
    Necessário se você usar Inherits. O nome da classe ou de interface do qual deriva dessa classe.

  • Implements
    Opcional.SeeImplementa Declaração.

  • 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 Class ou End 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 de uma classe ou estrutura parcial deve incluir o 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 Tipo.

    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.

Consulte também

Tarefas

Como: Criar um método parcial (Visual Basic)

Conceitos

Promoção de Tipo

Tipos genéricos no Visual Basic

Métodos parciais

Referência

Declaração Class (Visual Basic)

Instrução Structure

Sombras