HOW TO: Start the Default Web Browser by Using a LinkLabel Control in Windows Forms with Visual C# .NET (320478)

SUMMARY

This step-by-step article demonstrates how to use a LinkLabel control in the Microsoft .NET Framework System.Windows.Forms namespace to open a Web address (or URL) in the default Web browser.

Although the LinkLabel control contains built-in facilities to associate URLs with arbitrary regions of a link, it does not contain a simple method to open the URL in an external browser when you click the label. Fortunately, the Process class in the .NET Framework System.Diagnostics namespace makes this method easy. Process takes an initial argument of ProcessStartInfo. ProcessStartInfo, in turn, takes a path to a file. This path is either a local file path or an URL. ProcessStartInfo uses the content type to open the file in an appropriate program. This emulates the Win32 ShellExecute function. For additional information about this function, click the article number below to view the article in the Microsoft Knowledge Base: back to the top

Add a LinkLabel Control and a Link to Your Form

1. Follow these steps to create a new Windows Application project in Visual C# .NET:
   1. Start Microsoft Visual Studio .NET.
   2. On the File menu, click New.
   3. In the Project Types box, click Visual C# Projects. In the Templates box, click Windows Application.
2. From the toolbox, drag a LinkLabel control to the existing Windows Form. If the Toolbox window is not visible, press CTRL+ALT+X, or click Toolbox on the View menu in Microsoft Visual Studio .NET.
3. Click the LinkLabel control. In the Properties window, change the name of the LinkLabel control to libLink. If the Properties window is not visible, right-click the LinkLabel control, and then click Properties.
4. Double-click anywhere in the form to open the Code window for the form. This places the insertion point in the form's Load method. Add the following code to the Load method:

           libLink.Links.Remove(libLink.Links[0]);
           libLink.Links.Add(0, libLink.Text.Length, "http://msdn.microsoft.com/library/");
   					

back to the top

Start the Default Web Browser

1. In the Code window for your form, add the following line to the top of your form. Add this line above the form's class definition:

   using System.Diagnostics;
   					

2. In the form's Designer window, double-click the LinkLabel control to add a LinkClicked event handler. This places the insertion point in the empty body of the new handler. Add the following code:

           ProcessStartInfo sInfo = new ProcessStartInfo(e.Link.LinkData.ToString());  
           Process.Start(sInfo);
   					

back to the top

Verify That It Works

1. Press the F5 key, or click Start on the Debug menu in Visual Studio .NET, to run the program.
2. Click linklabel1. Note that it starts the default browser and opens the URL that is associated with the LinkLabel control.

back to the top