partial (C++/CLI e C++/CX)

La parola chiave partial consente di creare parti diverse della stessa classe di riferimento in modo indipendente e in file diversi.

Tutti i runtime

Questa funzionalità del linguaggio si applica solo a Windows Runtime.

Windows Runtime

Per una classe di riferimento con due definizioni parziali, la parola chiave partial viene applicata alla prima occorrenza della definizione e questa operazione viene in genere eseguita dal codice generato automaticamente, in modo che un coder umano non usi molto spesso la parola chiave . Per tutte le definizioni parziali successive della classe, omettere il modificatore partial dalla parola chiave class-key e dall'identificatore di classe. Quando il compilatore rileva una classe di riferimento e un identificatore di classe definiti in precedenza ma non la parola chiave partial, combina internamente tutte le parti della definizione della classe di riferimento in una definizione.

Sintassi

partial class-key identifier {
   /* The first part of the partial class definition.
      This is typically auto-generated */
}
// ...
class-key identifier {
   /* The subsequent part(s) of the class definition. The same
      identifier is specified, but the "partial" keyword is omitted. */
}

Parametri

class-key
Parola chiave che dichiara una classe o uno struct supportato da Windows Runtime. Può trattarsi di una classe di riferimento, una classe di valori, uno struct ref o uno struct di valori.

identificatore
Nome del tipo definito.

Osservazioni:

Una classe parziale supporta scenari in cui si modifica una parte di una definizione di classe in un file e il software che genera codice automaticamente, ad esempio la finestra di progettazione XAML, modifica il codice nella stessa classe in un altro file. Usando una classe parziale, è possibile impedire al generatore di codice automatico di sovrascrivere il codice. In un progetto di Visual Studio il modificatore partial viene applicato automaticamente al file generato.

Contenuto: con due eccezioni, una definizione di classe parziale può contenere qualsiasi elemento che la definizione completa della classe possa contenere se la parola chiave parziale è stata omessa. Non è tuttavia possibile specificare l'accessibilità della classe (ad esempio public partial class X { ... };) o un oggetto declspec.

Gli identificatori di accesso usati in una definizione di classe parziale per identifier non influiscono sull'accessibilità predefinita in una definizione di classe parziale o completa successiva per identifier. Sono consentite le definizioni inline di membri dati statici.

Dichiarazione: una definizione parziale di un identificatore di classe introduce solo l'identificatore del nome, ma l'identificatore non può essere usato in modo da richiedere una definizione di classe. Il nome identifier non può essere usato per conoscere la dimensione di identifier o per usare una classe di base o un membro di identifier fino a quando il compilatore non raggiunge la definizione completa di identifier.

Numero e ordinamento: per l'identificatore possono essere presenti zero o più definizioni di classi parziali. Ogni definizione di classe parziale di identifier deve precedere lessicalmente la definizione completa di identifier (se la definizione completa è presente; in caso contrario, la classe non può essere usata se non come dichiarazione con prototipo), ma non è necessario che preceda le dichiarazioni con prototipo di identifier. Tutti gli elementi class-key devono corrispondere.

Definizione completa: al punto della definizione completa dell'identificatore di classe, il comportamento è uguale a se la definizione dell'identificatore avesse dichiarato tutte le classi base, i membri e così via nell'ordine in cui sono stati rilevati e definiti nelle classi parziali.

Modelli: una classe parziale non può essere un modello.

Generics: una classe parziale può essere un generico se la definizione completa potrebbe essere generica. Ogni classe parziale e completa deve tuttavia avere esattamente gli stessi parametri generici, compresi i nomi di parametri formali.

Per altre informazioni su come usare la parola chiave partial, vedere Classi parziali (C++/CX).

Requisiti

Opzione del compilatore: /ZW

Common Language Runtime

Questa funzionalità del linguaggio non si applica a Common Language Runtime.

Vedi anche

Classi parziali (C++/CX)