WebBrowser.Navigate Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Controls

Zestaw:: PresentationFramework.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

ObjectDisposedException

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

InvalidOperationException

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

SecurityException

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

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

ObjectDisposedException

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

InvalidOperationException

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

SecurityException

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

Udostępnij za pośrednictwem

WebBrowser.Navigate Metoda

Definicja

Przeciążenia

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

Parametry

Uwagi

Dotyczy

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

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

Navigate(String)

Parametry

Uwagi

Dotyczy

Navigate(Uri)

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

Dodatkowe zasoby