WebBrowser.Refresh Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Ponownie ładuje dokument wyświetlany obecnie w kontrolce WebBrowser .

Przeciążenia

Refresh()	Ponownie ładuje dokument wyświetlany obecnie w kontrolce WebBrowser , sprawdzając serwer pod kątem zaktualizowanej wersji.
Refresh(WebBrowserRefreshOption)	Ponownie ładuje dokument wyświetlany obecnie w kontrolce WebBrowser przy użyciu określonych opcji odświeżania.

Refresh()

Ponownie ładuje dokument wyświetlany obecnie w kontrolce WebBrowser , sprawdzając serwer pod kątem zaktualizowanej wersji.

public:
 override void Refresh();

public override void Refresh ();

override this.Refresh : unit -> unit

Public Overrides Sub Refresh ()

Przykłady

W poniższym przykładzie kodu pokazano, jak za pomocą Refresh metody zaimplementować przycisk Odśwież dla WebBrowser kontrolki podobnej do tej w programie Internet Explorer. Ten przykład wymaga, aby formularz zawierał kontrolkę WebBrowser o nazwie webBrowser1 i kontrolkę Button o nazwie ButtonRefresh.

Pełny przykład kodu można znaleźć w temacie How to: Add Web Browser Capabilities to a Windows Forms Application (Instrukcje: dodawanie funkcji przeglądarki internetowej do aplikacji Windows Forms).

// Reloads the current page.
void ButtonRefresh_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   
   // Skip refresh if about:blank is loaded to avoid removing
   // content specified by the DocumentText property.
   if (  !this->WebBrowser1->Url->Equals( "about:blank" ) )
   {
      this->WebBrowser1->Refresh();
   }
}

// Reloads the current page.
private void refreshButton_Click(object sender, EventArgs e)
{
    // Skip refresh if about:blank is loaded to avoid removing
    // content specified by the DocumentText property.
    if (!webBrowser1.Url.Equals("about:blank"))
    {
        webBrowser1.Refresh();
    }
}

' Reloads the current page.
Private Sub refreshButton_Click( _
    ByVal sender As Object, ByVal e As EventArgs) _
    Handles refreshButton.Click

    ' Skip refresh if about:blank is loaded to avoid removing
    ' content specified by the DocumentText property.
    If Not webBrowser1.Url.Equals("about:blank") Then
        webBrowser1.Refresh()
    End If

End Sub

Uwagi

Kontrolka WebBrowser przechowuje strony sieci Web z ostatnio odwiedzanych witryn w pamięci podręcznej na lokalnym dysku twardym. Każda strona może określić datę wygaśnięcia wskazującą, jak długo pozostanie w pamięci podręcznej. Gdy kontrolka przechodzi do strony, oszczędza czas, wyświetlając wersję z pamięci podręcznej, jeśli jest dostępna, zamiast ponownie pobierać stronę. Metoda Refresh wymusza WebBrowser ponowne załadowanie bieżącej strony przez pobranie kontrolki, zapewniając, że kontrolka wyświetla najnowszą wersję. Za pomocą tej metody można zaimplementować przycisk Odśwież podobny do tego w programie Internet Explorer.

Uwaga

Odświeżanie dokumentu po prostu ponownie ładuje bieżącą stronę, więc Navigatingzdarzenia , Navigatedi DocumentCompleted nie występują podczas wywoływania Refresh metody .

Zobacz też

• GoBack()
• GoForward()
• GoHome()
• GoSearch()
• Stop()

Refresh(WebBrowserRefreshOption)

Ponownie ładuje dokument wyświetlany obecnie w kontrolce WebBrowser przy użyciu określonych opcji odświeżania.

public:
 void Refresh(System::Windows::Forms::WebBrowserRefreshOption opt);

public void Refresh (System.Windows.Forms.WebBrowserRefreshOption opt);

override this.Refresh : System.Windows.Forms.WebBrowserRefreshOption -> unit

Public Sub Refresh (opt As WebBrowserRefreshOption)

Parametry

opt

WebBrowserRefreshOption

Jedna z WebBrowserRefreshOption wartości.

Uwagi

Kontrolka WebBrowser przechowuje ostatnio odwiedzane strony sieci Web w pamięci podręcznej na lokalnym dysku twardym. Każda strona może określić datę wygaśnięcia wskazującą, jak długo pozostanie w pamięci podręcznej. Gdy kontrolka przechodzi do strony, oszczędza czas, wyświetlając wersję z pamięci podręcznej, jeśli jest dostępna, zamiast ponownie pobierać stronę. Metoda Refresh wymusza ponowne załadowanie WebBrowser bieżącej strony przez kontrolkę. Typ ponownego WebBrowserRefreshOption ładowania zależy od określonej wartości. Jeśli wywołasz metodę Refresh z wartością WebBrowserRefreshOption.Completely , zostanie pobrana najnowsza wersja dokumentu. Jeśli używasz wartości, najnowsza WebBrowserRefreshOption.IfExpired wersja zostanie pobrana tylko wtedy, gdy bieżący dokument wygasł. Jeśli używasz WebBrowserRefreshOption.Normal wartości, serwer wysyła kopię dokumentu przechowywanego we własnej pamięci podręcznej.

Uwaga

Odświeżanie dokumentu po prostu ponownie ładuje bieżącą stronę, więc Navigatingzdarzenia , Navigatedi DocumentCompleted nie występują podczas wywoływania Refresh metody .

Zobacz też

• GoBack()
• GoForward()
• GoHome()
• GoSearch()
• Stop()