Partial (Visual Basic)

Aggiornamento: novembre 2007

Indica che una dichiarazione di classe o struttura è una definizione parziale della classe o della struttura.

È possibile dividere la definizione di una classe o struttura tra più dichiarazioni mediante la parola chiave Partial, nonché utilizzare tutte le dichiarazioni parziali desiderate, in tutti i file di origine differenti desiderati. Tutte le dichiarazioni, tuttavia, devono trovarsi in un assembly e in uno spazio dei nomi identici.

Nota:
Visual Basic 2008 introduce metodi parziali per l'utilizzo nelle classi parziali. Per ulteriori informazioni, vedere Metodi parziali e Istruzione Sub (Visual Basic).

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

Parti

• attrlist
  Facoltativa. Elenco di attributi applicabili a questa classe o struttura. È necessario racchiudere l'Elenco degli attributi tra parentesi angolari (< >).

• accessmodifier
  Facoltativa. Specifica il codice che può accedere a questa classe o struttura. Vedere Livelli di accesso in Visual Basic.

• Shadows
  Facoltativa. Vedere Shadows.

• MustInherit
  Facoltativa. Vedere MustInherit.

• NotInheritable
  Facoltativa. Vedere NotInheritable.

• name
  Obbligatoria. Nome della classe o struttura. Deve corrispondere al nome definito in tutte le altre dichiarazioni parziali della stessa classe o struttura.

• Of
  Facoltativa. Specifica che si tratta di una classe o di una struttura generica. Vedere Tipi generici in Visual Basic.

• typelist
  Obbligatoria se si utilizza Of. Vedere Elenco dei tipi.

• Inherits
  Facoltativa. Vedere Istruzione Inherits.

• classname
  Obbligatoria se si utilizza Inherits. Nome della classe o dell'interfaccia dalla quale deriva la classe.

• Implements
  Facoltativa. Vedere Istruzione Implements.

• interfacenames
  Obbligatoria se si utilizza Implements. Nomi delle interfacce implementate dalla classe o dalla struttura.

• variabledeclarations
  Facoltativa. Istruzioni che dichiarano variabili ed eventi aggiuntivi per la classe o la struttura.

• proceduredeclarations
  Facoltativa. Istruzioni che dichiarano e definiscono routine aggiuntive per la classe o la struttura.

• End Class oppure End Structure
  Termina questa definizione Class o Structure parziale.

Note

In Visual Basic vengono utilizzate definizioni di classi parziali per separare il codice generato dal codice creato dall'utente in file di origine distinti. In Progettazione Windows Form, ad esempio, vengono definite classi parziali per controlli come Form. In questi controlli il codice generato non deve essere modificato.

Durante la creazione di una classe o di una struttura parziale vengono applicate tutte le regole per la creazione delle classi e delle strutture, ad esempio quelle relative all'utilizzo dei modificatori e all'ereditarietà.

Suggerimenti

• In condizioni normali, non è consigliabile suddividere lo sviluppo di una singola classe o struttura in due o più dichiarazioni. Pertanto, nella maggior parte dei casi non è necessario specificare la parola chiave Partial.

• Per migliorare la leggibilità, ogni dichiarazione parziale di una classe o struttura deve includere la parola chiave Partial. Il compilatore consente che la parola chiave venga omessa al massimo in una dichiarazione parziale. Se viene omessa in due o più dichiarazioni, viene segnalato un errore.

Comportamento

• Unione delle dichiarazioni. Il compilatore considera la classe o struttura come l'unione di tutte le relative dichiarazioni parziali. Ogni modificatore di ciascuna definizione parziale viene applicato all'intera classe o struttura e ogni membro di ciascuna definizione parziale è disponibile per l'intera classe o struttura.

• Promozione del tipo non consentita per i tipi parziali nei moduli. Se una definizione parziale si trova all'interno di un modulo, l'effetto della promozione del tipo di tale classe o struttura viene automaticamente annullato. In questo caso, un insieme di definizioni parziali può generare risultati imprevisti e persino errori del compilatore. Per ulteriori informazioni, vedere Promozione del tipo.

  Il compilatore unisce le definizioni parziali solo se i relativi percorsi completi sono identici.

È possibile utilizzare la parola chiave Partial nei seguenti contesti:

Istruzione Class

Istruzione Structure

Esempio

Nell'esempio di codice che segue la definizione della classe sampleClass viene suddivisa in due dichiarazioni, ognuna delle quali definisce una routine Sub differente.

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

Le due definizioni parziali nell'esempio precedente possono trovarsi nello stesso file di origine o in due file di origine differenti.

Vedere anche

Attività

Procedura: creare un metodo parziale (Visual Basic)

Concetti

Promozione del tipo

Tipi generici in Visual Basic

Metodi parziali

Riferimenti

Istruzione Class (Visual Basic)

Istruzione Structure

Shadows