WebBrowser.Navigate Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Načte dokument do zadaného umístění do WebBrowser ovládacího prvku.

Přetížení

Name	Description
Navigate(Uri, String, Byte[], String)	Načte dokument do umístění určeného zadaným Uri do WebBrowser ovládacího prvku, požádá ho o použití zadaných dat HTTP a nahradí obsah rámečku webové stránky zadaným názvem.
Navigate(String, String, Byte[], String)	Načte dokument na zadanou adresu URL (Uniform Resource Locator) do WebBrowser ovládacího prvku, požádá ho o použití zadaných dat HTTP a nahradí obsah rámečku webové stránky zadaným názvem.
Navigate(Uri, Boolean)	Načte dokument do umístění určeného zadaným Uri do nového okna prohlížeče nebo do WebBrowser ovládacího prvku.
Navigate(Uri, String)	Načte dokument do umístění určeného zadaným Uri do WebBrowser ovládacího prvku a nahradí obsah rámečku webové stránky zadaným názvem.
Navigate(String, Boolean)	Načte dokument na zadanou adresu URL (Uniform Resource Locator) do nového okna prohlížeče nebo do WebBrowser ovládacího prvku.
Navigate(String, String)	Načte dokument na zadanou adresu URL (Uniform Resource Locator) do WebBrowser ovládacího prvku a nahradí obsah rámečku webové stránky zadaným názvem.
Navigate(Uri)	Načte dokument do umístění určeného zadaným Uri do WebBrowser ovládacího prvku a nahradí předchozí dokument.
Navigate(String)	Načte dokument na zadanou adresu URL (Uniform Resource Locator) do WebBrowser ovládacího prvku a nahradí předchozí dokument.

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

Zdroj:

WebBrowser.cs

Načte dokument do umístění určeného zadaným Uri do WebBrowser ovládacího prvku, požádá ho o použití zadaných dat HTTP a nahradí obsah rámečku webové stránky zadaným názvem.

public:
 void Navigate(Uri ^ url, System::String ^ targetFrameName, cli::array <System::Byte> ^ postData, System::String ^ additionalHeaders);

public void Navigate(Uri? url, string? targetFrameName, byte[]? postData, string? additionalHeaders);

member this.Navigate : Uri * string * byte[] * string -> unit

Public Sub Navigate (url As Uri, targetFrameName As String, postData As Byte(), additionalHeaders As String)

Parametry

url

Uri

Představuje Uri adresu URL dokumentu, který se má načíst.

targetFrameName

String

Název rámce, do kterého chcete dokument načíst.

postData

Byte[]

Data HTTP POST, například data formuláře.

additionalHeaders

String

Hlavičky HTTP, které se mají přidat do výchozích hlaviček.

Výjimky

ObjectDisposedException

Tato WebBrowser instance již není platná.

InvalidOperationException

Odkaz na implementaci IWebBrowser2 rozhraní nelze načíst ze základního ovládacího prvku ActiveX WebBrowser .

ArgumentException

Hodnota url parametru nepředstavuje absolutní identifikátor URI. Další informace najdete na webu IsAbsoluteUri.

Poznámky

Ovládací WebBrowser prvek udržuje seznam historie všech webových stránek navštívených během relace procházení. Při volání tohoto přetížení WebBrowser ovládací prvek načte dokument na zadaný identifikátor URI do rámce webové stránky se zadaným názvem a přidá identifikátor URI na konec seznamu historie. Pokud je zadaný název rámce neplatný, dokument se načte do nového okna Internet Explorer.

GoBack Metoda slouží k vrácení ovládacího prvku na předchozí stránku v historii navigace. Metodu GoForward použijte k návratu na pozdější stránku v historii navigace po návratu dozadu.

Ovládací WebBrowser prvek ukládá webové stránky z nedávno navštívených webů do mezipaměti na místním pevném disku. Každá stránka může zadat datum vypršení platnosti určující, jak dlouho zůstane v mezipaměti. Když ovládací prvek přejde na stránku, ušetří čas zobrazením verze uložené v mezipaměti, pokud je k dispozici, místo opětovného stažení stránky. Refresh Pomocí metody vynutit WebBrowser ovládací prvek znovu načíst aktuální stránku stažením a zajistit, aby ovládací prvek zobrazil nejnovější verzi.

