WebBrowser.Navigate Metódus

Definíció

Névtér:: System.Windows.Forms

Szerelvény:: System.Windows.Forms.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Betölti a dokumentumot a megadott helyen a WebBrowser vezérlőbe.

Túlterhelések

Name	Description
Navigate(Uri, String, Byte[], String)	Betölti a dokumentumot a megadott Uri helyen a WebBrowser vezérlőbe, a megadott HTTP-adatokkal kéri le, és a weblapkeret tartalmát lecseréli a megadott névre.
Navigate(String, String, Byte[], String)	Betölti a dokumentumot a megadott Uniform Resource Locator (URL) vezérlőbe WebBrowser , a megadott HTTP-adatokkal kéri, és a weblapkeret tartalmát lecseréli a megadott névre.
Navigate(Uri, Boolean)	Betölti a dokumentumot a megadott Uri helyen egy új böngészőablakba vagy a WebBrowser vezérlőbe.
Navigate(Uri, String)	Betölti a dokumentumot a megadott Uri helyen a WebBrowser vezérlőbe, és lecseréli a weblapkeret tartalmát a megadott névre.
Navigate(String, Boolean)	Betölti a dokumentumot a megadott egységes erőforrás-keresőben (URL-cím) egy új böngészőablakba vagy a WebBrowser vezérlőbe.
Navigate(String, String)	Betölti a dokumentumot a megadott egységes erőforrás-keresőben (URL-cím) a WebBrowser vezérlőbe, és lecseréli a weblapkeret tartalmát a megadott névre.
Navigate(Uri)	Betölti a dokumentumot a megadott Uri helyen a WebBrowser vezérlőbe, lecserélve az előző dokumentumot.
Navigate(String)	Betölti a dokumentumot a megadott egységes erőforrás-keresőben (URL- cím) a WebBrowser vezérlőbe, lecserélve az előző dokumentumot.

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

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Betölti a dokumentumot a megadott Uri helyen a WebBrowser vezérlőbe, a megadott HTTP-adatokkal kéri le, és a weblapkeret tartalmát lecseréli a megadott névre.

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)

Paraméterek

url: Uri

A Uri betöltendő dokumentum URL-címét jelöli.

targetFrameName: String

Annak a keretnek a neve, amelyben be szeretné tölteni a dokumentumot.

postData: Byte[]

HTTP POST-adatok, például űrlapadatok.

additionalHeaders: String

AZ alapértelmezett fejlécekhez hozzáadni kívánt HTTP-fejlécek.

Kivételek

ObjectDisposedException

Ez WebBrowser a példány már nem érvényes.

InvalidOperationException

Az interfész implementációjára IWebBrowser2 mutató hivatkozás nem kérhető le az alapul szolgáló ActiveX-vezérlőből WebBrowser .

ArgumentException

A url paraméter értéke nem jelent abszolút URI-t. További információért lásd IsAbsoluteUri.

Megjegyzések

A WebBrowser vezérlő megőrzi a böngészési munkamenet során meglátogatott összes weblap előzménylistáját. Amikor ezt a túlterhelést hívja, a vezérlő betölti WebBrowser a dokumentumot a megadott URI-n a megadott névvel rendelkező weblapkeretbe, és hozzáadja az URI-t az előzmények listájának végéhez. Ha a megadott keretnév érvénytelen, a rendszer betölti a dokumentumot egy új Internet Explorer ablakba.

Ezzel a GoBack módszerrel a vezérlőelemet visszajuttathatja a navigációs előzmények egy korábbi lapjára. Ezzel a GoForward módszerrel visszatérhet a navigációs előzmények egy későbbi lapjára, miután visszafelé navigált.

A WebBrowser vezérlő a legutóbb meglátogatott webhelyekről származó weblapokat a helyi merevlemez gyorsítótárában tárolja. Minden oldal megadhat egy lejárati dátumot, amely jelzi, hogy mennyi ideig marad a gyorsítótárban. Amikor a vezérlő egy lapra navigál, azzal időt takarít meg, ha egy gyorsítótárazott verziót jelenít meg, ha van ilyen, ahelyett, hogy újra letöltené a lapot. Ezzel a Refresh módszerrel kényszerítheti a vezérlőt az WebBrowser aktuális lap újratöltésére letöltéssel, biztosítva, hogy a vezérlő a legújabb verziót jelentesse meg.

Lásd még

A következőre érvényes:

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

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Betölti a dokumentumot a megadott Uniform Resource Locator (URL) vezérlőbe WebBrowser , a megadott HTTP-adatokkal kéri, és a weblapkeret tartalmát lecseréli a megadott névre.

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)

Paraméterek

urlString: String

A betöltendő dokumentum URL-címe.

targetFrameName: String

