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, System::String ^ targetFrameName, cli::array <System::Byte> ^ postData, System::String ^ additionalHeaders);
public void Navigate (Uri url, string targetFrameName, byte[] postData, string additionalHeaders);
public void Navigate (Uri? url, string? targetFrameName, byte[]? postData, string? additionalHeaders);
member this.Navigate : Uri * string * byte[] * string -> unit
Public Sub Navigate (url As Uri, targetFrameName As String, postData As Byte(), additionalHeaders As String)
Параметры
- targetFrameName
- String
Имя кадра, в который должен загружаться документ.
- postData
- Byte[]
HTTP-данные POST, например данные, касающиеся формы.
- additionalHeaders
- String
Заголовки НТТР, добавляемые в заголовки, заданные по умолчанию.
Исключения
Данный экземпляр WebBrowser больше не действителен.
Не удается получить ссылку на реализацию интерфейса IWebBrowser2
из базового элемента управления ActiveX WebBrowser
.
Значение параметра url
не представляет абсолютный универсальный код ресурса (URI). Для получения дополнительной информации см. IsAbsoluteUri.
Комментарии
Элемент WebBrowser управления ведет список журналов всех веб-страниц, посещенных во время сеанса просмотра. При вызове этой перегрузки WebBrowser элемент управления загружает документ с указанным универсальным кодом ресурса (URI) в кадр веб-страницы с указанным именем и добавляет URI в конец списка журнала. Если указанное имя кадра недопустимо, документ загружается в новое окно Обозреватель Интернета.
Используйте метод , GoBack чтобы вернуть элемент управления на предыдущую страницу в журнале навигации. Используйте метод , GoForward чтобы вернуться на более позднюю страницу в журнале навигации после перехода назад.
Элемент WebBrowser управления сохраняет веб-страницы недавно посещенных сайтов в кэше на локальном жестком диске. На каждой странице можно указать дату окончания срока действия, указывающую, как долго она будет оставаться в кэше. Когда элемент управления переходит на страницу, он экономит время, отображая кэшированную версию , если она доступна, вместо того, чтобы скачивать страницу снова. Используйте метод , Refresh чтобы принудить WebBrowser элемент управления перезагрузить текущую страницу, скачав ее, чтобы убедиться, что в элементе управления отображается последняя версия.
См. также раздел
Применяется к
Navigate(String, String, Byte[], String)
Загружает документ по указанному URL-адресу в элемент управления WebBrowser, запрашивая его с помощью указанных HTTP-данных и заменяя содержимое фрейма веб-страницы с заданным именем.
public:
void Navigate(System::String ^ urlString, System::String ^ targetFrameName, cli::array <System::Byte> ^ postData, System::String ^ additionalHeaders);
public void Navigate (string urlString, string targetFrameName, byte[] postData, string additionalHeaders);
public void Navigate (string urlString, string? targetFrameName, byte[]? postData, string? additionalHeaders);
member this.Navigate : string * string * byte[] * string -> unit
Public Sub Navigate (urlString As String, targetFrameName As String, postData As Byte(), additionalHeaders As String)
Параметры
- urlString
- String
URL-адрес загружаемого документа.
- targetFrameName
- String
Имя кадра, в который должен загружаться документ.
- postData
- Byte[]
HTTP-данные POST, например данные, касающиеся формы.
- additionalHeaders
- String
Заголовки НТТР, добавляемые в заголовки, заданные по умолчанию.
Исключения
Данный экземпляр WebBrowser больше не действителен.
Не удается получить ссылку на реализацию интерфейса IWebBrowser2
из базового элемента управления ActiveX WebBrowser
.
Комментарии
Элемент WebBrowser управления ведет список журналов всех веб-страниц, посещенных во время сеанса просмотра. При вызове этой перегрузки WebBrowser элемент управления загружает документ с указанным универсальным кодом ресурса (URI) в кадр веб-страницы с указанным именем и добавляет URI в конец списка журнала. Если указанное имя кадра недопустимо, документ загружается в новое окно Обозреватель Интернета.
Используйте метод , GoBack чтобы вернуть элемент управления на предыдущую страницу в журнале навигации. Используйте метод , GoForward чтобы вернуться на более позднюю страницу в журнале навигации после перехода назад.
Элемент WebBrowser управления сохраняет веб-страницы недавно посещенных сайтов в кэше на локальном жестком диске. На каждой странице можно указать дату окончания срока действия, указывающую, как долго она будет оставаться в кэше. Когда элемент управления переходит на страницу, он экономит время, отображая кэшированную версию , если она доступна, вместо того, чтобы скачивать страницу снова. Используйте метод , Refresh чтобы принудить WebBrowser элемент управления перезагрузить текущую страницу, скачав ее, чтобы убедиться, что в элементе управления отображается последняя версия.
См. также раздел
Применяется к
Navigate(Uri, Boolean)
Загружает документ в расположении, указанном заданным объектом Uri, в новое окно браузера или в элемент управления WebBrowser.
public:
void Navigate(Uri ^ url, bool newWindow);
public void Navigate (Uri url, bool newWindow);
public void Navigate (Uri? url, bool newWindow);
member this.Navigate : Uri * bool -> unit
Public Sub Navigate (url As Uri, newWindow As Boolean)
Параметры
- newWindow
- Boolean
Значение true
, чтобы документ загружался в новое окно браузера; значение false
, чтобы документ загружался в элемент управления WebBrowser.
Исключения
Данный экземпляр WebBrowser больше не действителен.
Не удается получить ссылку на реализацию интерфейса IWebBrowser2
из базового элемента управления ActiveX WebBrowser
.
Значение параметра url
не представляет абсолютный универсальный код ресурса (URI). Для получения дополнительной информации см. IsAbsoluteUri.
Комментарии
Элемент WebBrowser управления ведет список журналов всех веб-страниц, посещенных во время сеанса просмотра. При вызове этой перегрузки со значением newWindow
false
параметра , элемент управления обычно переходит к указанному URI и добавляет URI в конец списка журнала. При вызове этой перегрузки со значением newWindow
true
параметра элемент WebBrowser управления загружает документ по указанному универсальному коду ресурса (URI) в новое окно интернет-Обозреватель, которое ведет собственный журнал навигации. Вы можете обработать NewWindow событие для получения уведомления до открытия нового окна браузера, что позволяет отменить действие при необходимости.
Элемент WebBrowser управления сохраняет веб-страницы недавно посещенных сайтов в кэше на локальном жестком диске. На каждой странице можно указать дату окончания срока действия, указывающую, как долго она будет оставаться в кэше. Когда элемент управления переходит на страницу или загружает страницу в отдельное окно браузера, он экономит время, отображая кэшированную версию , если она доступна, а не скачивая страницу снова. Используйте метод , Refresh чтобы принудить WebBrowser элемент управления перезагрузить текущую страницу, скачав ее, чтобы убедиться, что в элементе управления отображается последняя версия. Когда страница загружается в отдельное окно Обозреватель Интернета, пользователь может получить последнюю версию, нажав кнопку Обновить.
См. также раздел
Применяется к
Navigate(Uri, String)
Загружает документ в расположении, указанном заданным объектом Uri, в элемент управления WebBrowser, заменяя содержимое фрейма веб-страницы с заданным именем.
public:
void Navigate(Uri ^ url, System::String ^ targetFrameName);
public void Navigate (Uri url, string targetFrameName);
public void Navigate (Uri? url, string? targetFrameName);
member this.Navigate : Uri * string -> unit
Public Sub Navigate (url As Uri, targetFrameName As String)
Параметры
- targetFrameName
- String
Имя кадра, в который должен загружаться документ.
Исключения
Данный экземпляр WebBrowser больше не действителен.
Не удается получить ссылку на реализацию интерфейса IWebBrowser2
из базового элемента управления ActiveX WebBrowser
.
Значение параметра url
не представляет абсолютный универсальный код ресурса (URI). Для получения дополнительной информации см. IsAbsoluteUri.
Комментарии
Элемент WebBrowser управления ведет список журналов всех веб-страниц, посещенных во время сеанса просмотра. При вызове этой перегрузки WebBrowser элемент управления загружает документ с указанным универсальным кодом ресурса (URI) в кадр веб-страницы с указанным именем и добавляет URI в конец списка журнала. Если указанное имя кадра недопустимо, документ загружается в новое окно Обозреватель Интернета.
Используйте метод , GoBack чтобы вернуть элемент управления на предыдущую страницу в журнале навигации. Используйте метод , GoForward чтобы вернуться на более позднюю страницу в журнале навигации после перехода назад.
Элемент WebBrowser управления сохраняет веб-страницы недавно посещенных сайтов в кэше на локальном жестком диске. На каждой странице можно указать дату окончания срока действия, указывающую, как долго она будет оставаться в кэше. Когда элемент управления переходит на страницу, он экономит время, отображая кэшированную версию , если она доступна, вместо того, чтобы скачивать страницу снова. Используйте метод , Refresh чтобы принудить WebBrowser элемент управления перезагрузить текущую страницу, скачав ее, чтобы убедиться, что в элементе управления отображается последняя версия.
См. также раздел
Применяется к
Navigate(String, Boolean)
Загружает документ по указанному URL-адресу в новое окно браузера или в элемент управления WebBrowser.
public:
void Navigate(System::String ^ urlString, bool newWindow);
public void Navigate (string urlString, bool newWindow);
member this.Navigate : string * bool -> unit
Public Sub Navigate (urlString As String, newWindow As Boolean)
Параметры
- urlString
- String
URL-адрес загружаемого документа.
- newWindow
- Boolean
Значение true
, чтобы документ загружался в новое окно браузера; значение false
, чтобы документ загружался в элемент управления WebBrowser.
Исключения
Данный экземпляр WebBrowser больше не действителен.
Не удается получить ссылку на реализацию интерфейса IWebBrowser2
из базового элемента управления ActiveX WebBrowser
.
Комментарии
Элемент WebBrowser управления ведет список журналов всех веб-страниц, посещенных во время сеанса просмотра. При вызове этой перегрузки со значением newWindow
false
параметра , элемент управления обычно переходит к указанному URI и добавляет URI в конец списка журнала. При вызове этой перегрузки со значением newWindow
true
параметра элемент WebBrowser управления загружает документ по указанному универсальному коду ресурса (URI) в новое окно интернет-Обозреватель, которое ведет собственный журнал навигации. Вы можете обработать NewWindow событие для получения уведомления до открытия нового окна браузера, что позволяет отменить действие при необходимости.
Элемент WebBrowser управления сохраняет веб-страницы недавно посещенных сайтов в кэше на локальном жестком диске. На каждой странице можно указать дату окончания срока действия, указывающую, как долго она будет оставаться в кэше. Когда элемент управления переходит на страницу или загружает страницу в отдельное окно браузера, он экономит время, отображая кэшированную версию , если она доступна, а не скачивая страницу снова. Используйте метод , Refresh чтобы принудить WebBrowser элемент управления перезагрузить текущую страницу, скачав ее, чтобы убедиться, что в элементе управления отображается последняя версия. Когда страница загружается в отдельное окно Обозреватель Интернета, пользователь может получить последнюю версию, нажав кнопку Обновить.
См. также раздел
Применяется к
Navigate(String, String)
Загружает документ по указанному URL-адресу в элемент управления WebBrowser, заменяя содержимое фрейма веб-страницы с заданным именем.
public:
void Navigate(System::String ^ urlString, System::String ^ targetFrameName);
public void Navigate (string urlString, string targetFrameName);
public void Navigate (string urlString, string? targetFrameName);
member this.Navigate : string * string -> unit
Public Sub Navigate (urlString As String, targetFrameName As String)
Параметры
- urlString
- String
URL-адрес загружаемого документа.
- targetFrameName
- String
Имя кадра, в который должен загружаться документ.
Исключения
Данный экземпляр WebBrowser больше не действителен.
Не удается получить ссылку на реализацию интерфейса IWebBrowser2
из базового элемента управления ActiveX WebBrowser
.
Комментарии
Элемент WebBrowser управления ведет список журналов всех веб-страниц, посещенных во время сеанса просмотра. При вызове этой перегрузки WebBrowser элемент управления загружает документ с указанным универсальным кодом ресурса (URI) в кадр веб-страницы с указанным именем и добавляет URI в конец списка журнала. Если указанное имя кадра недопустимо, документ загружается в новое окно Обозреватель Интернета.
Используйте метод , GoBack чтобы вернуть элемент управления на предыдущую страницу в журнале навигации. Используйте метод , GoForward чтобы вернуться на более позднюю страницу в журнале навигации после перехода назад.
Элемент WebBrowser управления сохраняет веб-страницы недавно посещенных сайтов в кэше на локальном жестком диске. На каждой странице можно указать дату окончания срока действия, указывающую, как долго она будет оставаться в кэше. Когда элемент управления переходит на страницу, он экономит время, отображая кэшированную версию , если она доступна, вместо того, чтобы скачивать страницу снова. Используйте метод , Refresh чтобы принудить WebBrowser элемент управления перезагрузить текущую страницу, скачав ее, чтобы убедиться, что в элементе управления отображается последняя версия.
См. также раздел
Применяется к
Navigate(Uri)
Загружает документ в расположении, указанном объектом Uri, в элемент управления WebBrowser, заменяя предыдущий документ.
public:
void Navigate(Uri ^ url);
public void Navigate (Uri url);
public void Navigate (Uri? url);
member this.Navigate : Uri -> unit
Public Sub Navigate (url As Uri)
Параметры
Исключения
Данный экземпляр 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 text box when
// the ENTER key is pressed while the text box has focus.
void TextBoxAddress_KeyDown( Object^ /*sender*/, System::Windows::Forms::KeyEventArgs^ e )
{
if ( e->KeyCode == System::Windows::Forms::Keys::Enter && !this->TextBoxAddress->Text->Equals( "" ) )
{
this->WebBrowser1->Navigate( this->TextBoxAddress->Text );
}
}
// Navigates to the URL in the address text box when
// the Go button is clicked.
void ButtonGo_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
if ( !this->TextBoxAddress->Text->Equals( "" ) )
{
this->WebBrowser1->Navigate( this->TextBoxAddress->Text );
}
}
// Updates the URL in TextBoxAddress upon navigation.
void WebBrowser1_Navigated( Object^ /*sender*/, System::Windows::Forms::WebBrowserNavigatedEventArgs^ /*e*/ )
{
this->TextBoxAddress->Text = this->WebBrowser1->Url->ToString();
}
// 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();
}
' Navigates to the URL in the address box when
' the ENTER key is pressed while the ToolStripTextBox has focus.
Private Sub toolStripTextBox1_KeyDown( _
ByVal sender As Object, ByVal e As KeyEventArgs) _
Handles toolStripTextBox1.KeyDown
If (e.KeyCode = Keys.Enter) Then
Navigate(toolStripTextBox1.Text)
End If
End Sub
' Navigates to the URL in the address box when
' the Go button is clicked.
Private Sub goButton_Click( _
ByVal sender As Object, ByVal e As EventArgs) _
Handles goButton.Click
Navigate(toolStripTextBox1.Text)
End Sub
' Navigates to the given URL if it is valid.
Private Sub Navigate(ByVal address As String)
If String.IsNullOrEmpty(address) Then Return
If address.Equals("about:blank") Then Return
If Not address.StartsWith("http://") And _
Not address.StartsWith("https://") Then
address = "http://" & address
End If
Try
webBrowser1.Navigate(New Uri(address))
Catch ex As System.UriFormatException
Return
End Try
End Sub
' Updates the URL in TextBoxAddress upon navigation.
Private Sub webBrowser1_Navigated(ByVal sender As Object, _
ByVal e As WebBrowserNavigatedEventArgs) _
Handles webBrowser1.Navigated
toolStripTextBox1.Text = webBrowser1.Url.ToString()
End Sub
Комментарии
Элемент WebBrowser управления ведет список журналов всех веб-страниц, посещенных во время сеанса просмотра. При вызове этой перегрузки WebBrowser элемент управления переходит к указанному универсальному коду ресурса (URI) и добавляет его в конец списка журнала. Используйте метод , GoBack чтобы вернуть элемент управления на предыдущую страницу в журнале навигации. Используйте метод , GoForward чтобы вернуться на более позднюю страницу в журнале навигации после перехода назад.
Элемент WebBrowser управления сохраняет веб-страницы недавно посещенных сайтов в кэше на локальном жестком диске. На каждой странице можно указать дату окончания срока действия, указывающую, как долго она будет оставаться в кэше. Когда элемент управления переходит на страницу, он экономит время, отображая кэшированную версию , если она доступна, вместо того, чтобы скачивать страницу снова. Используйте метод , Refresh чтобы принудить WebBrowser элемент управления перезагрузить текущую страницу, скачав ее, чтобы убедиться, что в элементе управления отображается последняя версия.
Метод можно использовать для Navigate реализации адресной строки, аналогичной той, что есть в Обозреватель Интернета.
См. также раздел
Применяется к
Navigate(String)
Загружает документ по указанному URL-адресу в элемент управления WebBrowser, заменяя предыдущий документ.
public:
void Navigate(System::String ^ urlString);
public void Navigate (string urlString);
member this.Navigate : string -> unit
Public Sub Navigate (urlString As String)
Параметры
- urlString
- String
URL-адрес загружаемого документа.
Исключения
Данный экземпляр WebBrowser больше не действителен.
Не удается получить ссылку на реализацию интерфейса IWebBrowser2
из базового элемента управления ActiveX WebBrowser
.
Комментарии
Элемент WebBrowser управления ведет список журналов всех веб-страниц, посещенных во время сеанса просмотра. При вызове этой перегрузки WebBrowser элемент управления переходит к указанному универсальному коду ресурса (URI) и добавляет его в конец списка журнала. Используйте метод , GoBack чтобы вернуть элемент управления на предыдущую страницу в журнале навигации. Используйте метод , GoForward чтобы вернуться на более позднюю страницу в журнале навигации после перехода назад.
Элемент WebBrowser управления сохраняет веб-страницы недавно посещенных сайтов в кэше на локальном жестком диске. На каждой странице можно указать дату окончания срока действия, указывающую, как долго она будет оставаться в кэше. Когда элемент управления переходит на страницу, он экономит время, отображая кэшированную версию , если она доступна, вместо того, чтобы скачивать страницу снова. Используйте метод , Refresh чтобы принудить WebBrowser элемент управления перезагрузить текущую страницу, скачав ее, чтобы убедиться, что в элементе управления отображается последняя версия.
Метод можно использовать для Navigate реализации адресной строки, аналогичной той, что есть в Обозреватель Интернета.
См. также раздел
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по