Viz také

• GoBack()
• GoForward()
• Refresh()
• IWebBrowser2 – rozhraní

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

Zdroj:

WebBrowser.cs

Načte dokument na zadanou adresu URL (Uniform Resource Locator) do WebBrowser ovládacího prvku, požádá ho o použití zadaných dat HTTP a nahradí obsah rámečku webové stránky zadaným názvem.

public:
 void Navigate(System::String ^ urlString, System::String ^ targetFrameName, cli::array <System::Byte> ^ postData, System::String ^ additionalHeaders);

public void Navigate(string urlString, string? targetFrameName, byte[]? postData, string? additionalHeaders);

member this.Navigate : string * string * byte[] * string -> unit

Public Sub Navigate (urlString As String, targetFrameName As String, postData As Byte(), additionalHeaders As String)

Parametry

urlString

String

Adresa URL dokumentu, který se má načíst.

targetFrameName

String

Název rámce, do kterého chcete dokument načíst.

postData

Byte[]

Data HTTP POST, například data formuláře.

additionalHeaders

String

Hlavičky HTTP, které se mají přidat do výchozích hlaviček.

Výjimky

ObjectDisposedException

Tato WebBrowser instance již není platná.

InvalidOperationException

Odkaz na implementaci IWebBrowser2 rozhraní nelze načíst ze základního ovládacího prvku ActiveX WebBrowser .

Poznámky

Ovládací WebBrowser prvek udržuje seznam historie všech webových stránek navštívených během relace procházení. Při volání tohoto přetížení WebBrowser ovládací prvek načte dokument na zadaný identifikátor URI do rámce webové stránky se zadaným názvem a přidá identifikátor URI na konec seznamu historie. Pokud je zadaný název rámce neplatný, dokument se načte do nového okna Internet Explorer.

GoBack Metoda slouží k vrácení ovládacího prvku na předchozí stránku v historii navigace. Metodu GoForward použijte k návratu na pozdější stránku v historii navigace po návratu dozadu.

Ovládací WebBrowser prvek ukládá webové stránky z nedávno navštívených webů do mezipaměti na místním pevném disku. Každá stránka může zadat datum vypršení platnosti určující, jak dlouho zůstane v mezipaměti. Když ovládací prvek přejde na stránku, ušetří čas zobrazením verze uložené v mezipaměti, pokud je k dispozici, místo opětovného stažení stránky. Refresh Pomocí metody vynutit WebBrowser ovládací prvek znovu načíst aktuální stránku stažením a zajistit, aby ovládací prvek zobrazil nejnovější verzi.

Viz také

• GoBack()
• GoForward()
• Refresh()
• IWebBrowser2 – rozhraní

Navigate(Uri, Boolean)

Zdroj:

WebBrowser.cs

Načte dokument do umístění určeného zadaným Uri do nového okna prohlížeče nebo do WebBrowser ovládacího prvku.

public:
 void Navigate(Uri ^ url, bool newWindow);

public void Navigate(Uri? url, bool newWindow);

member this.Navigate : Uri * bool -> unit

Public Sub Navigate (url As Uri, newWindow As Boolean)

Parametry

url

Uri

Představuje Uri adresu URL dokumentu, který se má načíst.

newWindow

Boolean

true načíst dokument do nového okna prohlížeče; false pro načtení dokumentu do WebBrowser ovládacího prvku.

Výjimky

ObjectDisposedException

Tato WebBrowser instance již není platná.

InvalidOperationException

Odkaz na implementaci IWebBrowser2 rozhraní nelze načíst ze základního ovládacího prvku ActiveX WebBrowser .

ArgumentException

Hodnota url parametru nepředstavuje absolutní identifikátor URI. Další informace najdete na webu IsAbsoluteUri.

Poznámky

