WebBrowser.Navigate Метод

Ссылка

Определение

Пространство имен:: System.Windows.Forms

Сборка:: System.Windows.Forms.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Загружает документ в указанном расположении в элемент управления 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

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

Исключения

ObjectDisposedException

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

InvalidOperationException

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

ArgumentException

Значение параметра 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

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

Исключения

ObjectDisposedException

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

InvalidOperationException

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

Исключения

ObjectDisposedException

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

InvalidOperationException

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

ArgumentException

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

Параметры

url: Uri

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

targetFrameName: String

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

Исключения

ObjectDisposedException

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

InvalidOperationException

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

ArgumentException

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

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

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

Исключения

ObjectDisposedException

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

InvalidOperationException

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

Элемент 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

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

Исключения

ObjectDisposedException

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

InvalidOperationException

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

Исключения

ObjectDisposedException

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

InvalidOperationException

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

ArgumentException

Примеры

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

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

Исключения

ObjectDisposedException

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

InvalidOperationException

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

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

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

WebBrowser.Navigate Метод

Определение

Перегрузки

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

Параметры

Исключения

Комментарии

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

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

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

Параметры

Исключения

Комментарии

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

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

Navigate(Uri, Boolean)

Параметры

Исключения

Комментарии

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

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

Navigate(Uri, String)

Параметры

Исключения

Комментарии

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

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

Navigate(String, Boolean)

Параметры

Исключения

Комментарии

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

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

Navigate(String, String)

Параметры

Исключения

Комментарии

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

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

Navigate(Uri)

Параметры

Исключения

Примеры

Комментарии

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

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

Navigate(String)

Параметры

Исключения

Комментарии

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

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

Обратная связь

Дополнительные ресурсы