WebBrowser.GoSearch Method ()

 

Navigates the WebBrowser control to the default search page of the current user.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public void GoSearch()

Exception Condition
ObjectDisposedException

This WebBrowser instance is no longer valid.

InvalidOperationException

A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

You can use this method to implement a search feature similar to the one in Internet Explorer. Depending on the version of Internet Explorer installed, the user can specify a default search page in the Internet Options dialog box, which is available from Control Panel or from the Tools menu in Internet Explorer.

The default search page is stored in the registry under the HKEY_CURRENT_USER\Software\Microsoft\Internet Explorer\Main\Search Page registry key. With later versions of Internet Explorer, this registry key must be modified in order to change the default search page used by this method. To use a search page other than the default, call the Navigate method or specify the Url property.

The following code example demonstrates how to use the GoSearch method to implement a Search button for the WebBrowser control similar to the one in Internet Explorer. This example requires that your form contains a WebBrowser control called webBrowser1 and a Button control called ButtonSearch.

For the complete code example, see How to: Add Web Browser Capabilities to a Windows Forms Application.

// Navigates webBrowser1 to the search page of the current user.
private void searchButton_Click(object sender, EventArgs e)
{
    webBrowser1.GoSearch();
}

SecurityPermission

for immediate callers to use this control. Demand value: LinkDemand; NIB: Named Permission Sets: FullTrust.

.NET Framework
Available since 2.0
Return to top
Show: