WebBrowser.Navigate Метод

Определение

Загружает документ в указанном расположении в элемент управления WebBrowser.

Перегрузки

Navigate(Uri, String, Byte[], String)

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

Navigate(String, String, Byte[], String)

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

Navigate(Uri, Boolean)

Загружает документ в расположении, указанном заданным объектом Uri, в новое окно браузера или в элемент управления WebBrowser.

Navigate(Uri, String)

Загружает документ в расположении, указанном заданным объектом Uri, в элемент управления WebBrowser, заменяя содержимое фрейма веб-страницы с заданным именем.

Navigate(String, Boolean)

Загружает документ по указанному URL-адресу в новое окно браузера или в элемент управления WebBrowser.

Navigate(String, String)

Загружает документ по указанному URL-адресу в элемент управления WebBrowser, заменяя содержимое фрейма веб-страницы с заданным именем.

Navigate(Uri)

Загружает документ в расположении, указанном объектом Uri, в элемент управления WebBrowser, заменяя предыдущий документ.

Navigate(String)

Загружает документ по указанному URL-адресу в элемент управления WebBrowser, заменяя предыдущий документ.

Navigate(Uri, String, Byte[], String)

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

public void Navigate (Uri url, string targetFrameName, byte[] postData, string additionalHeaders);
public void Navigate (Uri? url, string? targetFrameName, byte[]? postData, string? additionalHeaders);

Параметры

url
Uri

Объект Uri, представляющий URL-адрес загружаемого документа.

targetFrameName
String

Имя кадра, в который должен загружаться документ.

postData
Byte[]

HTTP-данные POST, например данные, касающиеся формы.

additionalHeaders
String

Заголовки НТТР, добавляемые в заголовки, заданные по умолчанию.

Исключения

Данный экземпляр WebBrowser больше не действителен.

Не удается получить ссылку на реализацию интерфейса IWebBrowser2 из базового элемента управления ActiveX WebBrowser.

Значение параметра url не представляет абсолютный универсальный код ресурса (URI). Для получения дополнительной информации см. IsAbsoluteUri.

Комментарии

Элемент WebBrowser управления ведет список журналов всех веб-страниц, посещенных во время сеанса просмотра. При вызове этой перегрузки WebBrowser элемент управления загружает документ с указанным универсальным кодом ресурса (URI) в кадр веб-страницы с указанным именем и добавляет URI в конец списка журнала. Если указанное имя кадра недопустимо, документ загружается в новое окно Internet Explorer.

Используйте метод , GoBack чтобы вернуть элемент управления на предыдущую страницу в журнале навигации. Используйте метод , GoForward чтобы вернуться на более позднюю страницу в журнале навигации после перехода назад.

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

См. также раздел

Применяется к

.NET Framework 4.8.1 и другие версии
Продукт Версии
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Navigate(String, String, Byte[], String)

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

public void Navigate (string urlString, string targetFrameName, byte[] postData, string additionalHeaders);
public void Navigate (string urlString, string? targetFrameName, byte[]? postData, string? additionalHeaders);

Параметры

urlString
String

URL-адрес загружаемого документа.

targetFrameName
String

Имя кадра, в который должен загружаться документ.

postData
Byte[]

HTTP-данные POST, например данные, касающиеся формы.

additionalHeaders
String

Заголовки НТТР, добавляемые в заголовки, заданные по умолчанию.

Исключения

Данный экземпляр WebBrowser больше не действителен.

Не удается получить ссылку на реализацию интерфейса IWebBrowser2 из базового элемента управления ActiveX WebBrowser.

Комментарии

Элемент WebBrowser управления ведет список журналов всех веб-страниц, посещенных во время сеанса просмотра. При вызове этой перегрузки WebBrowser элемент управления загружает документ с указанным универсальным кодом ресурса (URI) в кадр веб-страницы с указанным именем и добавляет URI в конец списка журнала. Если указанное имя кадра недопустимо, документ загружается в новое окно Internet Explorer.

Используйте метод , GoBack чтобы вернуть элемент управления на предыдущую страницу в журнале навигации. Используйте метод , GoForward чтобы вернуться на более позднюю страницу в журнале навигации после перехода назад.

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

См. также раздел

Применяется к

.NET Framework 4.8.1 и другие версии
Продукт Версии
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Navigate(Uri, Boolean)

Загружает документ в расположении, указанном заданным объектом Uri, в новое окно браузера или в элемент управления WebBrowser.

public void Navigate (Uri url, bool newWindow);
public void Navigate (Uri? url, bool newWindow);

Параметры

url
Uri

Объект Uri, представляющий URL-адрес загружаемого документа.

newWindow
Boolean

Значение true, чтобы документ загружался в новое окно браузера; значение false, чтобы документ загружался в элемент управления WebBrowser.

Исключения

Данный экземпляр WebBrowser больше не действителен.

Не удается получить ссылку на реализацию интерфейса IWebBrowser2 из базового элемента управления ActiveX WebBrowser.

Значение параметра url не представляет абсолютный универсальный код ресурса (URI). Для получения дополнительной информации см. IsAbsoluteUri.

Комментарии

Элемент WebBrowser управления ведет список журналов всех веб-страниц, посещенных во время сеанса просмотра. При вызове этой перегрузки со значением newWindowfalseпараметра , элемент управления обычно переходит к указанному URI и добавляет URI в конец списка журнала. При вызове этой перегрузки со значением newWindowtrueпараметра элемент WebBrowser управления загружает документ по указанному универсальному коду ресурса (URI) в новое окно Internet Explorer, которое ведет собственный журнал навигации. Вы можете обработать NewWindow событие для получения уведомления до открытия нового окна браузера, что позволяет отменить действие при необходимости.

Элемент WebBrowser управления сохраняет веб-страницы недавно посещенных сайтов в кэше на локальном жестком диске. На каждой странице можно указать дату окончания срока действия, указывающую, как долго она будет оставаться в кэше. Когда элемент управления переходит на страницу или загружает страницу в отдельное окно браузера, он экономит время, отображая кэшированную версию , если она доступна, а не скачивая страницу снова. Используйте метод , Refresh чтобы принудить WebBrowser элемент управления перезагрузить текущую страницу, скачав ее, чтобы убедиться, что в элементе управления отображается последняя версия. Когда страница загружается в отдельное окно Internet Explorer, пользователь может получить последнюю версию, нажав кнопку Обновить .

См. также раздел

Применяется к

.NET Framework 4.8.1 и другие версии
Продукт Версии
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Navigate(Uri, String)

Загружает документ в расположении, указанном заданным объектом Uri, в элемент управления WebBrowser, заменяя содержимое фрейма веб-страницы с заданным именем.

public void Navigate (Uri url, string targetFrameName);
public void Navigate (Uri? url, string? targetFrameName);

Параметры

url
Uri

Объект Uri, представляющий URL-адрес загружаемого документа.

targetFrameName
String

Имя кадра, в который должен загружаться документ.

Исключения

Данный экземпляр WebBrowser больше не действителен.

Не удается получить ссылку на реализацию интерфейса IWebBrowser2 из базового элемента управления ActiveX WebBrowser.

Значение параметра url не представляет абсолютный универсальный код ресурса (URI). Для получения дополнительной информации см. IsAbsoluteUri.

Комментарии

Элемент WebBrowser управления ведет список журналов всех веб-страниц, посещенных во время сеанса просмотра. При вызове этой перегрузки WebBrowser элемент управления загружает документ с указанным универсальным кодом ресурса (URI) в кадр веб-страницы с указанным именем и добавляет URI в конец списка журнала. Если указанное имя кадра недопустимо, документ загружается в новое окно Internet Explorer.

Используйте метод , GoBack чтобы вернуть элемент управления на предыдущую страницу в журнале навигации. Используйте метод , GoForward чтобы вернуться на более позднюю страницу в журнале навигации после перехода назад.

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

См. также раздел

Применяется к

.NET Framework 4.8.1 и другие версии
Продукт Версии
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Navigate(String, Boolean)

Загружает документ по указанному URL-адресу в новое окно браузера или в элемент управления WebBrowser.

public void Navigate (string urlString, bool newWindow);

Параметры

urlString
String

URL-адрес загружаемого документа.

newWindow
Boolean

Значение true, чтобы документ загружался в новое окно браузера; значение false, чтобы документ загружался в элемент управления WebBrowser.

Исключения

Данный экземпляр WebBrowser больше не действителен.

Не удается получить ссылку на реализацию интерфейса IWebBrowser2 из базового элемента управления ActiveX WebBrowser.

Комментарии

Элемент WebBrowser управления ведет список журналов всех веб-страниц, посещенных во время сеанса просмотра. При вызове этой перегрузки со значением newWindowfalseпараметра , элемент управления обычно переходит к указанному URI и добавляет URI в конец списка журнала. При вызове этой перегрузки со значением newWindowtrueпараметра элемент WebBrowser управления загружает документ по указанному универсальному коду ресурса (URI) в новое окно Internet Explorer, которое ведет собственный журнал навигации. Вы можете обработать NewWindow событие для получения уведомления до открытия нового окна браузера, что позволяет отменить действие при необходимости.

