Bagikan melalui

WebBrowser.Navigate Metode

Definisi

Ruang nama:
System.Windows.Controls
Rakitan:
PresentationFramework.dll

Navigasikan secara asinkron ke dokumen di yang ditentukan Uri.

Overload

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

Navigasikan secara asinkron ke dokumen di URL yang ditentukan dan tentukan bingkai target untuk memuat konten dokumen. Data HTTP POST tambahan dan header HTTP dapat dikirim ke server sebagai bagian dari permintaan navigasi.
Navigate(Uri, String, Byte[], String)

Navigasikan secara asinkron ke dokumen pada bingkai target yang ditentukan Uri dan tentukan bingkai target untuk memuat konten dokumen. Data HTTP POST tambahan dan header HTTP dapat dikirim ke server sebagai bagian dari permintaan navigasi.
Navigate(String)

Menavigasi secara asinkron ke dokumen di URL yang ditentukan.
Navigate(Uri)

Navigasikan secara asinkron ke dokumen di yang ditentukan Uri.

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

Navigasikan secara asinkron ke dokumen di URL yang ditentukan dan tentukan bingkai target untuk memuat konten dokumen. Data HTTP POST tambahan dan header HTTP dapat dikirim ke server sebagai bagian dari permintaan navigasi.

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)

Parameter

source
String

URL yang akan dinavigasi.

targetFrameName
String

Nama bingkai untuk menampilkan isi dokumen.

postData
Byte[]

Data HTTP POST untuk dikirim ke server ketika sumber diminta.

additionalHeaders
String

Header HTTP untuk dikirim ke server ketika sumber diminta.

Keterangan

Navigate(String, String, Byte[], String) Gunakan metode untuk menavigasi ke URL yang mungkin menyertakan karakter escape. Navigate(Uri, String, Byte[], String) Gunakan metode untuk menavigasi ke yang Uri tidak menyertakan karakter escape.

Berlaku untuk

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

Navigasikan secara asinkron ke dokumen pada bingkai target yang ditentukan Uri dan tentukan bingkai target untuk memuat konten dokumen. Data HTTP POST tambahan dan header HTTP dapat dikirim ke server sebagai bagian dari permintaan navigasi.

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)

Parameter

source
Uri

Untuk Uri menavigasi ke.

targetFrameName
String

Nama bingkai untuk menampilkan isi dokumen.

postData
Byte[]

Data HTTP POST untuk dikirim ke server ketika sumber diminta.

additionalHeaders
String

Header HTTP untuk dikirim ke server ketika sumber diminta.

Pengecualian

ObjectDisposedException

Instans WebBrowser tidak lagi valid.

InvalidOperationException

Referensi ke native WebBrowser yang mendasar tidak dapat diambil.

SecurityException

Navigasi dari aplikasi yang berjalan dalam kepercayaan parsial:

  • Uri Untuk yang tidak terletak di situs asal, atau

  • targetFrameName nama tidak null atau kosong.

Contoh

Contoh berikut menunjukkan cara menavigasi ke dokumen dan membukanya di jendela browser baru dengan menentukan target "tentang:kosong".

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

Keterangan

Navigate(String, String, Byte[], String) Gunakan metode untuk menavigasi ke URL yang mungkin menyertakan karakter escape. Navigate(Uri, String, Byte[], String) Gunakan metode untuk menavigasi ke yang Uri tidak menyertakan karakter escape.

Berlaku untuk

Navigate(String)

Menavigasi secara asinkron ke dokumen di URL yang ditentukan.

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

Parameter

source
String

URL yang akan dinavigasi.

Keterangan

Navigate(String) Gunakan metode untuk menavigasi ke URL yang mungkin menyertakan karakter escape. Navigate(Uri) Gunakan metode untuk menavigasi ke yang Uri tidak menyertakan karakter escape.

Berlaku untuk

Navigate(Uri)

Navigasikan secara asinkron ke dokumen di yang ditentukan Uri.

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

Parameter

source
Uri

Untuk Uri menavigasi ke.

Pengecualian

ObjectDisposedException

Instans WebBrowser tidak lagi valid.

InvalidOperationException

Referensi ke native WebBrowser yang mendasar tidak dapat diambil.

SecurityException

Navigasi dari aplikasi yang berjalan dalam kepercayaan parsial ke Uri yang tidak terletak di situs asal.

Contoh

Contoh berikut menunjukkan cara menggunakan WebBrowser untuk menavigasi ke dokumen dengan menggunakan Navigate(Uri) metode .

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

Keterangan

Navigate(Uri) Panggilan memiliki efek yang sama dengan mengatur Source properti. Source digunakan dari markup oleh pengembang yang ingin secara deklaratif menentukan dokumen awal yang WebBrowser menavigasi ke kapan WebBrowser diinisialisasi.

Navigate(String) Gunakan metode untuk menavigasi ke URL yang mungkin menyertakan karakter escape. Navigate(Uri) Gunakan metode untuk menavigasi ke yang Uri tidak menyertakan karakter escape.

Berlaku untuk