Condividi tramite

WebBrowser.Navigate Metodo

Definizione

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

Passare in modo asincrono al documento in corrispondenza dell'oggetto specificato Uri.

Overload

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

Passa in modo asincrono al documento nell'URL specificato e specifica il frame di destinazione in cui caricare il contenuto del documento. È possibile inviare al server dati HTTP POST e intestazioni HTTP aggiuntive come parte della richiesta di navigazione.
Navigate(Uri, String, Byte[], String)

Passare in modo asincrono al documento in corrispondenza dell'oggetto specificato Uri e specificare il frame di destinazione in cui caricare il contenuto del documento. È possibile inviare al server dati HTTP POST e intestazioni HTTP aggiuntive come parte della richiesta di navigazione.
Navigate(String)

Passa in modo asincrono al documento in corrispondenza dell'URL specificato.
Navigate(Uri)

Passare in modo asincrono al documento in corrispondenza dell'oggetto specificato Uri.

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

Passa in modo asincrono al documento nell'URL specificato e specifica il frame di destinazione in cui caricare il contenuto del documento. È possibile inviare al server dati HTTP POST e intestazioni HTTP aggiuntive come parte della richiesta di navigazione.

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

L'URL a cui accedere.

targetFrameName
String

Nome della cornice 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)

Passare in modo asincrono al documento in corrispondenza dell'oggetto specificato Uri e specificare il frame di destinazione in cui caricare il contenuto del documento. È possibile inviare al server dati HTTP POST e intestazioni HTTP aggiuntive come parte della richiesta di navigazione.

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

Oggetto Uri a cui passare.

targetFrameName
String

Nome della cornice 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 WebBrowser non è più valida.

InvalidOperationException

Impossibile recuperare un riferimento al nativo WebBrowser sottostante.

SecurityException

Navigazione da un'applicazione in esecuzione in attendibilità parziale:

  • A un Uri oggetto che non si trova nel sito di origine o

  • targetFrameName name 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)

Passa in modo asincrono al documento in corrispondenza dell'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

L'URL a cui accedere.

Commenti

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

Si applica a

Navigate(Uri)

Passare in modo asincrono al documento in corrispondenza dell'oggetto specificato Uri.

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

Parametri

source
Uri

Oggetto Uri a cui passare.

Eccezioni

ObjectDisposedException

L'istanza WebBrowser non è più valida.

InvalidOperationException

Impossibile recuperare un riferimento al nativo WebBrowser sottostante.

SecurityException

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

Esempio

Nell'esempio seguente viene illustrato come utilizzare 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 dal markup da parte degli sviluppatori che vogliono specificare in modo dichiarativo il documento iniziale che WebBrowser passa a quando WebBrowser viene inizializzato.

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

Si applica a