Поделиться через


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)

Параметры

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 элемент управления перезагрузить текущую страницу, скачав ее, чтобы убедиться, что в элементе управления отображается последняя версия.

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

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

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 в конец списка журнала. Если указанное имя кадра недопустимо, документ загружается в новое окно Internet Explorer.

Используйте метод , 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)

Параметры

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, пользователь может получить последнюю версию, нажав кнопку Обновить .

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

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

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)

Параметры

url
Uri

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

targetFrameName
String

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

Исключения

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

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

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

Комментарии

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

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

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

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

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

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 в конец списка журнала. Если указанное имя кадра недопустимо, документ загружается в новое окно Internet Explorer.

Используйте метод , 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)

Параметры

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 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 реализации адресной строки, аналогичной той, что есть в Internet Explorer.

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

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

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 реализации адресной строки, аналогичной той, что есть в Internet Explorer.

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

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