Ovládací WebBrowser prvek udržuje seznam historie všech webových stránek navštívených během relace procházení. Při volání tohoto přetížení s newWindow hodnotou parametru false, ovládací prvek přejde na zadaný identifikátor URI normálně a přidá identifikátor URI na konec seznamu historie. Při volání tohoto přetížení s newWindow hodnotu parametru true, ovládací prvek WebBrowser načte dokument na zadaný identifikátor URI do nového okna Internet Explorer, který udržuje vlastní historii navigace. Událost můžete zpracovat NewWindow tak, aby dostávala oznámení před otevřením nového okna prohlížeče. V případě potřeby můžete akci zrušit.

Ovládací WebBrowser prvek ukládá webové stránky z nedávno navštívených webů do mezipaměti na místním pevném disku. Každá stránka může zadat datum vypršení platnosti určující, jak dlouho zůstane v mezipaměti. Když ovládací prvek přejde na stránku nebo načte stránku do samostatného okna prohlížeče, ušetří čas zobrazením verze uložené v mezipaměti, pokud je k dispozici, a ne opětovným stažením stránky. Refresh Pomocí metody vynutit WebBrowser ovládací prvek znovu načíst aktuální stránku stažením a zajistit, aby ovládací prvek zobrazil nejnovější verzi. Když se stránka načte do samostatného okna Internet Explorer, uživatel může načíst nejnovější verzi kliknutím na tlačítko Refresh.

Viz také

• GoBack()
• GoForward()
• NewWindow
• Refresh()
• IWebBrowser2 – rozhraní

Navigate(Uri, String)

Zdroj:

WebBrowser.cs

Načte dokument do umístění určeného zadaným Uri do WebBrowser ovládacího prvku a nahradí obsah rámečku webové stránky zadaným názvem.

public:
 void Navigate(Uri ^ url, System::String ^ targetFrameName);

public void Navigate(Uri? url, string? targetFrameName);

member this.Navigate : Uri * string -> unit

Public Sub Navigate (url As Uri, targetFrameName As String)

Parametry

url

Uri

Představuje Uri adresu URL dokumentu, který se má načíst.

targetFrameName

String

Název rámce, do kterého chcete dokument načíst.

Výjimky

ObjectDisposedException

Tato WebBrowser instance již není platná.

InvalidOperationException

Odkaz na implementaci IWebBrowser2 rozhraní nelze načíst ze základního ovládacího prvku ActiveX WebBrowser .

ArgumentException

Hodnota url parametru nepředstavuje absolutní identifikátor URI. Další informace najdete na webu IsAbsoluteUri.

Poznámky

Ovládací WebBrowser prvek udržuje seznam historie všech webových stránek navštívených během relace procházení. Při volání tohoto přetížení WebBrowser ovládací prvek načte dokument na zadaný identifikátor URI do rámce webové stránky se zadaným názvem a přidá identifikátor URI na konec seznamu historie. Pokud je zadaný název rámce neplatný, dokument se načte do nového okna Internet Explorer.

GoBack Metoda slouží k vrácení ovládacího prvku na předchozí stránku v historii navigace. Metodu GoForward použijte k návratu na pozdější stránku v historii navigace po návratu dozadu.

Ovládací WebBrowser prvek ukládá webové stránky z nedávno navštívených webů do mezipaměti na místním pevném disku. Každá stránka může zadat datum vypršení platnosti určující, jak dlouho zůstane v mezipaměti. Když ovládací prvek přejde na stránku, ušetří čas zobrazením verze uložené v mezipaměti, pokud je k dispozici, místo opětovného stažení stránky. Refresh Pomocí metody vynutit WebBrowser ovládací prvek znovu načíst aktuální stránku stažením a zajistit, aby ovládací prvek zobrazil nejnovější verzi.

Viz také

• GoBack()
• GoForward()
• Refresh()
• IWebBrowser2 – rozhraní

Navigate(String, Boolean)

Zdroj:

WebBrowser.cs

Načte dokument na zadanou adresu URL (Uniform Resource Locator) do nového okna prohlížeče nebo do WebBrowser ovládacího prvku.

public:
 void Navigate(System::String ^ urlString, bool newWindow);

public void Navigate(string urlString, bool newWindow);

member this.Navigate : string * bool -> unit

Public Sub Navigate (urlString As String, newWindow As Boolean)

Parametry

urlString

String

Adresa URL dokumentu, který se má načíst.

newWindow

Boolean

