WebBrowser - класс

WebBrowser элемент управления позволяет страницы и другого узла браузер-разрешенные документы в приложениях Windows Forms.Можно использовать WebBrowser элемент управления, например, чтобы обеспечить интегрированные HTML-основанные помощи или устройств пользователя, просматривающего возможности в приложении.Кроме того, можно использовать WebBrowser мониторинг, чтобы добавить существующие размещённые в интернете элементы управления к клиентским приложениям Windows Forms.

Важно
WebBrowser элемент управления ресурсоемок.Не забудьте вызвать Dispose() метод следует вызвать по завершении использования класса элемента управления, чтобы убедиться, что все ресурсы освобождаются в отведенное время.Необходимо вызвать Dispose() метод в том же потоке, который вложил событий, которые должны всегда быть потоком сообщений или интерфейса (ui).

WebBrowser элемент управления не может использоваться частично доверенным кодом.Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

WebBrowser элемент управления имеет несколько свойств, методов и событий, относящихся к навигации.Следующие члены, позволяющие переходить элемент управления на определенный URL-адрес, перемещения и переадресованы назад по списку журнала переходов и загружают домашняя страница и страница поиска текущего пользователя.

• Url

• Navigate

• GoBack

• GoForward

• GoHome

• GoSearch

, Если переход на обнаружено, то отображается веб-страница, указывающий на проблему.Навигация с любым из этих членов вызывает Navigating" Navigatedи DocumentCompleted события, содержащихся на разных стадиях навигации.

Эти и другие элементы, например Stop и Refresh методы позволяют реализовать управления пользовательского интерфейса в приложении аналогично строкам в Internet Explorer.Некоторые элементы могут оказаться полезными, даже когда не нужно отображать WebBrowser элемент управления на форме.Например, можно использовать Print метод, чтобы напечатать последнюю версию страницы без отображения страницы для пользователя.

WebBrowser элемент управления также позволяет отображать содержимое, которое создается в приложении или извлечении из базы данных или файла ресурсов.Используйте DocumentText OR DocumentStream свойство для получения или задания содержимое текущего документа в виде строки или потока данных.

Можно также управлять содержимое страницы до Document свойство, содержащее HtmlDocument объект, предоставляющий доступ к управляемой объектной модели html-документов (DOM) для текущей страницы.Это свойство полезно при использовании в сочетании с ObjectForScripting свойство реализовать двустороннюю связь между кодом приложения и кодом динамический HTML (DHTML) на странице позволить необходимо объединить размещённые в интернете элементы управления и элементы управления Windows Forms в интерфейсе одного пользователя.Можно использовать Document свойство для вызова скриптов методы кода из приложения.В сценарии код может получить доступ через приложение window.external объект, который представляет собой встроенный объект DOM, предоставленных для доступа основного приложения, и сопоставляется с объектом, который указан для ObjectForScripting свойство.

WebBrowser элемент управления для управляемой программа-оболочка ActiveX WebBrowser - элемент управленияи использует версию элемента управления, какая из этих величин устанавливается на компьютере пользователя.

Примечание
Этот класс выполняет требования безопасности на уровне класса.A SecurityException вызывается, когда производный класс или какой-либо вызывающий объект в стеке вызова не имеющие разрешение полного доверия.Дополнительные сведения о требованиях безопасности см. в разделах Требования связывания и Требования наследования.

Примечание
WebBrowser класс может использоваться только в потоках, заданные в режим одному потоков подразделения (sta).Чтобы использовать этот класс, убедитесь, что ваше Main метод помечен атрибутом STAThreadAttribute атрибут.

В следующем примере кода демонстрируется способ реализации адресной строке для использования с WebBrowser элемент управления.В этом примере необходима форма, содержащая a WebBrowser вызываемый элемент управления webBrowser1a TextBox вызываемый элемент управления TextBoxAddressи a Button вызываемый элемент управления ButtonGo.При вводе url-адреса в текстовое поле и нажмите клавишу ввод или кнопку Поиск кнопки WebBrowser указанный элемент управления переходит на URL-адрес.При переходе, щелкнув гиперссылку, текстового поля обновления автоматически для отображения текущего url-адреса.

Полный пример кода см. в разделе Практическое руководство. Добавление функциональности веб-браузера в приложения Windows Forms.

// Navigates to the URL in the address box when 
// the ENTER key is pressed while the ToolStripTextBox has focus.
private void toolStripTextBox1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Enter)
    {
        Navigate(toolStripTextBox1.Text);
    }
}

// Navigates to the URL in the address box when 
// the Go button is clicked.
private void goButton_Click(object sender, EventArgs e)
{
    Navigate(toolStripTextBox1.Text);
}

// Navigates to the given URL if it is valid.
private void Navigate(String address)
{
    if (String.IsNullOrEmpty(address)) return;
    if (address.Equals("about:blank")) return;
    if (!address.StartsWith("http://") &&
        !address.StartsWith("https://"))
    {
        address = "http://" + address;
    }
    try
    {
        webBrowser1.Navigate(new Uri(address));
    }
    catch (System.UriFormatException)
    {
        return;
    }
}

// Updates the URL in TextBoxAddress upon navigation.
private void webBrowser1_Navigated(object sender,
    WebBrowserNavigatedEventArgs e)
{
    toolStripTextBox1.Text = webBrowser1.Url.ToString();
}

.NET Framework

.NET Framework (клиентский профиль)

• SecurityPermission

  для непосредственных вызывающих для использования этого элемента управления.Значение требования. LinkDemand; Именованные наборы разрешений. FullTrust.

• SecurityPermission

  для производных классов наследовать этот элемент управления.Значение требования. InheritanceDemand; Именованные наборы разрешений. FullTrust.

Windows 8, Windows Server 2012, Windows 7, Windows Vista с пакетом обновления 2 (SP2), Windows Server 2008 (роль основных серверных компонентов не поддерживается), Windows Server 2008 R2 (роль основных серверных компонентов поддерживается в пакете обновления 1 (SP1) или выше; системы на базе Itanium не поддерживаются)

Ссылки

Другие ресурсы