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

Částečné klíčové slovo umožňuje, aby různé části stejné třídy ref byly vytvořené nezávisle a v různých souborech.

Všechny moduly runtime

(Tato funkce jazyka se vztahuje pouze na prostředí Windows Runtime.)

prostředí Windows Runtime

U ref třídy, která má dvě částečné definice, se částečné klíčové slovo použije na první výskyt definice, a to obvykle provádí automaticky vygenerovaný kód, takže člověk kód nepoužívá klíčové slovo velmi často. Pro všechny následné částečné definice třídy vynecháte částečný modifikátor z klíčového slova třídy a identifikátoru třídy. Když kompilátor narazí na dříve definovanou třídu ref a identifikátor třídy, ale bez částečného klíčového slova, interně kombinuje všechny části definice třídy ref do jedné definice.

Syntaxe

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. */
}

Parametry

class-key
Klíčové slovo, které deklaruje třídu nebo strukturu podporovanou prostředí Windows Runtime. Buď ref class, value class, refstruct, or value struct.

identifikátor
Název definovaného typu.

Poznámky

Částečná třída podporuje scénáře, kdy upravujete jednu část definice třídy v jednom souboru a automatický software generující kód – například návrhář XAML – upravuje kód ve stejné třídě v jiném souboru. Pomocí částečné třídy můžete zabránit automatickému generátoru kódu v přepsání kódu. V projektu sady Visual Studio se na vygenerovaný soubor automaticky použije částečný modifikátor.

Obsah: Se dvěma výjimkami může částečná definice třídy obsahovat cokoli, co může úplná definice třídy obsahovat, pokud bylo vynecháno částečné klíčové slovo. Nemůžete ale zadat přístupnost třídy (například public partial class X { ... };) nebo declspec.

Specifikátory přístupu používané v definici částečné třídy pro identifikátor nemají vliv na výchozí přístupnost v následné částečné nebo úplné definici třídy identifikátoru. Jsou povoleny vložené definice statických datových členů.

Deklarace: Částečná definice identifikátoru třídy zavádí pouze identifikátor názvu, ale identifikátor nelze použít způsobem, který vyžaduje definici třídy. Identifikátor názvu se nedá použít ke zjištění velikosti identifikátoru nebo k použití základního nebo člena identifikátoru, dokud kompilátor nenarazí na úplnou definici identifikátoru.

Číslo a řazení: Identifikátor může obsahovat nulové nebo více částečných definic tříd. Každá částečná definice identifikátoru musí lexicky předcházet jedné úplné definici identifikátoru (pokud existuje úplná definice; jinak nelze třídu použít s výjimkou případů, kdy je deklarováno předávání), ale nemusí předcházet před deklaracemi identifikátoru. Všechny klíče třídy se musí shodovat.

Úplná definice: V okamžiku úplné definice identifikátoru třídy je chování stejné jako v případě, že definice identifikátoru deklarovala všechny základní třídy, členy atd. v pořadí, v jakém byly zjištěny a definovány v částečných třídách.

Šablony: Částečná třída nemůže být šablonou.

Obecné typy: Částečná třída může být obecná, pokud by úplná definice mohla být obecná. Každá částečná a úplná třída ale musí mít přesně stejné obecné parametry, včetně formálních názvů parametrů.

Další informace o použití částečného klíčového slova naleznete v tématu Částečné třídy (C++/CX).

Požadavky

Možnost kompilátoru: /ZW

CLR (Common Language Runtime)

(Tato funkce jazyka se nevztahuje na modul CLR (Common Language Runtime).)

Viz také

Částečné třídy (C++/CX)