true načíst dokument do nového okna prohlížeče; false pro načtení dokumentu do WebBrowser ovládacího prvku.

Výjimky

ObjectDisposedException

Tato WebBrowser instance již není platná.

InvalidOperationException

Odkaz na implementaci IWebBrowser2 rozhraní nelze načíst ze základního ovládacího prvku ActiveX WebBrowser .

Poznámky

Ovládací WebBrowser prvek udržuje seznam historie všech webových stránek navštívených během relace procházení. Při volání tohoto přetížení s newWindow hodnotou parametru false, ovládací prvek přejde na zadaný identifikátor URI normálně a přidá identifikátor URI na konec seznamu historie. Při volání tohoto přetížení s newWindow hodnotu parametru true, ovládací prvek WebBrowser načte dokument na zadaný identifikátor URI do nového okna Internet Explorer, který udržuje vlastní historii navigace. Událost můžete zpracovat NewWindow tak, aby dostávala oznámení před otevřením nového okna prohlížeče. V případě potřeby můžete akci zrušit.

Ovládací WebBrowser prvek ukládá webové stránky z nedávno navštívených webů do mezipaměti na místním pevném disku. Každá stránka může zadat datum vypršení platnosti určující, jak dlouho zůstane v mezipaměti. Když ovládací prvek přejde na stránku nebo načte stránku do samostatného okna prohlížeče, ušetří čas zobrazením verze uložené v mezipaměti, pokud je k dispozici, a ne opětovným stažením stránky. Refresh Pomocí metody vynutit WebBrowser ovládací prvek znovu načíst aktuální stránku stažením a zajistit, aby ovládací prvek zobrazil nejnovější verzi. Když se stránka načte do samostatného okna Internet Explorer, uživatel může načíst nejnovější verzi kliknutím na tlačítko Refresh.

Viz také

• GoBack()
• GoForward()
• NewWindow
• Refresh()

Navigate(String, String)

Zdroj:

WebBrowser.cs

Načte dokument na zadanou adresu URL (Uniform Resource Locator) do WebBrowser ovládacího prvku a nahradí obsah rámečku webové stránky zadaným názvem.

public:
 void Navigate(System::String ^ urlString, System::String ^ targetFrameName);

public void Navigate(string urlString, string? targetFrameName);

member this.Navigate : string * string -> unit

Public Sub Navigate (urlString As String, targetFrameName As String)

Parametry

urlString

String

Adresa URL dokumentu, který se má načíst.

targetFrameName

String

Název rámce, do kterého chcete dokument načíst.

Výjimky

ObjectDisposedException

Tato WebBrowser instance již není platná.

InvalidOperationException

Odkaz na implementaci IWebBrowser2 rozhraní nelze načíst ze základního ovládacího prvku ActiveX WebBrowser .

Poznámky

Ovládací WebBrowser prvek udržuje seznam historie všech webových stránek navštívených během relace procházení. Při volání tohoto přetížení WebBrowser ovládací prvek načte dokument na zadaný identifikátor URI do rámce webové stránky se zadaným názvem a přidá identifikátor URI na konec seznamu historie. Pokud je zadaný název rámce neplatný, dokument se načte do nového okna Internet Explorer.

GoBack Metoda slouží k vrácení ovládacího prvku na předchozí stránku v historii navigace. Metodu GoForward použijte k návratu na pozdější stránku v historii navigace po návratu dozadu.

Ovládací WebBrowser prvek ukládá webové stránky z nedávno navštívených webů do mezipaměti na místním pevném disku. Každá stránka může zadat datum vypršení platnosti určující, jak dlouho zůstane v mezipaměti. Když ovládací prvek přejde na stránku, ušetří čas zobrazením verze uložené v mezipaměti, pokud je k dispozici, místo opětovného stažení stránky. Refresh Pomocí metody vynutit WebBrowser ovládací prvek znovu načíst aktuální stránku stažením a zajistit, aby ovládací prvek zobrazil nejnovější verzi.

Viz také

• GoBack()
• GoForward()
• Refresh()
• IWebBrowser2 – rozhraní

Navigate(Uri)

Zdroj:

WebBrowser.cs

