Freigeben über

Partielle (Visual Basic)

Gibt an, dass eine Typdeklaration eine partielle Definition des Typs ist.

Sie können die Definition eines Typs unter mehreren Deklarationen unterteilen, indem Sie das Partial Schlüsselwort verwenden. Sie können beliebig viele partielle Deklarationen in beliebig vielen verschiedenen Quelldateien verwenden. Alle Deklarationen müssen sich jedoch in derselben Assembly und im selben Namespace befinden.

Hinweis

Visual Basic unterstützt partielle Methoden, die in der Regel in partiellen Klassen implementiert werden. Weitere Informationen finden Sie unter Partielle Methoden und Sub-Anweisung.

Syntax

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

Bestandteile

Begriff Definition
attrlist Wahlfrei. Liste der Attribute, die für diesen Typ gelten. Sie müssen die Attributliste in eckige Klammern (< >) einschließen.
accessmodifier Wahlfrei. Gibt an, auf welchen Code auf diesen Typ zugreifen kann. Siehe Access-Ebenen in Visual Basic.
Shadows Wahlfrei. Siehe Schatten.
MustInherit Wahlfrei. Siehe MustInherit.
NotInheritable Wahlfrei. Siehe "NotInheritable".
name Erforderlich. Name dieses Typs. Muss mit dem Namen übereinstimmen, der in allen anderen Teildeklarationen desselben Typs definiert ist.
Of Wahlfrei. Gibt an, dass es sich um einen generischen Typ handelt. Siehe generische Typen in Visual Basic.
typelist Erforderlich, wenn Sie Of verwenden. Siehe Typliste.
Inherits Wahlfrei. Siehe Inherits-Anweisung.
classname Erforderlich, wenn Sie Inherits. Der Name der Klasse oder Schnittstelle, von der diese Klasse abgeleitet wird.
Implements Wahlfrei. Siehe Implements-Anweisung.
interfacenames Erforderlich, wenn Sie Implements. Die Namen der Schnittstellen, die dieser Typ implementiert.
variabledeclarations Wahlfrei. Anweisungen, die zusätzliche Variablen und Ereignisse für den Typ deklarieren.
proceduredeclarations Wahlfrei. Anweisungen, die zusätzliche Prozeduren für den Typ deklarieren und definieren.
End Class oder End Structure Beendet diese Teil Class - oder Structure Definition.

Bemerkungen

Visual Basic verwendet Partielle Klassendefinitionen, um generierten Code von vom Benutzer erstellten Code in separaten Quelldateien zu trennen. Der Windows Form-Designer definiert z. B. Partielle Klassen für Steuerelemente wie Formz. B. . Sie sollten den generierten Code in diesen Steuerelementen nicht ändern.

Alle Regeln für die Klassen-, Struktur-, Schnittstellen- und Modulerstellung, z. B. für die Verwendung und Vererbung von Modifizierern, gelten beim Erstellen eines Teiltyps.

Bewährte Methoden

  • Unter normalen Umständen sollten Sie die Entwicklung eines einzelnen Typs nicht über zwei oder mehr Deklarationen aufteilen. Daher benötigen Partial Sie in den meisten Fällen das Schlüsselwort nicht.

  • Zur Lesbarkeit sollte jede partielle Deklaration eines Typs das Partial Schlüsselwort enthalten. Der Compiler ermöglicht höchstens eine teilweise Deklaration, das Schlüsselwort auszulassen; wenn zwei oder mehr auslassen, signalisiert der Compiler einen Fehler.

Verhalten

  • Union der Erklärungen. Der Compiler behandelt den Typ als Vereinigung aller partiellen Deklarationen. Jeder Modifizierer aus jeder Teildefinition gilt für den gesamten Typ, und jedes Element aus jeder Teildefinition ist für den gesamten Typ verfügbar.

  • Für Teiltypen in Modulen ist die Typaufwendung nicht zulässig. Wenn sich eine Teildefinition innerhalb eines Moduls befindet, wird die Typförderung dieses Typs automatisch besiegt. In einem solchen Fall kann ein Satz von Teildefinitionen unerwartete Ergebnisse und sogar Compilerfehler verursachen. Weitere Informationen finden Sie unter Type Promotion.

    Der Compiler führt Teildefinitionen nur zusammen, wenn ihre vollqualifizierten Pfade identisch sind.

Das Partial Schlüsselwort kann in folgenden Kontexten verwendet werden:

Klassen-Anweisung

Struktur-Deklaration

Beispiel

Im folgenden Beispiel wird die Definition der Klasse sampleClass in zwei Deklarationen aufgeteilt, von denen jede eine andere Sub Prozedur definiert.

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

Die beiden Teildefinitionen im vorherigen Beispiel können sich in derselben Quelldatei oder in zwei verschiedenen Quelldateien befinden.

Siehe auch

  • Last updated on