Partial (Visual Basic)

Článek
03/05/2024

Označuje, že deklarace typu je částečnou definicí typu.

Definici typu můžete rozdělit mezi několik deklarací pomocí klíčového Partial slova. V mnoha různých zdrojových souborech můžete použít libovolný počet částečných deklarací. Všechny deklarace však musí být ve stejném sestavení a stejném oboru názvů.

Poznámka:

Visual Basic podporuje částečné metody, které jsou obvykle implementovány v částečných třídách. Další informace naleznete v části Částečné metody a dílčí příkaz.

Syntaxe

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

Součástky

Pojem	definice
`attrlist`	Nepovinné. Seznam atributů, které se vztahují na tento typ Seznam atributů musíte uzavřít do úhlových závorek (`< >`).
`accessmodifier`	Nepovinné. Určuje, jaký kód má přístup k tomuto typu. Viz úrovně Accessu v jazyce Visual Basic.
`Shadows`	Nepovinné. Podívejte se na stíny.
`MustInherit`	Nepovinné. Viz MustInherit.
`NotInheritable`	Nepovinné. Viz NotInheritable.
`name`	Povinný: Název tohoto typu Musí odpovídat názvu definovanému ve všech ostatních částečných deklaracích stejného typu.
`Of`	Nepovinné. Určuje, že se jedná o obecný typ. Viz obecné typy v jazyce Visual Basic.
`typelist`	Vyžaduje se, pokud používáte Viz seznam typů.
`Inherits`	Nepovinné. Viz Příkaz Zdědědí.
`classname`	Vyžaduje se, pokud používáte `Inherits`. Název třídy nebo rozhraní, ze které tato třída odvozuje.
`Implements`	Nepovinné. Viz Implements – příkaz.
`interfacenames`	Vyžaduje se, pokud používáte `Implements`. Názvy rozhraní, která tento typ implementuje.
`variabledeclarations`	Nepovinné. Příkazy, které deklarují další proměnné a události pro typ.
`proceduredeclarations`	Nepovinné. Příkazy, které deklarují a definují další procedury pro typ.
`End Class` nebo `End Structure`	Ukončí tuto částečnou `Class` nebo `Structure` definici.

Poznámky

Visual Basic používá definice částečné třídy k oddělení generovaného kódu od uživatelem vytvořeného kódu v samostatných zdrojových souborech. Například Windows Form Designer definuje částečné třídy pro ovládací prvky, jako Formje . V těchto ovládacích prvcích byste neměli upravovat vygenerovaný kód.

Všechna pravidla pro vytváření tříd, struktur, rozhraní a modulů, například pro použití a dědičnost modifikátoru, se použijí při vytváření částečného typu.

Osvědčené postupy

Za normálních okolností byste neměli rozdělit vývoj jednoho typu na dvě nebo více deklarací. Proto ve většině případů nepotřebujete Partial klíčové slovo.
Pro čitelnost by každá částečná deklarace typu měla obsahovat Partial klíčové slovo. Kompilátor umožňuje maximálně jednu částečnou deklaraci vynechat klíčové slovo; pokud ho dva nebo více vynechá, kompilátor signalizuje chybu.

Chování

Unie prohlášení. Kompilátor považuje typ za sjednocení všech jeho částečných deklarací. Každý modifikátor z každé částečné definice platí pro celý typ a každý člen z každé částečné definice je k dispozici pro celý typ.
U částečných typů v modulech není povoleno povýšení typu. Pokud je částečná definice uvnitř modulu, povýšení typu tohoto typu se automaticky porazí. V takovém případě může sada částečných definic způsobit neočekávané výsledky a dokonce chyby kompilátoru. Další informace naleznete v tématu Zvýšení úrovně typu.

Kompilátor sloučí částečné definice pouze v případě, že jsou jejich plně kvalifikované cesty identické.

Klíčové Partial slovo lze použít v těchto kontextech:

Příkaz Class

Příkaz Structure

Příklad

Následující příklad rozdělí definici třídy sampleClass na dvě deklarace, z nichž každá definuje jiný Sub postup.

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

Dvě částečné definice v předchozím příkladu můžou být ve stejném zdrojovém souboru nebo ve dvou různých zdrojových souborech.

Sdílet prostřednictvím