WebBrowser.Navigate Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Асинхронно перейдите к документу по указанному адресу Uri.
Перегрузки
| Имя | Описание |
|---|---|
| Navigate(String, String, Byte[], String) |
Асинхронно перемещается к документу по указанному URL-адресу и указывает целевой кадр для загрузки содержимого документа. Дополнительные данные HTTP POST и заголовки HTTP можно отправлять на сервер в рамках запроса навигации. |
| Navigate(Uri, String, Byte[], String) |
Асинхронно перейдите к документу по указанному адресу Uri и укажите целевой кадр для загрузки содержимого документа. Дополнительные данные HTTP POST и заголовки HTTP можно отправлять на сервер в рамках запроса навигации. |
| Navigate(String) |
Асинхронно переходит к документу по указанному URL-адресу. |
| Navigate(Uri) |
Асинхронно перейдите к документу по указанному адресу Uri. |
Navigate(String, String, Byte[], String)
Асинхронно перемещается к документу по указанному URL-адресу и указывает целевой кадр для загрузки содержимого документа. Дополнительные данные HTTP POST и заголовки HTTP можно отправлять на сервер в рамках запроса навигации.
public:
void Navigate(System::String ^ source, System::String ^ targetFrameName, cli::array <System::Byte> ^ postData, System::String ^ additionalHeaders);
public void Navigate(string source, string targetFrameName, byte[] postData, string additionalHeaders);
member this.Navigate : string * string * byte[] * string -> unit
Public Sub Navigate (source As String, targetFrameName As String, postData As Byte(), additionalHeaders As String)
Параметры
- source
- String
URL-адрес, по которому нужно перейти.
- targetFrameName
- String
Имя кадра для отображения содержимого документа.
- postData
- Byte[]
ДАННЫЕ HTTP POST для отправки на сервер при запросе источника.
- additionalHeaders
- String
Заголовки HTTP для отправки на сервер при запросе источника.
Комментарии
Navigate(String, String, Byte[], String) Используйте метод для перехода по URL-адресу, который может включать escape-символы. Используйте метод для перехода к объекту Navigate(Uri, String, Byte[], String)Uri , который не содержит escape-символы.
Применяется к
Navigate(Uri, String, Byte[], String)
Асинхронно перейдите к документу по указанному адресу Uri и укажите целевой кадр для загрузки содержимого документа. Дополнительные данные HTTP POST и заголовки HTTP можно отправлять на сервер в рамках запроса навигации.
public:
void Navigate(Uri ^ source, System::String ^ targetFrameName, cli::array <System::Byte> ^ postData, System::String ^ additionalHeaders);
public void Navigate(Uri source, string targetFrameName, byte[] postData, string additionalHeaders);
member this.Navigate : Uri * string * byte[] * string -> unit
Public Sub Navigate (source As Uri, targetFrameName As String, postData As Byte(), additionalHeaders As String)
Параметры
- targetFrameName
- String
Имя кадра для отображения содержимого документа.
- postData
- Byte[]
ДАННЫЕ HTTP POST для отправки на сервер при запросе источника.
- additionalHeaders
- String
Заголовки HTTP для отправки на сервер при запросе источника.
Исключения
Экземпляр WebBrowser больше недействителен.
Не удалось получить ссылку на базовый собственный WebBrowser код.
Навигация из приложения, работающего в частичном доверии:
Uri Для объекта, который не расположен на месте происхождения, или
targetFrameNameимя неnullявляется или пустым.
Примеры
В следующем примере показано, как перейти к документу и открыть его в новом окне браузера, указав целевой объект about:blank.
<StackPanel>
<StackPanel Orientation="Horizontal">
<TextBox x:Name="addressTextBox" Width="200" />
<Button Click="goNavigateButton_Click">Go</Button>
</StackPanel>
<WebBrowser x:Name="myWebBrowser" />
</StackPanel>
private void goNavigateButton_Click(object sender, RoutedEventArgs e)
{
// Get URI to navigate to
Uri uri = new Uri(this.addressTextBox.Text, UriKind.RelativeOrAbsolute);
// Only absolute URIs can be navigated to
if (!uri.IsAbsoluteUri)
{
MessageBox.Show("The Address URI must be absolute. For example, 'http://www.microsoft.com'");
return;
}
// Navigate to the desired URL by calling the .Navigate method
this.myWebBrowser.Navigate(uri, "_blank", null, null);
}
Комментарии
Navigate(String, String, Byte[], String) Используйте метод для перехода по URL-адресу, который может включать escape-символы. Используйте метод для перехода к объекту Navigate(Uri, String, Byte[], String)Uri , который не содержит escape-символы.
Применяется к
Navigate(String)
Асинхронно переходит к документу по указанному URL-адресу.
public:
void Navigate(System::String ^ source);
public void Navigate(string source);
member this.Navigate : string -> unit
Public Sub Navigate (source As String)
Параметры
- source
- String
URL-адрес, по которому нужно перейти.
Комментарии
Navigate(String) Используйте метод для перехода по URL-адресу, который может включать escape-символы. Используйте метод для перехода к объекту Navigate(Uri)Uri , который не содержит escape-символы.
Применяется к
Navigate(Uri)
Асинхронно перейдите к документу по указанному адресу Uri.
public:
void Navigate(Uri ^ source);
public void Navigate(Uri source);
member this.Navigate : Uri -> unit
Public Sub Navigate (source As Uri)
Параметры
Исключения
Экземпляр WebBrowser больше недействителен.
Не удалось получить ссылку на базовый собственный WebBrowser код.
Навигация из приложения, выполняющегося в частичном доверии, к Uri не расположенной на сайте источника.
Примеры
В следующем примере показано, WebBrowser как перейти к документу с помощью Navigate(Uri) метода.
<StackPanel>
<StackPanel Orientation="Horizontal">
<TextBox x:Name="addressTextBox" Width="200" />
<Button Click="goNavigateButton_Click">Go</Button>
</StackPanel>
<WebBrowser x:Name="myWebBrowser" />
</StackPanel>
private void goNavigateButton_Click(object sender, RoutedEventArgs e)
{
// Get URI to navigate to
Uri uri = new Uri(this.addressTextBox.Text, UriKind.RelativeOrAbsolute);
// Only absolute URIs can be navigated to
if (!uri.IsAbsoluteUri)
{
MessageBox.Show("The Address URI must be absolute. For example, 'http://www.microsoft.com'");
return;
}
// Navigate to the desired URL by calling the .Navigate method
this.myWebBrowser.Navigate(uri);
}
Комментарии
Вызов Navigate(Uri) имеет тот же эффект, что и установка Source свойства. Source используется из разметки разработчиками, которые хотят декларативно указать исходный документ, WebBrowser который переходит к при WebBrowser инициализации.
Navigate(String) Используйте метод для перехода по URL-адресу, который может включать escape-символы. Используйте метод для перехода к объекту Navigate(Uri)Uri , который не содержит escape-символы.