Элемент WebBrowser управления сохраняет веб-страницы недавно посещенных сайтов в кэше на локальном жестком диске. На каждой странице можно указать дату окончания срока действия, указывающую, как долго она будет оставаться в кэше. Когда элемент управления переходит на страницу или загружает страницу в отдельное окно браузера, он экономит время, отображая кэшированную версию , если она доступна, а не скачивая страницу снова. Используйте метод , Refresh чтобы принудить WebBrowser элемент управления перезагрузить текущую страницу, скачав ее, чтобы убедиться, что в элементе управления отображается последняя версия. Когда страница загружается в отдельное окно Internet Explorer, пользователь может получить последнюю версию, нажав кнопку Обновить .

См. также раздел

Применяется к

.NET Framework 4.8.1 и другие версии
Продукт Версии
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Navigate(String, String)

Загружает документ по указанному URL-адресу в элемент управления WebBrowser, заменяя содержимое фрейма веб-страницы с заданным именем.

public void Navigate (string urlString, string targetFrameName);
public void Navigate (string urlString, string? targetFrameName);

Параметры

urlString
String

URL-адрес загружаемого документа.

targetFrameName
String

Имя кадра, в который должен загружаться документ.

Исключения

Данный экземпляр WebBrowser больше не действителен.

Не удается получить ссылку на реализацию интерфейса IWebBrowser2 из базового элемента управления ActiveX WebBrowser.

Комментарии

Элемент WebBrowser управления ведет список журналов всех веб-страниц, посещенных во время сеанса просмотра. При вызове этой перегрузки WebBrowser элемент управления загружает документ с указанным универсальным кодом ресурса (URI) в кадр веб-страницы с указанным именем и добавляет URI в конец списка журнала. Если указанное имя кадра недопустимо, документ загружается в новое окно Internet Explorer.

Используйте метод , GoBack чтобы вернуть элемент управления на предыдущую страницу в журнале навигации. Используйте метод , GoForward чтобы вернуться на более позднюю страницу в журнале навигации после перехода назад.

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

См. также раздел

Применяется к

.NET Framework 4.8.1 и другие версии
Продукт Версии
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Navigate(Uri)

Загружает документ в расположении, указанном объектом Uri, в элемент управления WebBrowser, заменяя предыдущий документ.

public void Navigate (Uri url);
public void Navigate (Uri? url);

Параметры

url
Uri

Объект Uri, представляющий URL-адрес загружаемого документа.

Исключения

Данный экземпляр WebBrowser больше не действителен.

Не удается получить ссылку на реализацию интерфейса IWebBrowser2 из базового элемента управления ActiveX WebBrowser.

Значение параметра url не представляет абсолютный универсальный код ресурса (URI). Для получения дополнительной информации см. IsAbsoluteUri.

Примеры

В следующем примере кода показано, как использовать Navigate метод для реализации адресной строки для WebBrowser элемента управления . В этом примере требуется, чтобы форма содержала элемент WebBrowser управления с именем webBrowser1, TextBox элемент управления с именем TextBoxAddressи 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();
}

Комментарии

Элемент WebBrowser управления ведет список журналов всех веб-страниц, посещенных во время сеанса просмотра. При вызове этой перегрузки WebBrowser элемент управления переходит к указанному универсальному коду ресурса (URI) и добавляет его в конец списка журнала. Используйте метод , GoBack чтобы вернуть элемент управления на предыдущую страницу в журнале навигации. Используйте метод , GoForward чтобы вернуться на более позднюю страницу в журнале навигации после перехода назад.

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

Метод можно использовать для Navigate реализации адресной строки, аналогичной той, что есть в Internet Explorer.

См. также раздел

Применяется к

.NET Framework 4.8.1 и другие версии
Продукт Версии
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Navigate(String)

Загружает документ по указанному URL-адресу в элемент управления WebBrowser, заменяя предыдущий документ.

public void Navigate (string urlString);

Параметры

urlString
String

URL-адрес загружаемого документа.

Исключения

Данный экземпляр WebBrowser больше не действителен.

Не удается получить ссылку на реализацию интерфейса IWebBrowser2 из базового элемента управления ActiveX WebBrowser.

Комментарии

Элемент WebBrowser управления ведет список журналов всех веб-страниц, посещенных во время сеанса просмотра. При вызове этой перегрузки WebBrowser элемент управления переходит к указанному универсальному коду ресурса (URI) и добавляет его в конец списка журнала. Используйте метод , GoBack чтобы вернуть элемент управления на предыдущую страницу в журнале навигации. Используйте метод , GoForward чтобы вернуться на более позднюю страницу в журнале навигации после перехода назад.

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

Метод можно использовать для Navigate реализации адресной строки, аналогичной той, что есть в Internet Explorer.

См. также раздел

Применяется к

.NET Framework 4.8.1 и другие версии
Продукт Версии
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9