Partial (Visual Basic)

Articolo
03/05/2013

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 supporta i metodi parziali, che in genere vengono implementati nelle classi parziali.Per ulteriori informazioni, vedere Metodi parziali (Visual Basic) 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

Termine	Definizione
attrlist	Parametro facoltativo.Elenco di attributi applicabili a questa classe o struttura.È necessario racchiudere l'Elenco degli attributi (Visual Basic) tra parentesi angolari (< >).
accessmodifier	Parametro facoltativo.Specifica il codice che può accedere a questa classe o struttura.Vedere Livelli di accesso in Visual Basic.
Shadows	Parametro facoltativo.Vedere Shadows (Visual Basic).
MustInherit	Parametro facoltativo.Vedere MustInherit (Visual Basic).
NotInheritable	Parametro facoltativo.Vedere NotInheritable (Visual Basic).
name	Obbligatorio.Nome della classe o struttura.Deve corrispondere al nome definito in tutte le altre dichiarazioni parziali della stessa classe o struttura.
Of	Parametro facoltativo.Specifica che si tratta di una classe o di una struttura generica.Vedere Tipi generici in Visual Basic (Visual Basic).
typelist	Obbligatoria se si utilizza Of.Vedere Elenco dei tipi (Visual Basic).
Inherits	Parametro facoltativo.Vedere Istruzione Inherits.
classname	Obbligatoria se si utilizza Inherits.Nome della classe o dell'interfaccia dalla quale deriva la classe.
Implements	Parametro facoltativo.Vedere Istruzione Implements.
interfacenames	Obbligatoria se si utilizza Implements.Nomi delle interfacce implementate dalla classe o dalla struttura.
variabledeclarations	Parametro facoltativo.Istruzioni che dichiarano variabili ed eventi aggiuntivi per la classe o la struttura.
proceduredeclarations	Parametro facoltativo.Istruzioni che dichiarano e definiscono routine aggiuntive per la classe o la struttura.
End Class o 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 tipo (Visual Basic).

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.