Načte dokument do umístění určeného zadaným Uri do WebBrowser ovládacího prvku a nahradí předchozí dokument.

public:
 void Navigate(Uri ^ url);

public void Navigate(Uri? url);

member this.Navigate : Uri -> unit

Public Sub Navigate (url As Uri)

Parametry

url

Uri

Představuje Uri adresu URL dokumentu, který se má načíst.

Výjimky

ObjectDisposedException

Tato WebBrowser instance již není platná.

InvalidOperationException

Odkaz na implementaci IWebBrowser2 rozhraní nelze načíst ze základního ovládacího prvku ActiveX WebBrowser .

ArgumentException

Hodnota url parametru nepředstavuje absolutní identifikátor URI. Další informace najdete na webu IsAbsoluteUri.

Příklady

Následující příklad kódu ukazuje, jak použít metodu Navigate k implementaci adresního řádku pro WebBrowser ovládací prvek. Tento příklad vyžaduje, aby formulář obsahuje WebBrowser ovládací prvek s názvem , webBrowser1 s TextBoxnázvem TextBoxAddressovládacího prvku a Button s názvem ButtonGoovládacího prvku . Když do textového pole zadáte adresu URL a stisknete enter nebo kliknete na tlačítko Přejít , WebBrowser ovládací prvek přejde na zadanou adresu URL. Když přejdete kliknutím na hypertextový odkaz, textové pole se automaticky aktualizuje, aby se zobrazila aktuální adresa URL.

Úplný příklad kódu najdete v tématu How to: Add Web Browser Capabilities to a model Windows Forms Application.

// Navigates to the URL in the address text box when 
// the ENTER key is pressed while the text box has focus.
void TextBoxAddress_KeyDown( Object^ /*sender*/, System::Windows::Forms::KeyEventArgs^ e )
{
   if ( e->KeyCode == System::Windows::Forms::Keys::Enter &&  !this->TextBoxAddress->Text->Equals( "" ) )
   {
      this->WebBrowser1->Navigate( this->TextBoxAddress->Text );
   }
}

// Navigates to the URL in the address text box when 
// the Go button is clicked.
void ButtonGo_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   if (  !this->TextBoxAddress->Text->Equals( "" ) )
   {
      this->WebBrowser1->Navigate( this->TextBoxAddress->Text );
   }
}

// Updates the URL in TextBoxAddress upon navigation.
void WebBrowser1_Navigated( Object^ /*sender*/, System::Windows::Forms::WebBrowserNavigatedEventArgs^ /*e*/ )
{
   this->TextBoxAddress->Text = this->WebBrowser1->Url->ToString();
}

// Navigates to the URL in the address box when 
// the ENTER key is pressed while the ToolStripTextBox has focus.
private void toolStripTextBox1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Enter)
    {
        Navigate(toolStripTextBox1.Text);
    }
}

// Navigates to the URL in the address box when 
// the Go button is clicked.
private void goButton_Click(object sender, EventArgs e)
{
    Navigate(toolStripTextBox1.Text);
}

// Navigates to the given URL if it is valid.
private void Navigate(String address)
{
    if (String.IsNullOrEmpty(address)) return;
    if (address.Equals("about:blank")) return;
    if (!address.StartsWith("http://") &&
        !address.StartsWith("https://"))
    {
        address = "http://" + address;
    }
    try
    {
        webBrowser1.Navigate(new Uri(address));
    }
    catch (System.UriFormatException)
    {
        return;
    }
}

// Updates the URL in TextBoxAddress upon navigation.
private void webBrowser1_Navigated(object sender,
    WebBrowserNavigatedEventArgs e)
{
    toolStripTextBox1.Text = webBrowser1.Url.ToString();
}

' Navigates to the URL in the address box when 
' the ENTER key is pressed while the ToolStripTextBox has focus.
Private Sub toolStripTextBox1_KeyDown( _
    ByVal sender As Object, ByVal e As KeyEventArgs) _
    Handles toolStripTextBox1.KeyDown

    If (e.KeyCode = Keys.Enter) Then
        Navigate(toolStripTextBox1.Text)
    End If

End Sub

