WebBrowser.Navigate Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перейдите асинхронно к документу по указанному Uri.
Перегрузки
Navigate(String, String, Byte[], String) |
Осуществляет асинхронный переход к документу по заданному URL-адресу и задает конечную рамку, в которую необходимо загрузить содержимое документа. Дополнительные данные HTTP POST и заголовки НТТР можно отправлять на сервер в запросе на переход. |
Navigate(Uri, String, Byte[], String) |
Перейдите асинхронно к документу по указанному Uri и укажите целевой фрейм, куда необходимо загрузить содержимое документа. Дополнительные данные HTTP POST и заголовки НТТР можно отправлять на сервер в запросе на переход. |
Navigate(String) |
Осуществляет асинхронный переход к документу по заданному URL-адресу. |
Navigate(Uri) |
Перейдите асинхронно к документу по указанному Uri. |
Navigate(String, String, Byte[], String)
Осуществляет асинхронный переход к документу по заданному URL-адресу и задает конечную рамку, в которую необходимо загрузить содержимое документа. Дополнительные данные HTTP POST и заголовки НТТР можно отправлять на сервер в запросе на переход.
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[]
Данные НТТР POST, которые необходимо отправить на сервер при запросе источника.
- additionalHeaders
- String
Заголовки НТТР, которые необходимо отправить на сервер при запросе источника.
Комментарии
Navigate(String, String, Byte[], String) Используйте метод для перехода по URL-адресу, который может включать escape-символы. Navigate(Uri, String, Byte[], String) Используйте метод для перехода к объектуUri, который не содержит escape-символы.
Применяется к
Navigate(Uri, String, Byte[], String)
Перейдите асинхронно к документу по указанному Uri и укажите целевой фрейм, куда необходимо загрузить содержимое документа. Дополнительные данные HTTP POST и заголовки НТТР можно отправлять на сервер в запросе на переход.
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[]
Данные НТТР POST, которые необходимо отправить на сервер при запросе источника.
- additionalHeaders
- String
Заголовки НТТР, которые необходимо отправить на сервер при запросе источника.
Исключения
Экземпляр 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-символы.