Freigeben über


Gewusst wie: Verknüpfen eines Objekts oder einer Webseite mit dem LinkLabel-Steuerelement in Windows Forms

Aktualisiert: November 2007

Mit dem LinkLabel-Steuerelement in Windows Forms können Sie in einem Formular Webhyperlinks erstellen. Die Farbe des Hyperlinks kann, nachdem darauf geklickt wurde, geändert werden, um zu signalisieren, dass er bereits besucht wurde. Weitere Informationen über das Ändern der Farbe finden Sie unter Gewusst wie: Ändern der Darstellung des LinkLabel-Steuerelements in Windows Forms.

Verknüpfen mit einem anderen Formular

So stellen Sie mit einem LinkLabel-Steuerelement eine Verknüpfung mit einem anderen Steuerelement her

  1. Legen Sie für die Text-Eigenschaft eine geeignete Beschriftung fest.

  2. Definieren Sie die LinkArea-Eigenschaft, um festzulegen, welcher Teil der Beschriftung als Hyperlink gekennzeichnet wird. Wie der Hyperlink gekennzeichnet wird, hängt von den Darstellungseigenschaften der Hyperlinkbezeichnung ab. Der LinkArea-Wert wird durch ein LinkArea-Objekt mit zwei Zahlen dargestellt. Diese stehen für die Position des ersten Zeichens und die Anzahl der Zeichen. Die LinkArea-Eigenschaft kann im Eigenschaftenfenster oder in Code ähnlich wie folgt festgelegt werden:

    ' In this code example, the link area has been set to begin
    ' at the first character and extend for eight characters.
    ' You may need to modify this based on the text entered in Step 1.
    LinkLabel1.LinkArea = New LinkArea(0, 8)
    
    // In this code example, the link area has been set to begin
    // at the first character and extend for eight characters.
    // You may need to modify this based on the text entered in Step 1.
    linkLabel1.LinkArea = new LinkArea(0,8);
    
    // In this code example, the link area has been set to begin
    // at the first character and extend for eight characters.
    // You may need to modify this based on the text entered in Step 1.
    linkLabel1->LinkArea = LinkArea(0,8);
    
  3. Rufen Sie im LinkClicked-Ereignishandler die Show-Methode auf, um ein weiteres Formular im Projekt zu öffnen, und legen Sie die LinkVisited-Eigenschaft auf true fest.

    Hinweis:

    Eine Instanz der LinkLabelLinkClickedEventArgs-Klasse enthält einen Verweis auf das LinkLabel-Steuerelement, auf das geklickt wurde, sodass eine Umwandlung des sender -Objekts nicht erforderlich ist.

    Protected Sub LinkLabel1_LinkClicked(ByVal Sender As System.Object, _
       ByVal e As System.Windows.Forms.LinkLabelLinkClickedEventArgs) _
       Handles LinkLabel1.LinkClicked
       ' Show another form.
       Dim f2 As New Form()
       f2.Show
       LinkLabel1.LinkVisited = True
    End Sub
    
    protected void linkLabel1_LinkClicked(object sender, System. Windows.Forms.LinkLabelLinkClickedEventArgs e)
    {
       // Show another form.
       Form f2 = new Form();
       f2.Show();
       linkLabel1.LinkVisited = true;
    }
    
    private:
       void linkLabel1_LinkClicked(System::Object ^  sender,
          System::Windows::Forms::LinkLabelLinkClickedEventArgs ^  e)
       {
          // Show another form.
          Form ^ f2 = new Form();
          f2->Show();
          linkLabel1->LinkVisited = true;
       }
    

Verknüpfen zu einer Webseite

Darüber hinaus kann mithilfe des LinkLabel-Steuerelements eine Webseite in einem Standardbrowser angezeigt werden.

So starten Sie Internet Explorer und stellen eine Verknüpfung mit einer Webseite mit einem LinkLabel-Steuerelement her

  1. Legen Sie für die Text-Eigenschaft eine geeignete Beschriftung fest.

  2. Definieren Sie die LinkArea-Eigenschaft, um festzulegen, welcher Teil der Beschriftung als Hyperlink gekennzeichnet wird.

  3. Rufen Sie im LinkClicked-Ereignishandler in einem Ausnahmebehandlungsblock eine zweite Prozedur auf, die für die LinkVisited-Eigenschaft true festlegt und die Start-Methode verwendet, um den Standardbrowser mit einem URL zu starten. Um die Start-Methode zu verwenden, müssen Sie einen Verweis auf den System.Diagnostics-Namespace hinzufügen.

    Sicherheitshinweis:

    Wenn der unten stehende Code in einer teilweise vertrauenswürdigen Umgebung ausgeführt wird (z. B. auf einem freigegebenen Laufwerk), schlägt die Umwandlung durch den JIT-Compiler fehl, wenn die VisitLink-Methode aufgerufen wird. Die Anweisung System.Diagnostics.Process.Start verursacht einen Verknüpfungsaufruf, der fehlschlägt. Bei einem Fehlschlag des JIT-Compilers stellt der unten stehende Code die erfolgreiche Behandlung des Fehlers sicher, indem die Ausnahme abgefangen wird, wenn die VisitLink-Methode aufgerufen wird.

    Private Sub LinkLabel1_LinkClicked(ByVal sender As System.Object, _
       ByVal e As System.Windows.Forms.LinkLabelLinkClickedEventArgs) _
       Handles LinkLabel1.LinkClicked
       Try
          VisitLink()
       Catch ex As Exception
          ' The error message
          MessageBox.Show("Unable to open link that was clicked.")
       End Try
    End Sub
    
    Sub VisitLink()
       ' Change the color of the link text by setting LinkVisited 
       ' to True.
       LinkLabel1.LinkVisited = True
       ' Call the Process.Start method to open the default browser 
       ' with a URL:
       System.Diagnostics.Process.Start("https://www.microsoft.com")
    End Sub
    
    private void linkLabel1_LinkClicked(object sender, System.Windows.Forms.LinkLabelLinkClickedEventArgs e)
    {
       try
       {
          VisitLink();
       }
       catch (Exception ex )
       {
          MessageBox.Show("Unable to open link that was clicked.");
       }
    }
    
    private void VisitLink()
    {
       // Change the color of the link text by setting LinkVisited 
       // to true.
       linkLabel1.LinkVisited = true;
       //Call the Process.Start method to open the default browser 
       //with a URL:
       System.Diagnostics.Process.Start("https://www.microsoft.com");
    }
    
    private:
       void linkLabel1_LinkClicked(System::Object ^  sender,
          System::Windows::Forms::LinkLabelLinkClickedEventArgs ^  e)
       {
          try
          {
             VisitLink();
          }
          catch (Exception ^ ex)
          {
             MessageBox::Show("Unable to open link that was clicked.");
          }
       }
    private:
       void VisitLink()
       {
          // Change the color of the link text by setting LinkVisited 
          // to true.
          linkLabel1->LinkVisited = true;
          // Call the Process.Start method to open the default browser 
          // with a URL:
          System::Diagnostics::Process::Start("https://www.microsoft.com");
       }
    

Siehe auch

Aufgaben

Gewusst wie: Ändern der Darstellung des LinkLabel-Steuerelements in Windows Forms

Referenz

Process.Start

Übersicht über das LinkLabel-Steuerelement (Windows Forms)

Weitere Ressourcen

LinkLabel-Steuerelement (Windows Forms)