Annak a keretnek a neve, amelyben be szeretné tölteni a dokumentumot.

postData: Byte[]

HTTP POST-adatok, például űrlapadatok.

additionalHeaders: String

AZ alapértelmezett fejlécekhez hozzáadni kívánt HTTP-fejlécek.

Kivételek

ObjectDisposedException

Ez WebBrowser a példány már nem érvényes.

InvalidOperationException

Az interfész implementációjára IWebBrowser2 mutató hivatkozás nem kérhető le az alapul szolgáló ActiveX-vezérlőből WebBrowser .

Megjegyzések

Lásd még

A következőre érvényes:

Navigate(Uri, Boolean)

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Betölti a dokumentumot a megadott Uri helyen egy új böngészőablakba vagy a WebBrowser vezérlőbe.

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)

Paraméterek

url: Uri

A Uri betöltendő dokumentum URL-címét jelöli.

newWindow: Boolean

true a dokumentum betöltése egy új böngészőablakba; false a dokumentumot a vezérlőbe való betöltéséhez WebBrowser .

Kivételek

ObjectDisposedException

Ez WebBrowser a példány már nem érvényes.

InvalidOperationException

Az interfész implementációjára IWebBrowser2 mutató hivatkozás nem kérhető le az alapul szolgáló ActiveX-vezérlőből WebBrowser .

ArgumentException

A url paraméter értéke nem jelent abszolút URI-t. További információért lásd IsAbsoluteUri.

Megjegyzések

A WebBrowser vezérlő megőrzi a böngészési munkamenet során meglátogatott összes weblap előzménylistáját. Ha ezt a túlterhelést newWindow paraméterértékkel falsehívja meg, a vezérlő normál esetben a megadott URI-ra lép, és hozzáadja az URI-t az előzménylista végéhez. Ha ezt a túlterhelést newWindowtrue paraméterértékkel hívja meg, a WebBrowser vezérlő betölti a dokumentumot a megadott URI-n egy új Internet Explorer ablakba, amely saját navigációs előzményeket tart fenn. Az eseményt úgy kezelheti, NewWindow hogy értesítést kapjon egy új böngészőablak megnyitása előtt, így szükség esetén megszakíthatja a műveletet.

A WebBrowser vezérlő a legutóbb meglátogatott webhelyekről származó weblapokat a helyi merevlemez gyorsítótárában tárolja. Minden oldal megadhat egy lejárati dátumot, amely jelzi, hogy mennyi ideig marad a gyorsítótárban. Amikor a vezérlő egy lapra navigál, vagy betölt egy lapot egy külön böngészőablakba, azzal időt takarít meg, ha megjelenik egy gyorsítótárazott verzió, ha van ilyen, ahelyett, hogy újra letöltené az oldalt. Ezzel a Refresh módszerrel kényszerítheti a vezérlőt az WebBrowser aktuális lap újratöltésére letöltéssel, biztosítva, hogy a vezérlő a legújabb verziót jelentesse meg. Ha egy lapot egy külön Internet Explorer ablakba tölt be, a felhasználó a Refresh gombra kattintva lekérheti a legújabb verziót.

Lásd még

A következőre érvényes:

Navigate(Uri, String)

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Betölti a dokumentumot a megadott Uri helyen a WebBrowser vezérlőbe, és lecseréli a weblapkeret tartalmát a megadott névre.

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)

Paraméterek

url: Uri

A Uri betöltendő dokumentum URL-címét jelöli.

targetFrameName: String

Annak a keretnek a neve, amelyben be szeretné tölteni a dokumentumot.

Kivételek

ObjectDisposedException

Ez WebBrowser a példány már nem érvényes.

InvalidOperationException

Az interfész implementációjára IWebBrowser2 mutató hivatkozás nem kérhető le az alapul szolgáló ActiveX-vezérlőből WebBrowser .

ArgumentException

A url paraméter értéke nem jelent abszolút URI-t. További információért lásd IsAbsoluteUri.

Megjegyzések

Lásd még

A következőre érvényes:

Navigate(String, Boolean)

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Betölti a dokumentumot a megadott egységes erőforrás-keresőben (URL-cím) egy új böngészőablakba vagy a WebBrowser vezérlőbe.

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)

Paraméterek

urlString: String

A betöltendő dokumentum URL-címe.

newWindow: Boolean

true a dokumentum betöltése egy új böngészőablakba; false a dokumentumot a vezérlőbe való betöltéséhez WebBrowser .

Kivételek

ObjectDisposedException

Ez WebBrowser a példány már nem érvényes.

InvalidOperationException

Az interfész implementációjára IWebBrowser2 mutató hivatkozás nem kérhető le az alapul szolgáló ActiveX-vezérlőből WebBrowser .

Megjegyzések

