WebBrowser.Navigate Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Controls
Assembly:
PresentationFramework.dll

Consente di passare in modo asincrono al documento corrispondente all'oggetto Uri specificato.

Overload

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

Si sposta in modo asincrono nel documento corrispondente all'URL specificato e specifica il frame di destinazione in cui caricare il contenuto del documento. È possibile inviare intestazioni HTTP e dati HTTP POST aggiuntivi al server come parte della richiesta di spostamento.
Navigate(Uri, String, Byte[], String)

Consente di passare in modo asincrono al documento corrispondente all'oggetto Uri specificato e di specificare il frame di destinazione in cui caricare il contenuto del documento. È possibile inviare intestazioni HTTP e dati HTTP POST aggiuntivi al server come parte della richiesta di spostamento.
Navigate(String)

Si sposta in modo asincrono nel documento corrispondente all'URL specificato.
Navigate(Uri)

Consente di passare in modo asincrono al documento corrispondente all'oggetto Uri specificato.

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

Si sposta in modo asincrono nel documento corrispondente all'URL specificato e specifica il frame di destinazione in cui caricare il contenuto del documento. È possibile inviare intestazioni HTTP e dati HTTP POST aggiuntivi al server come parte della richiesta di spostamento.

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)

Parametri

source
String

URL su cui spostarsi.

targetFrameName
String

Nome del frame in cui visualizzare il contenuto del documento.

postData
Byte[]

Dati HTTP POST da inviare al server quando viene richiesta l'origine.

additionalHeaders
String

Intestazioni HTTP da inviare al server quando viene richiesta l'origine.

Commenti

Usare il Navigate(String, String, Byte[], String) metodo per passare a un URL che può includere caratteri di escape. Utilizzare il Navigate(Uri, String, Byte[], String) metodo per passare a un Uri oggetto che non include caratteri di escape.

Si applica a

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

Consente di passare in modo asincrono al documento corrispondente all'oggetto Uri specificato e di specificare il frame di destinazione in cui caricare il contenuto del documento. È possibile inviare intestazioni HTTP e dati HTTP POST aggiuntivi al server come parte della richiesta di spostamento.

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)

Parametri

source
Uri

Uri su cui spostarsi.

targetFrameName
String

Nome del frame in cui visualizzare il contenuto del documento.

postData
Byte[]

Dati HTTP POST da inviare al server quando viene richiesta l'origine.

additionalHeaders
String

Intestazioni HTTP da inviare al server quando viene richiesta l'origine.

Eccezioni

ObjectDisposedException

L'istanza di WebBrowser non è più valida.

InvalidOperationException

Non è possibile recuperare un riferimento all'oggetto nativo WebBrowser sottostante.

SecurityException

Navigazione da un'applicazione eseguita in attendibilità parziale:

  • A un oggetto Uri che non si trova nel sito di origine oppure
  • Il nome targetFrameName non è null o vuoto.

Esempio

Nell'esempio seguente viene illustrato come passare a un documento e aprirlo in una nuova finestra del browser specificando la destinazione "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);  
}

Commenti

Usare il Navigate(String, String, Byte[], String) metodo per passare a un URL che può includere caratteri di escape. Utilizzare il Navigate(Uri, String, Byte[], String) metodo per passare a un Uri oggetto che non include caratteri di escape.

Si applica a

Navigate(String)

Si sposta in modo asincrono nel documento corrispondente all'URL specificato.

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

Parametri

source
String

URL su cui spostarsi.

Commenti

Usare il Navigate(String) metodo per passare a un URL che può includere caratteri di escape. Usare il Navigate(Uri) metodo per passare a un Uri oggetto che non include caratteri di escape.

Si applica a

Navigate(Uri)

Consente di passare in modo asincrono al documento corrispondente all'oggetto Uri specificato.

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

Parametri

source
Uri

Uri su cui spostarsi.

Eccezioni

ObjectDisposedException

L'istanza di WebBrowser non è più valida.

InvalidOperationException

Non è possibile recuperare un riferimento all'oggetto nativo WebBrowser sottostante.

SecurityException

Navigazione da un'applicazione eseguita in attendibilità parziale a un oggetto Uri che non si trova nel sito di origine.

Esempio

Nell'esempio seguente viene illustrato come usare WebBrowser per passare a un documento usando il Navigate(Uri) metodo .

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

Commenti

La chiamata Navigate(Uri) ha lo stesso effetto dell'impostazione della Source proprietà. Source viene usato da markup dagli sviluppatori che vogliono specificare in modo dichiarativo il documento WebBrowser iniziale che passa a quando WebBrowser viene inizializzato.

Usare il Navigate(String) metodo per passare a un URL che può includere caratteri di escape. Usare il Navigate(Uri) metodo per passare a un Uri oggetto che non include caratteri di escape.

Si applica a