WebBrowser.Navigate Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Načte dokument v zadaném umístění do WebBrowser ovládacího prvku.
Přetížení
Navigate(Uri, String, Byte[], String) |
Načte dokument v umístění určeném zadaným Uri do WebBrowser ovládacího prvku, vyžádá si ho pomocí zadaných dat HTTP a nahradí obsah rámce webové stránky zadaným názvem. |
Navigate(String, String, Byte[], String) |
Načte dokument na zadané adrese URL (Uniform Resource Locator) do WebBrowser ovládacího prvku, vyžádá si ho pomocí zadaných dat HTTP a nahradí obsah rámce webové stránky zadaným názvem. |
Navigate(Uri, Boolean) |
Načte dokument v umístění určeném zadaným Uri do nového okna prohlížeče nebo do WebBrowser ovládacího prvku. |
Navigate(Uri, String) |
Načte dokument v umístění určeném zadaným Uri do WebBrowser ovládacího prvku a nahradí obsah rámce webové stránky zadaným názvem. |
Navigate(String, Boolean) |
Načte dokument na zadané adrese 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 zadané adrese URL (Uniform Resource Locator) do WebBrowser ovládacího prvku a nahradí obsah rámce webové stránky zadaným názvem. |
Navigate(Uri) |
Načte dokument v umístění určeném zadaným Uri do WebBrowser ovládacího prvku a nahradí předchozí dokument. |
Navigate(String) |
Načte dokument na zadané adrese URL (Uniform Resource Locator) do WebBrowser ovládacího prvku a nahradí předchozí dokument. |
Navigate(Uri, String, Byte[], String)
Načte dokument v umístění určeném zadaným Uri do WebBrowser ovládacího prvku, vyžádá si ho pomocí zadaných dat HTTP a nahradí obsah rámce 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);
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
- targetFrameName
- String
Název rámce, do kterého se má dokument načíst.
- postData
- Byte[]
Data HTTP POST, jako jsou data formulářů.
- additionalHeaders
- String
Hlavičky HTTP, které se mají přidat do výchozích hlaviček.
Výjimky
Tato WebBrowser instance již není platná.
Odkaz na implementaci IWebBrowser2
rozhraní nelze načíst z podkladového ovládacího prvku ActiveX WebBrowser
.
Hodnota url
parametru nepředstavuje absolutní identifikátor URI. Další informace naleznete v tématu 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ém identifikátoru 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 Aplikace Internet Explorer.
GoBack Pomocí metody vraťte ovládací prvek na předchozí stránku v historii navigace. GoForward Pomocí metody se po přechodu dozadu vraťte na pozdější stránku v historii navigace.
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 určit 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 dostupná) místo opětovného stahování stránky. Refresh Pomocí metody vynuťteWebBrowser, aby ovládací prvek znovu načítá aktuální stránku stažením, čímž zajistíte, že ovládací prvek zobrazí nejnovější verzi.
Viz také
Platí pro
Navigate(String, String, Byte[], String)
Načte dokument na zadané adrese URL (Uniform Resource Locator) do WebBrowser ovládacího prvku, vyžádá si ho pomocí zadaných dat HTTP a nahradí obsah rámce 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);
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 se má dokument načíst.
- postData
- Byte[]
Data HTTP POST, jako jsou data formulářů.
- additionalHeaders
- String
Hlavičky HTTP, které se mají přidat do výchozích hlaviček.
Výjimky
Tato WebBrowser instance již není platná.
Odkaz na implementaci IWebBrowser2
rozhraní nelze načíst z podkladové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ém identifikátoru 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 Aplikace Internet Explorer.
GoBack Pomocí metody vraťte ovládací prvek na předchozí stránku v historii navigace. GoForward Pomocí metody se po přechodu dozadu vraťte na pozdější stránku v historii navigace.
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 určit 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 dostupná) místo opětovného stahování stránky. Refresh Pomocí metody vynuťteWebBrowser, aby ovládací prvek znovu načítá aktuální stránku stažením, čímž zajistíte, že ovládací prvek zobrazí nejnovější verzi.
Viz také
Platí pro
Navigate(Uri, Boolean)
Načte dokument v umístění určeném 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);
public void Navigate (Uri? url, bool newWindow);
member this.Navigate : Uri * bool -> unit
Public Sub Navigate (url As Uri, newWindow As Boolean)
Parametry
- newWindow
- Boolean
true
načíst dokument do nového okna prohlížeče; false
a načtěte dokument do WebBrowser ovládacího prvku.
Výjimky
Tato WebBrowser instance již není platná.
Odkaz na implementaci IWebBrowser2
rozhraní nelze načíst z podkladového ovládacího prvku ActiveX WebBrowser
.
Hodnota url
parametru nepředstavuje absolutní identifikátor URI. Další informace naleznete v tématu 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
hodnotou parametru true
, WebBrowser ovládací prvek načte dokument na zadaném identifikátoru URI do nového okna aplikace Internet Explorer, které udržuje vlastní historii navigace. Událost můžete zpracovat tak, NewWindow aby obdržela oznámení před otevřením nového okna prohlížeče, což vám umožní akci v případě potřeby 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 určit 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 dostupná, místo opětovného stažení stránky. Refresh Pomocí metody vynuťteWebBrowser, aby ovládací prvek znovu načítá aktuální stránku stažením, čímž zajistíte, že ovládací prvek zobrazí nejnovější verzi. Když se stránka načte do samostatného okna Internet Exploreru, může uživatel načíst nejnovější verzi kliknutím na tlačítko Aktualizovat .
Viz také
Platí pro
Navigate(Uri, String)
Načte dokument v umístění určeném zadaným Uri do WebBrowser ovládacího prvku a nahradí obsah rámce webové stránky zadaným názvem.
public:
void Navigate(Uri ^ url, System::String ^ targetFrameName);
public void Navigate (Uri url, 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
- targetFrameName
- String
Název rámce, do kterého se má dokument načíst.
Výjimky
Tato WebBrowser instance již není platná.
Odkaz na implementaci IWebBrowser2
rozhraní nelze načíst z podkladového ovládacího prvku ActiveX WebBrowser
.
Hodnota url
parametru nepředstavuje absolutní identifikátor URI. Další informace naleznete v tématu 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ém identifikátoru 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 Aplikace Internet Explorer.
GoBack Pomocí metody vraťte ovládací prvek na předchozí stránku v historii navigace. GoForward Pomocí metody se po přechodu dozadu vraťte na pozdější stránku v historii navigace.
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 určit 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 dostupná) místo opětovného stahování stránky. Refresh Pomocí metody vynuťteWebBrowser, aby ovládací prvek znovu načítá aktuální stránku stažením, čímž zajistíte, že ovládací prvek zobrazí nejnovější verzi.
Viz také
Platí pro
Navigate(String, Boolean)
Načte dokument na zadané adrese 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
a načtěte dokument do WebBrowser ovládacího prvku.
Výjimky
Tato WebBrowser instance již není platná.
Odkaz na implementaci IWebBrowser2
rozhraní nelze načíst z podkladové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
hodnotou parametru true
, WebBrowser ovládací prvek načte dokument na zadaném identifikátoru URI do nového okna aplikace Internet Explorer, které udržuje vlastní historii navigace. Událost můžete zpracovat tak, NewWindow aby obdržela oznámení před otevřením nového okna prohlížeče, což vám umožní akci v případě potřeby 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 určit 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 dostupná, místo opětovného stažení stránky. Refresh Pomocí metody vynuťteWebBrowser, aby ovládací prvek znovu načítá aktuální stránku stažením, čímž zajistíte, že ovládací prvek zobrazí nejnovější verzi. Když se stránka načte do samostatného okna Internet Exploreru, může uživatel načíst nejnovější verzi kliknutím na tlačítko Aktualizovat .
Viz také
Platí pro
Navigate(String, String)
Načte dokument na zadané adrese URL (Uniform Resource Locator) do WebBrowser ovládacího prvku a nahradí obsah rámce webové stránky zadaným názvem.
public:
void Navigate(System::String ^ urlString, System::String ^ targetFrameName);
public void Navigate (string urlString, 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 se má dokument načíst.
Výjimky
Tato WebBrowser instance již není platná.
Odkaz na implementaci IWebBrowser2
rozhraní nelze načíst z podkladové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ém identifikátoru 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 Aplikace Internet Explorer.
GoBack Pomocí metody vraťte ovládací prvek na předchozí stránku v historii navigace. GoForward Pomocí metody se po přechodu dozadu vraťte na pozdější stránku v historii navigace.
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 určit 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 dostupná) místo opětovného stahování stránky. Refresh Pomocí metody vynuťteWebBrowser, aby ovládací prvek znovu načítá aktuální stránku stažením, čímž zajistíte, že ovládací prvek zobrazí nejnovější verzi.
Viz také
Platí pro
Navigate(Uri)
Načte dokument v umístění určeném zadaným Uri do WebBrowser ovládacího prvku a nahradí předchozí dokument.
public:
void Navigate(Uri ^ url);
public void Navigate (Uri url);
public void Navigate (Uri? url);
member this.Navigate : Uri -> unit
Public Sub Navigate (url As Uri)
Parametry
Výjimky
Tato WebBrowser instance již není platná.
Odkaz na implementaci IWebBrowser2
rozhraní nelze načíst z podkladového ovládacího prvku ActiveX WebBrowser
.
Hodnota url
parametru nepředstavuje absolutní identifikátor URI. Další informace naleznete v tématu 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ář obsahoval WebBrowser ovládací prvek s názvem webBrowser1
, TextBox ovládací prvek s názvem TextBoxAddress
a Button ovládací prvek s názvem ButtonGo
. Když do textového pole zadáte adresu URL a stisknete klávesu 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.
Kompletní příklad kódu najdete v tématu Postupy: Přidání funkcí webového prohlížeče do aplikace model Windows Forms.
// 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 Pomocí metody vraťte ovládací prvek na předchozí stránku v historii navigace. GoForward Pomocí metody se po přechodu dozadu vraťte na pozdější stránku v historii navigace.
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 určit 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 dostupná) místo opětovného stahování stránky. Refresh Pomocí metody vynuťteWebBrowser, aby ovládací prvek znovu načítá aktuální stránku stažením, čímž zajistíte, že ovládací prvek zobrazí nejnovější verzi.
Metodu Navigate můžete použít k implementaci adresního řádku podobného panelu v Internet Exploreru.
Viz také
Platí pro
Navigate(String)
Načte dokument na zadané adrese 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
Tato WebBrowser instance již není platná.
Odkaz na implementaci IWebBrowser2
rozhraní nelze načíst z podkladové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 Pomocí metody vraťte ovládací prvek na předchozí stránku v historii navigace. GoForward Pomocí metody se po přechodu dozadu vraťte na pozdější stránku v historii navigace.
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 určit 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 dostupná) místo opětovného stahování stránky. Refresh Pomocí metody vynuťteWebBrowser, aby ovládací prvek znovu načítá aktuální stránku stažením, čímž zajistíte, že ovládací prvek zobrazí nejnovější verzi.
Metodu Navigate můžete použít k implementaci adresního řádku podobného panelu v Internet Exploreru.
Viz také
Platí pro
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro