WebBrowser.Navigate Metoda

Definicja

Przejdź asynchronicznie do dokumentu w określonym Uri .Navigate asynchronously to the document at the specified Uri.

Przeciążenia

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

Umożliwia przejście asynchronicznie do dokumentu pod określonym adresem URL i określenie ramki docelowej, do której ma zostać załadowana zawartość dokumentu.Navigates asynchronously to the document at the specified URL and specify the target frame to load the document's content into. Dodatkowe dane POST protokołu HTTP i nagłówki HTTP można wysyłać do serwera w ramach żądania nawigacji.Additional HTTP POST data and HTTP headers can be sent to the server as part of the navigation request.

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

Przejdź asynchronicznie do dokumentu w określonym Uri i określ docelową ramkę, do której ma zostać załadowana zawartość dokumentu.Navigate asynchronously to the document at the specified Uri and specify the target frame to load the document's content into. Dodatkowe dane POST protokołu HTTP i nagłówki HTTP można wysyłać do serwera w ramach żądania nawigacji.Additional HTTP POST data and HTTP headers can be sent to the server as part of the navigation request.

Navigate(String)

Przechodzi asynchronicznie do dokumentu pod podanym adresem URL.Navigates asynchronously to the document at the specified URL.

Navigate(Uri)

Przejdź asynchronicznie do dokumentu w określonym Uri .Navigate asynchronously to the document at the specified Uri.

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

Umożliwia przejście asynchronicznie do dokumentu pod określonym adresem URL i określenie ramki docelowej, do której ma zostać załadowana zawartość dokumentu.Navigates asynchronously to the document at the specified URL and specify the target frame to load the document's content into. Dodatkowe dane POST protokołu HTTP i nagłówki HTTP można wysyłać do serwera w ramach żądania nawigacji.Additional HTTP POST data and HTTP headers can be sent to the server as part of the navigation request.

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 którego chcesz przejść.The URL to navigate to.

targetFrameName
String

Nazwa ramki, w której ma zostać wyświetlona zawartość dokumentu.The name of the frame to display the document's content in.

postData
Byte[]

Wysyłaj dane HTTP w celu wysłania ich do serwera, gdy żądanie źródłowe.HTTP POST data to send to the server when the source is requested.

additionalHeaders
String

Nagłówki HTTP do wysłania do serwera, gdy żądanie jest wymagane.HTTP headers to send to the server when the source is requested.

Uwagi

Użyj Navigate(String, String, Byte[], String) metody, aby przejść do adresu URL, który może zawierać znaki ucieczki.Use the Navigate(String, String, Byte[], String) method to navigate to a URL that may include escape characters. Użyj Navigate(Uri, String, Byte[], String) metody, aby przejść do elementu Uri , który nie zawiera znaków ucieczki.Use the Navigate(Uri, String, Byte[], String) method to navigate to a Uri that does not include escape characters.

Dotyczy

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

Przejdź asynchronicznie do dokumentu w określonym Uri i określ docelową ramkę, do której ma zostać załadowana zawartość dokumentu.Navigate asynchronously to the document at the specified Uri and specify the target frame to load the document's content into. Dodatkowe dane POST protokołu HTTP i nagłówki HTTP można wysyłać do serwera w ramach żądania nawigacji.Additional HTTP POST data and HTTP headers can be sent to the server as part of the navigation request.

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

, Aby Uri przejść do.The Uri to navigate to.

targetFrameName
String

Nazwa ramki, w której ma zostać wyświetlona zawartość dokumentu.The name of the frame to display the document's content in.

postData
Byte[]

Wysyłaj dane HTTP w celu wysłania ich do serwera, gdy żądanie źródłowe.HTTP POST data to send to the server when the source is requested.

additionalHeaders
String

Nagłówki HTTP do wysłania do serwera, gdy żądanie jest wymagane.HTTP headers to send to the server when the source is requested.

Wyjątki

WebBrowserWystąpienie nie jest już prawidłowe.The WebBrowser instance is no longer valid.

Nie można pobrać odwołania do bazowego natywnego elementu WebBrowser .A reference to the underlying native WebBrowser could not be retrieved.

Nawigacja z aplikacji działającej w częściowej relacji zaufania:Navigation from an application that is running in partial trust: -Do Uri obiektu, który nie znajduje się w lokalizacji pochodzenia, lub- To a Uri that is not located at the site of origin, or

  • targetFrameName Nazwa nie jest null pusta.
  • targetFrameName name is not null or empty.
  • Przykłady

    Poniższy przykład pokazuje, jak przejść do dokumentu i otworzyć go w nowym oknie przeglądarki, określając element docelowy "about: blank".The following example shows how to navigate to a document and open it in a new browser window by specifying the "about:blank" target.

    <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

    Użyj Navigate(String, String, Byte[], String) metody, aby przejść do adresu URL, który może zawierać znaki ucieczki.Use the Navigate(String, String, Byte[], String) method to navigate to a URL that may include escape characters. Użyj Navigate(Uri, String, Byte[], String) metody, aby przejść do elementu Uri , który nie zawiera znaków ucieczki.Use the Navigate(Uri, String, Byte[], String) method to navigate to a Uri that does not include escape characters.

    Dotyczy

    Navigate(String)

    Przechodzi asynchronicznie do dokumentu pod podanym adresem URL.Navigates asynchronously to the document at the specified 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 którego chcesz przejść.The URL to navigate to.

    Uwagi

    Użyj Navigate(String) metody, aby przejść do adresu URL, który może zawierać znaki ucieczki.Use the Navigate(String) method to navigate to a URL that may include escape characters. Użyj Navigate(Uri) metody, aby przejść do elementu Uri , który nie zawiera znaków ucieczki.Use the Navigate(Uri) method to navigate to a Uri that does not include escape characters.

    Dotyczy

    Navigate(Uri)

    Przejdź asynchronicznie do dokumentu w określonym Uri .Navigate asynchronously to the document at the specified 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

    , Aby Uri przejść do.The Uri to navigate to.

    Wyjątki

    WebBrowserWystąpienie nie jest już prawidłowe.The WebBrowser instance is no longer valid.

    Nie można pobrać odwołania do bazowego natywnego elementu WebBrowser .A reference to the underlying native WebBrowser could not be retrieved.

    Nawigowanie z aplikacji działającej w częściowej relacji zaufania do obiektu Uri , który nie znajduje się w lokacji pochodzenia.Navigation from an application that is running in partial trust to a Uri that is not located at the site of origin.

    Przykłady

    Poniższy przykład pokazuje, jak użyć WebBrowser , aby przejść do dokumentu przy użyciu Navigate(Uri) metody.The following example shows how to use WebBrowser to navigate to a document by using the Navigate(Uri) method.

    <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 ten sam skutek jak ustawienie Source właściwości.Calling Navigate(Uri) has the same effect as setting the Source property. Source jest używany od znaczników przez deweloperów, którzy chcą deklaratywnie określić początkowy dokument, WebBrowser do którego WebBrowser jest zainicjowany.Source is used from markup by developers who want to declaratively specify the initial document that WebBrowser navigates to when WebBrowser is initialized.

    Użyj Navigate(String) metody, aby przejść do adresu URL, który może zawierać znaki ucieczki.Use the Navigate(String) method to navigate to a URL that may include escape characters. Użyj Navigate(Uri) metody, aby przejść do elementu Uri , który nie zawiera znaków ucieczki.Use the Navigate(Uri) method to navigate to a Uri that does not include escape characters.

    Dotyczy