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.
.gif "Nota") 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:
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)