Hinzufügen von Code zum Benutzersteuerelement

Artikel
09/02/2008

Aktualisiert: November 2007

In dieser Lektion erfahren Sie, wie Sie einem Benutzersteuerelement Code hinzufügen, um den vollständigen Namen anzuzeigen und neue Eigenschaften verfügbar zu machen.

Wie Standardsteuerelemente verfügen Benutzersteuerelemente über Eigenschaften, Methoden und Ereignisse. Als Entwickler schreiben Sie Code zum Behandeln der Ereignisse des Steuerelements, und Sie entscheiden, welche Eigenschaften für den Benutzer des Steuerelements verfügbar gemacht werden.

Behandeln von Ereignissen in einem Benutzersteuerelement

Damit das Benutzersteuerelement sinnvoll verwendet werden kann, müssen Sie Code zum Behandeln der Ereignisse des Steuerelements schreiben. Das Schreiben einer Prozedur zum Behandeln eines Ereignisses für ein Benutzersteuerelement unterscheidet sich dabei nicht von der Vorgehensweise für ein Formular oder ein Steuerelement.

In diesem Beispiel schreiben Sie eine Ereignisprozedur, mit der die FullName-Bezeichnung mit den Inhalten der Felder FirstName, MiddleName und LastName bei der Eingabe aktualisiert wird. Dazu wird der TextChanged-Ereignishandler verwendet.

Übung

So fügen Sie einem Benutzersteuerelement Code hinzu

Öffnen Sie das in der vorigen Lektion erstellte NamesUserControl-Projekt. Wenn Sie das Projekt nicht gespeichert haben, müssen Sie zuerst zur vorherigen Lektion, Der Benutzersteuerelement-Designer, zurückkehren und die Prozeduren in der Lektion abschließen.
Wählen Sie im Projektmappen-Explorer die Datei NamesControl.vb aus, und wählen Sie anschließend im Menü Ansicht die Option Code aus.

Fügen Sie im Code-Editor den folgenden Code für den FirstName_TextChanged-Ereignishandler hinzu.

Private Sub FirstName_TextChanged(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles FirstName.TextChanged, MiddleName.TextChanged, LastName.TextChanged
    ' Display the contents of the three text boxes in the label.
    FullName.Text = FirstName.Text & " " & MiddleName.Text & " " & LastName.Text
End Sub

Drücken Sie F5, um das Programm auszuführen. Der Testcontainer für Benutzersteuerelemente wird geöffnet, und darin wird das Benutzersteuerelement angezeigt.
Geben Sie in den drei Feldern Ihren Vornamen, Ihren zweiten Vornamen und Ihren Nachnamen ein. Ihr Name wird dann bei der Eingabe in der FullName-Bezeichnung angezeigt.

Wenn Sie sich den oben eingegebenen Code ansehen, werden Sie feststellen, dass durch die Handles-Klausel in der Deklaration das TextChanged-Ereignis für alle drei TextBox-Steuerelemente behandelt wird. Unabhängig davon, in welchem Textfeld Sie zuerst Text eingeben, wird die FullName-Bezeichnung immer bei der Eingabe aktualisiert.

Verfügbar machen von Eigenschaften in einem Benutzersteuerelement

Mit den Eigenschaften von Standardsteuerelementen können Sie Werte für ein Steuerelement zur Entwurfszeit und zur Laufzeit festlegen und abrufen. Sie möchten sicherlich auch bestimmte Eigenschaften des Benutzersteuerelements verfügbar machen, damit Sie diese im Eigenschaftenfenster zur Entwurfszeit festlegen und im Code darauf verweisen können.

Das Verfügbarmachen von Eigenschaften in einem Benutzersteuerelement ähnelt dem Verfügbarmachen von Eigenschaften in einer Klasse. Der Hauptunterschied besteht darin, dass Sie auch die Eigenschaften der Steuerelemente verfügbar machen können, die in dem Benutzersteuerelement enthalten sind. Wie bei Klassen deklarieren Sie eine Eigenschaft und fügen der Get-Prozedur und der Set-Prozedur Code hinzu. Wenn Sie eine Eigenschaft eines enthaltenen Steuerelements verfügbar machen, müssen Sie keine private Variable zum Speichern des Werts deklarieren. Diesen Speichervorgang führt die Eigenschaft des Steuerelements für Sie aus.

Derzeit ist es nicht möglich, Text abzurufen, der in die Steuerelemente FirstName, MiddleName und LastName eingegeben wurde. Außerdem kann der Wert der FullName-Bezeichnung nicht abgerufen werden. Sie müssen die Werte als Eigenschaften verfügbar machen, damit das Steuerelement sinnvoll verwendet werden kann. Da der Wert der FullName-Bezeichnung außerhalb des eigenen Code nicht geändert werden soll, empfiehlt es sich, diesen als schreibgeschützte Eigenschaft verfügbar zu machen.

Übung

So fügen Sie Eigenschaften hinzu

Fügen Sie im Code-Editor den folgenden Code hinzu, um die Werte für FirstName, MiddleName und LastName als Eigenschaften verfügbar zu machen.

Property FirstNameText() As String
    Get
        Return FirstName.Text
    End Get
    Set(ByVal value As String)
        FirstName.Text = value
    End Set
End Property
Property MiddleNameText() As String
    Get
        Return MiddleName.Text
    End Get
    Set(ByVal value As String)
        MiddleName.Text = value
    End Set
End Property
Property LastNameText() As String
    Get
        Return LastName.Text
    End Get
    Set(ByVal value As String)
        LastName.Text = value
    End Set
End Property

Fügen Sie den folgenden Code hinzu, um den Wert der FullName-Bezeichnung als schreibgeschützte Eigenschaft verfügbar zu machen.
```
ReadOnly Property FullNameText() As String
    Get
        Return FullName.Text
    End Get
End Property
```
Drücken Sie F5, um das Programm auszuführen.
Führen Sie im Testcontainer für Benutzersteuerelemente einen Bildlauf bis zum Ende des Eigenschaftenrasters durch, und wählen Sie die FirstNameText-Eigenschaft aus. Geben Sie Ihren Namen ein, und wählen Sie dann die FullNameText-Eigenschaft aus. Im FirstName-Textfeld sollte Ihr Name angezeigt werden, und die FullNameText-Eigenschaft sollte damit übereinstimmen.

Versuchen Sie, einige der anderen Eigenschaften sowohl im Eigenschaftenraster als auch im Steuerelement selbst zu ändern, um zu sehen, wie diese miteinander verknüpft sind. Mit dieser Situation ist ein Benutzer des Steuerelements zur Entwurfszeit konfrontiert.
Klicken Sie im Menü Datei auf Alle speichern, um die Eingaben zu speichern.

Nächste Schritte

In dieser Lektion haben Sie gelernt, wie Ereignisse im Benutzersteuerelement behandelt und einige seiner Eigenschaften verfügbar gemacht werden. Weitere Informationen zu Eigenschaften finden Sie unter Genauere Betrachtung: Hinzufügen von Eigenschaften mit benannten Werten. Sie können jedoch auch zur nächsten Lektion übergehen, in der Sie mehr über die Verwendung des von Ihnen erstellten Steuerelements erfahren.

Nächste Lektion: Testen des Benutzersteuerelements.