Udostępnij za pośrednictwem


WebBrowser.Navigate Metoda

Definicja

Przejdź asynchronicznie do dokumentu w określonym obiekcie Uri.

Przeciążenia

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

Przechodzi asynchronicznie do dokumentu pod określonym adresem URL i określa ramkę docelową, aby załadować zawartość dokumentu do. Dodatkowe dane HTTP POST i nagłówki HTTP można wysyłać do serwera w ramach żądania nawigacji.

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

Przejdź asynchronicznie do dokumentu w określonym miejscu Uri i określ ramkę docelową, aby załadować zawartość dokumentu do. Dodatkowe dane HTTP POST i nagłówki HTTP można wysyłać do serwera w ramach żądania nawigacji.

Navigate(String)

Przechodzi asynchronicznie do dokumentu pod określonym adresem URL.

Navigate(Uri)

Przejdź asynchronicznie do dokumentu w określonym obiekcie Uri.

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

Przechodzi asynchronicznie do dokumentu pod określonym adresem URL i określa ramkę docelową, aby załadować zawartość dokumentu do. Dodatkowe dane HTTP POST i nagłówki HTTP można wysyłać do serwera w ramach żądania nawigacji.

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)

Parametry

source
String

Adres URL do przejścia do.

targetFrameName
String

Nazwa ramki do wyświetlenia zawartości dokumentu.

postData
Byte[]

Dane HTTP POST wysyłane do serwera po żądaniu źródła.

additionalHeaders
String

Nagłówki HTTP wysyłane do serwera po żądaniu źródła.

Uwagi

Navigate(String, String, Byte[], String) Użyj metody , aby przejść do adresu URL, który może zawierać znaki ucieczki. Navigate(Uri, String, Byte[], String) Użyj metody , aby przejść do Uri znaku, który nie zawiera znaków ucieczki.

Dotyczy

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

Przejdź asynchronicznie do dokumentu w określonym miejscu Uri i określ ramkę docelową, aby załadować zawartość dokumentu do. Dodatkowe dane HTTP POST i nagłówki HTTP można wysyłać do serwera w ramach żądania nawigacji.

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)

Parametry

source
Uri

Element Uri do przejścia do.

targetFrameName
String

Nazwa ramki do wyświetlenia zawartości dokumentu.

postData
Byte[]

Dane HTTP POST wysyłane do serwera po żądaniu źródła.

additionalHeaders
String

Nagłówki HTTP wysyłane do serwera po żądaniu źródła.

Wyjątki

Wystąpienie WebBrowser nie jest już prawidłowe.

Nie można pobrać odwołania do źródłowego natywnego elementu WebBrowser .

Nawigacja z aplikacji, która działa w częściowej relacji zaufania:

  • Do obiektu Uri , który nie znajduje się w miejscu pochodzenia, lub
  • targetFrameName nazwa nie jest pusta ani nie null jest pusta.

Przykłady

W poniższym przykładzie pokazano, jak przejść do dokumentu i otworzyć go w nowym oknie przeglądarki, określając element docelowy "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);  
}  

Uwagi

Navigate(String, String, Byte[], String) Użyj metody , aby przejść do adresu URL, który może zawierać znaki ucieczki. Navigate(Uri, String, Byte[], String) Użyj metody , aby przejść do Uri znaku, który nie zawiera znaków ucieczki.

Dotyczy

Navigate(String)

Przechodzi asynchronicznie do dokumentu pod określonym adresem URL.

public:
 void Navigate(System::String ^ source);
public void Navigate (string source);
member this.Navigate : string -> unit
Public Sub Navigate (source As String)

Parametry

source
String

Adres URL do przejścia do.

Uwagi

Navigate(String) Użyj metody , aby przejść do adresu URL, który może zawierać znaki ucieczki. Navigate(Uri) Użyj metody , aby przejść do Uri znaku, który nie zawiera znaków ucieczki.

Dotyczy

Navigate(Uri)

Przejdź asynchronicznie do dokumentu w określonym obiekcie Uri.

public:
 void Navigate(Uri ^ source);
public void Navigate (Uri source);
member this.Navigate : Uri -> unit
Public Sub Navigate (source As Uri)

Parametry

source
Uri

Element Uri do przejścia do.

Wyjątki

Wystąpienie WebBrowser nie jest już prawidłowe.

Nie można pobrać odwołania do źródłowego natywnego elementu WebBrowser .

Nawigacja z aplikacji, która jest uruchomiona w częściowym zaufaniu do Uri obiektu, który nie znajduje się w lokacji źródła.

Przykłady

W poniższym przykładzie pokazano, jak przejść WebBrowser do dokumentu przy użyciu Navigate(Uri) metody .

<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);  
}  

Uwagi

Wywołanie Navigate(Uri) ma taki sam efekt jak ustawienie Source właściwości. Source jest używany na podstawie znaczników przez deweloperów, którzy chcą deklaratywne określać początkowy dokument, który WebBrowser przechodzi do momentu WebBrowser zainicjowania.

Navigate(String) Użyj metody , aby przejść do adresu URL, który może zawierać znaki ucieczki. Navigate(Uri) Użyj metody , aby przejść do Uri znaku, który nie zawiera znaków ucieczki.

Dotyczy