Aracılığıyla paylaş

WebBrowser.Navigate Yöntem

Tanım

Ad Alanı:
System.Windows.Controls
Bütünleştirilmiş Kod:
PresentationFramework.dll

Belirtilen Urikonumundaki belgeye zaman uyumsuz olarak gidin.

Aşırı Yüklemeler

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

Belirtilen URL'deki belgeye zaman uyumsuz olarak gider ve belgenin içeriğinin yükleneceğini hedef çerçeveyi belirtir. Ek HTTP POST verileri ve HTTP üst bilgileri, gezinti isteğinin bir parçası olarak sunucuya gönderilebilir.
Navigate(Uri, String, Byte[], String)

Belirtilen Uri konumdaki belgeye zaman uyumsuz olarak gidin ve belgenin içeriğinin yükleneceğini hedef çerçeveyi belirtin. Ek HTTP POST verileri ve HTTP üst bilgileri, gezinti isteğinin bir parçası olarak sunucuya gönderilebilir.
Navigate(String)

Belirtilen URL'deki belgeye zaman uyumsuz olarak gider.
Navigate(Uri)

Belirtilen Urikonumundaki belgeye zaman uyumsuz olarak gidin.

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

Belirtilen URL'deki belgeye zaman uyumsuz olarak gider ve belgenin içeriğinin yükleneceğini hedef çerçeveyi belirtir. Ek HTTP POST verileri ve HTTP üst bilgileri, gezinti isteğinin bir parçası olarak sunucuya gönderilebilir.

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)

Parametreler

source
String

Gezinmek için URL.

targetFrameName
String

Belgenin içeriğinin görüntüleneceği çerçevenin adı.

postData
Byte[]

Kaynak istendiğinde sunucuya gönderilecek HTTP POST verileri.

additionalHeaders
String

Kaynak istendiğinde sunucuya gönderilecek HTTP üst bilgileri.

Açıklamalar

Navigate(String, String, Byte[], String) Kaçış karakterleri içerebilecek bir URL'ye gitmek için yöntemini kullanın. Navigate(Uri, String, Byte[], String) Kaçış karakterleri içermeyen bir Uri öğesine gitmek için yöntemini kullanın.

Şunlara uygulanır

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

Belirtilen Uri konumdaki belgeye zaman uyumsuz olarak gidin ve belgenin içeriğinin yükleneceğini hedef çerçeveyi belirtin. Ek HTTP POST verileri ve HTTP üst bilgileri, gezinti isteğinin bir parçası olarak sunucuya gönderilebilir.

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)

Parametreler

source
Uri

Uri gidecek.

targetFrameName
String

Belgenin içeriğinin görüntüleneceği çerçevenin adı.

postData
Byte[]

Kaynak istendiğinde sunucuya gönderilecek HTTP POST verileri.

additionalHeaders
String

Kaynak istendiğinde sunucuya gönderilecek HTTP üst bilgileri.

Özel durumlar

ObjectDisposedException

Örnek WebBrowser artık geçerli değil.

InvalidOperationException

Temel alınan yerel WebBrowser başvuru alınamadı.

SecurityException

Kısmi güven içinde çalışan bir uygulamadan gezinti:

  • Kaynak sitede bulunmayan veya Uri

  • targetFrameName ad veya boş değil null .

Örnekler

Aşağıdaki örnek, "about:blank" hedefini belirterek belgeye nasıl gidileceğini ve yeni bir tarayıcı penceresinde nasıl açılacağını gösterir.

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

Açıklamalar

Navigate(String, String, Byte[], String) Kaçış karakterleri içerebilecek bir URL'ye gitmek için yöntemini kullanın. Navigate(Uri, String, Byte[], String) Kaçış karakterleri içermeyen bir Uri öğesine gitmek için yöntemini kullanın.

Şunlara uygulanır

Navigate(String)

Belirtilen URL'deki belgeye zaman uyumsuz olarak gider.

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

Parametreler

source
String

Gezinmek için URL.

Açıklamalar

Navigate(String) Kaçış karakterleri içerebilecek bir URL'ye gitmek için yöntemini kullanın. Navigate(Uri) Kaçış karakterleri içermeyen bir Uri öğesine gitmek için yöntemini kullanın.

Şunlara uygulanır

Navigate(Uri)

Belirtilen Urikonumundaki belgeye zaman uyumsuz olarak gidin.

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

Parametreler

source
Uri

Uri gidecek.

Özel durumlar

ObjectDisposedException

Örnek WebBrowser artık geçerli değil.

InvalidOperationException

Temel alınan yerel WebBrowser başvuru alınamadı.

SecurityException

Kısmi güven içinde çalışan bir uygulamadan kaynak sitede bulunmayan bir Uri uygulamaya gezinti.

Örnekler

Aşağıdaki örnekte yöntemini kullanarak bir belgeye gitmek için nasıl kullanılacağı WebBrowser gösterilmektedir Navigate(Uri) .

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

Açıklamalar

Çağırma Navigate(Uri) özelliğin ayarlanmasıyla Source aynı etkiye sahiptir. Source, başlatıldığında gidilen WebBrowser ilk belgeyi WebBrowser bildirimli olarak belirtmek isteyen geliştiriciler tarafından işaretlemeden kullanılır.

Navigate(String) Kaçış karakterleri içerebilecek bir URL'ye gitmek için yöntemini kullanın. Navigate(Uri) Kaçış karakterleri içermeyen bir Uri öğesine gitmek için yöntemini kullanın.

Şunlara uygulanır