' Navigates to the URL in the address box when 
' the Go button is clicked.
Private Sub goButton_Click( _
    ByVal sender As Object, ByVal e As EventArgs) _
    Handles goButton.Click

    Navigate(toolStripTextBox1.Text)

End Sub

' Navigates to the given URL if it is valid.
Private Sub Navigate(ByVal address As String)

    If String.IsNullOrEmpty(address) Then Return
    If address.Equals("about:blank") Then Return
    If Not address.StartsWith("http://") And _
        Not address.StartsWith("https://") Then
        address = "http://" & address
    End If

    Try
        webBrowser1.Navigate(New Uri(address))
    Catch ex As System.UriFormatException
        Return
    End Try

End Sub

' Updates the URL in TextBoxAddress upon navigation.
Private Sub webBrowser1_Navigated(ByVal sender As Object, _
    ByVal e As WebBrowserNavigatedEventArgs) _
    Handles webBrowser1.Navigated

    toolStripTextBox1.Text = webBrowser1.Url.ToString()

End Sub

Poznámky

Ovládací WebBrowser prvek udržuje seznam historie všech webových stránek navštívených během relace procházení. Při volání tohoto přetížení WebBrowser ovládací prvek přejde na zadaný identifikátor URI a přidá ho na konec seznamu historie. GoBack Metoda slouží k vrácení ovládacího prvku na předchozí stránku v historii navigace. Metodu GoForward použijte k návratu na pozdější stránku v historii navigace po návratu dozadu.

Ovládací WebBrowser prvek ukládá webové stránky z nedávno navštívených webů do mezipaměti na místním pevném disku. Každá stránka může zadat datum vypršení platnosti určující, jak dlouho zůstane v mezipaměti. Když ovládací prvek přejde na stránku, ušetří čas zobrazením verze uložené v mezipaměti, pokud je k dispozici, místo opětovného stažení stránky. Refresh Pomocí metody vynutit WebBrowser ovládací prvek znovu načíst aktuální stránku stažením a zajistit, aby ovládací prvek zobrazil nejnovější verzi.

Pomocí metody Navigate můžete implementovat adresní řádek podobný adresní řádku v Internet Explorer.

Viz také

• GoBack()
• GoForward()
• Refresh()
• IWebBrowser2 – rozhraní

Navigate(String)

Zdroj:

WebBrowser.cs

Načte dokument na zadanou adresu URL (Uniform Resource Locator) do WebBrowser ovládacího prvku a nahradí předchozí dokument.

public:
 void Navigate(System::String ^ urlString);

public void Navigate(string urlString);

member this.Navigate : string -> unit

Public Sub Navigate (urlString As String)

Parametry

urlString

String

Adresa URL dokumentu, který se má načíst.

Výjimky

ObjectDisposedException

Tato WebBrowser instance již není platná.

InvalidOperationException

Odkaz na implementaci IWebBrowser2 rozhraní nelze načíst ze základního ovládacího prvku ActiveX WebBrowser .

Poznámky

Ovládací WebBrowser prvek udržuje seznam historie všech webových stránek navštívených během relace procházení. Při volání tohoto přetížení WebBrowser ovládací prvek přejde na zadaný identifikátor URI a přidá ho na konec seznamu historie. GoBack Metoda slouží k vrácení ovládacího prvku na předchozí stránku v historii navigace. Metodu GoForward použijte k návratu na pozdější stránku v historii navigace po návratu dozadu.

Ovládací WebBrowser prvek ukládá webové stránky z nedávno navštívených webů do mezipaměti na místním pevném disku. Každá stránka může zadat datum vypršení platnosti určující, jak dlouho zůstane v mezipaměti. Když ovládací prvek přejde na stránku, ušetří čas zobrazením verze uložené v mezipaměti, pokud je k dispozici, místo opětovného stažení stránky. Refresh Pomocí metody vynutit WebBrowser ovládací prvek znovu načíst aktuální stránku stažením a zajistit, aby ovládací prvek zobrazil nejnovější verzi.

Pomocí metody Navigate můžete implementovat adresní řádek podobný adresní řádku v Internet Explorer.

Viz také

• GoBack()
• GoForward()
• Refresh()
• IWebBrowser2 – rozhraní