WebBrowser.Navigate Метод

Определение

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

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

Важно!

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

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

Перегрузки

Имя	Описание
Navigate(Uri, String, Byte[], String)	Загружает документ в расположении, указанном Uri WebBrowser в элементе управления, запрашивая его с помощью указанных HTTP-данных и заменяя содержимое кадра веб-страниц указанным именем.
Navigate(String, String, Byte[], String)	Загружает документ по указанному url-адресу (URL-адрес) WebBrowser в элемент управления, запрашивая его с помощью указанных HTTP-данных и заменяя содержимое кадра веб-страниц указанным именем.
Navigate(Uri, Boolean)	Загружает документ в расположении, Uri указанном в новом окне браузера или в WebBrowser элемент управления.
Navigate(Uri, String)	Загружает документ в расположении, указанном Uri WebBrowser в элементе управления, заменив содержимое кадра веб-страницы указанным именем.
Navigate(String, Boolean)	Загружает документ по указанному url-адресу (URL-адрес) в новое окно браузера или в WebBrowser элемент управления.
Navigate(String, String)	Загружает документ по указанному URL-адресу WebBrowser в элемент управления, заменив содержимое кадра веб-страницы указанным именем.
Navigate(Uri)	Загружает документ в расположении, указанном Uri в элементе WebBrowser управления, заменив предыдущий документ.
Navigate(String)	Загружает документ по указанному url-адресу (URL-адрес) WebBrowser в элемент управления, заменив предыдущий документ.

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

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

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

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

targetFrameName: String

Имя кадра, в котором нужно загрузить документ.

postData: Byte[]

ДАННЫЕ HTTP POST, такие как данные формы.

additionalHeaders: String

Заголовки HTTP для добавления в заголовки по умолчанию.

Исключения

ObjectDisposedException

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

InvalidOperationException

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

ArgumentException

Значение url параметра не представляет абсолютный URI. Дополнительные сведения см. в разделе IsAbsoluteUri.

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

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

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

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

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

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

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

Загружает документ по указанному url-адресу (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

Заголовки HTTP для добавления в заголовки по умолчанию.

Исключения

ObjectDisposedException

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

InvalidOperationException

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

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

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

Navigate(Uri, Boolean)

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

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

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

newWindow: Boolean

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

Исключения

ObjectDisposedException

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

InvalidOperationException

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

ArgumentException

Значение url параметра не представляет абсолютный URI. Дополнительные сведения см. в разделе IsAbsoluteUri.

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

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

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

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

Navigate(Uri, String)

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

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

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

targetFrameName: String

Имя кадра, в котором нужно загрузить документ.

Исключения

ObjectDisposedException

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

InvalidOperationException

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

ArgumentException

Значение url параметра не представляет абсолютный URI. Дополнительные сведения см. в разделе IsAbsoluteUri.

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

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

Navigate(String, Boolean)

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

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

Исключения

ObjectDisposedException

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

InvalidOperationException

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

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

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

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

Navigate(String, String)

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

Загружает документ по указанному 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)

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

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

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

Исключения

ObjectDisposedException

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

InvalidOperationException

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

ArgumentException

Значение url параметра не представляет абсолютный URI. Дополнительные сведения см. в разделе IsAbsoluteUri.

Примеры

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

Полный пример кода см. в разделе How to: Add Web Browser Capabilities to a Windows Forms Application.

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

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

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

Navigate(String)

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

Исходный код:: WebBrowser.cs

Загружает документ по указанному url-адресу (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 управления поддерживает список журналов всех веб-страниц, посещаемых во время сеанса просмотра. При вызове этой перегрузки WebBrowser элемент управления переходит к указанному URI и добавляет его в конец списка журнала. GoBack Используйте метод, чтобы вернуть элемент управления на предыдущую страницу в журнале навигации. GoForward Используйте метод, чтобы вернуться на более позднюю страницу в журнале навигации после перехода назад.

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

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

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

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

Были ли сведения на этой странице полезными?

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)

Параметры

Исключения

Комментарии

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

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

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