A WebBrowser vezérlő a legutóbb meglátogatott webhelyekről származó weblapokat a helyi merevlemez gyorsítótárában tárolja. Minden oldal megadhat egy lejárati dátumot, amely jelzi, hogy mennyi ideig marad a gyorsítótárban. Amikor a vezérlő egy lapra navigál, vagy betölt egy lapot egy külön böngészőablakba, azzal időt takarít meg, ha megjelenik egy gyorsítótárazott verzió, ha van ilyen, ahelyett, hogy újra letöltené az oldalt. Ezzel a Refresh módszerrel kényszerítheti a vezérlőt az WebBrowser aktuális lap újratöltésére letöltéssel, biztosítva, hogy a vezérlő a legújabb verziót jelentesse meg. Ha egy lapot egy külön Internet Explorer ablakba tölt be, a felhasználó a Refresh gombra kattintva lekérheti a legújabb verziót.

Lásd még

A következőre érvényes:

Navigate(String, String)

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Betölti a dokumentumot a megadott egységes erőforrás-keresőben (URL-cím) a WebBrowser vezérlőbe, és lecseréli a weblapkeret tartalmát a megadott névre.

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)

Paraméterek

urlString: String

A betöltendő dokumentum URL-címe.

targetFrameName: String

Annak a keretnek a neve, amelyben be szeretné tölteni a dokumentumot.

Kivételek

ObjectDisposedException

Ez WebBrowser a példány már nem érvényes.

InvalidOperationException

Az interfész implementációjára IWebBrowser2 mutató hivatkozás nem kérhető le az alapul szolgáló ActiveX-vezérlőből WebBrowser .

Megjegyzések

Lásd még

A következőre érvényes:

Navigate(Uri)

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Betölti a dokumentumot a megadott Uri helyen a WebBrowser vezérlőbe, lecserélve az előző dokumentumot.

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)

Paraméterek

url: Uri

A Uri betöltendő dokumentum URL-címét jelöli.

Kivételek

ObjectDisposedException

Ez WebBrowser a példány már nem érvényes.

InvalidOperationException

Az interfész implementációjára IWebBrowser2 mutató hivatkozás nem kérhető le az alapul szolgáló ActiveX-vezérlőből WebBrowser .

ArgumentException

A url paraméter értéke nem jelent abszolút URI-t. További információért lásd IsAbsoluteUri.

Példák

Az alábbi példakód bemutatja, hogyan lehet a Navigate metódust használni egy címsor implementálásához a WebBrowser vezérlőhöz. Ez a példa megköveteli, hogy az űrlap egy WebBrowser úgynevezett webBrowser1vezérlőelemet, egy TextBox úgynevezett TextBoxAddressvezérlőelemet és egy úgynevezett Buttonvezérlőelemet ButtonGo tartalmaz. Amikor beír egy URL-címet a szövegmezőbe, és nyomja le az ENTER billentyűt, vagy kattintson az Ugrás gombra, a vezérlő a WebBrowser megadott URL-címre navigál. Ha egy hivatkozásra kattintva navigál, a szövegmező automatikusan frissül az aktuális URL-cím megjelenítéséhez.

A teljes kódpéldáért lásd: Hogyan is: Webböngésző-képességek hozzáadása Windows Forms alkalmazáshoz.

// 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

Megjegyzések

A WebBrowser vezérlő megőrzi a böngészési munkamenet során meglátogatott összes weblap előzménylistáját. Amikor ezt a túlterhelést hívja, a WebBrowser vezérlő a megadott URI-ra lép, és hozzáadja az előzmények listájának végéhez. Ezzel a GoBack módszerrel a vezérlőelemet visszajuttathatja a navigációs előzmények egy korábbi lapjára. Ezzel a GoForward módszerrel visszatérhet a navigációs előzmények egy későbbi lapjára, miután visszafelé navigált.

A Navigate metódus használatával a Internet Explorer-ben használthoz hasonló címsort implementálhat.

Lásd még

A következőre érvényes:

Navigate(String)

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Forrás:: WebBrowser.cs

Betölti a dokumentumot a megadott egységes erőforrás-keresőben (URL- cím) a WebBrowser vezérlőbe, lecserélve az előző dokumentumot.

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

public void Navigate(string urlString);

member this.Navigate : string -> unit

Public Sub Navigate (urlString As String)

Paraméterek

urlString: String

A betöltendő dokumentum URL-címe.

Kivételek

ObjectDisposedException

Ez WebBrowser a példány már nem érvényes.

InvalidOperationException

Az interfész implementációjára IWebBrowser2 mutató hivatkozás nem kérhető le az alapul szolgáló ActiveX-vezérlőből WebBrowser .

Megjegyzések

A Navigate metódus használatával a Internet Explorer-ben használthoz hasonló címsort implementálhat.

Lásd még

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?