Share via


Gewusst wie: Erstellen einer partiellen Methode (Visual Basic)

Aktualisiert: November 2007

Mithilfe von partiellen Methoden können Entwickler benutzerdefinierte Logik in vom Designer generierten Code einfügen. Dies wird häufig zur Datenvalidierung eingesetzt. Das Erstellen einer partiellen Methode gliedert sich in zwei Teile: das Definieren der Methodensignatur und das Schreiben der Implementierung. Die Definition wird in der Regel vom Designer eines Code-Generators geschrieben und die Implementierung von einem Entwickler, der den generierten Code verwendet. Weitere Informationen finden Sie unter Partielle Methoden.

So definieren Sie die Methodensignatur

  1. Beginnen Sie die Signatur in einer partiellen Klasse mit dem Schlüsselwort Partial.

  2. Verwenden Sie Private als Zugriffsmodifizierer.

  3. Fügen Sie das Sub-Schlüsselwort hinzu. Die Methode muss eine Sub-Prozedur sein.

  4. Schreiben Sie den Namen der Methode.

  5. Stellen Sie die Parameterliste für die Methode bereit.

  6. Beenden Sie die Methode mit End Sub.

So implementieren Sie die Methode

  1. Verwenden Sie Private als Zugriffsmodifizierer.

  2. Fügen Sie alle anderen Modifizierer hinzu, die Sie benötigen.

  3. Schreiben Sie den Namen der Methode. Dieser muss mit dem Namen in der Signaturdefinition übereinstimmen.

  4. Fügen Sie die Parameterliste hinzu. Parameternamen müssen mit den Namen in der Signatur übereinstimmen. Parameterdatentypen müssen nicht angegeben werden.

  5. Definieren Sie den Text der Methode.

  6. Schließen Sie mit einer End Sub-Anweisung.

Beispiel

Die Definition und Implementierung einer partiellen Methode befinden sich im Allgemeinen in separaten Dateien, die durch eine partielle Klasse erstellt werden. Der Zweck einer partiellen Methode besteht üblicherweise darin, Benachrichtigungen zur Verfügung zu stellen, wenn etwas innerhalb des Projekts geändert wurde.

Im folgenden Beispiel wird eine partielle Methode mit dem Namen OnNameChanged entwickelt und aufgerufen. Die Methodensignatur ist in der partiellen Customer-Klasse in der Datei Customer.Designer.vb definiert. Die Implementierung befindet sich in der partiellen Customer-Klasse in der Datei Customer.vb, und in dem Projekt, das diese Klasse verwendet, wird eine Instanz von Customer erstellt.

Das Ergebnis ist ein Meldungsfeld mit folgender Meldung:

Name was changed to: Blue Yonder Airlines.

' File Customer.Designer.vb provides a partial class definition for
' Customer, which includes the signature for partial method 
' OnNameChanged.
Partial Class Customer
    Private _Name As String
    Property Name() As String
        Get
            Return _Name
        End Get
        Set(ByVal value As String)
            _Name = value
            OnNameChanged()
        End Set
    End Property

    ' Definition of the partial method signature.
    Partial Private Sub OnNameChanged()

    End Sub
End Class
' In a separate file, a developer who wants to use the partial class
' and partial method fills in an implementation for OnNameChanged.
Partial Class Customer

    ' Implementation of the partial method.
    Private Sub OnNameChanged()
        MsgBox("Name was changed to " & Me.Name)
    End Sub
End Class
Module Module1

    Sub Main()
        ' Creation of cust will invoke the partial method.
        Dim cust As New Customer With {.Name = "Blue Yonder Airlines"}
    End Sub
End Module

Siehe auch

Konzepte

Partielle Methoden

Referenz

Partial (Visual Basic)