WebBrowser.Refresh Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Recharge le document affiché actuellement dans le contrôle WebBrowser.

Surcharges

Refresh()	Recharge le document affiché actuellement dans le contrôle WebBrowser en recherchant sur le serveur une version à jour.
Refresh(WebBrowserRefreshOption)	Recharge le document affiché actuellement dans le contrôle WebBrowser à l'aide des options d'actualisation spécifiées.

Refresh()

Recharge le document affiché actuellement dans le contrôle WebBrowser en recherchant sur le serveur une version à jour.

public:
 override void Refresh();

public override void Refresh ();

override this.Refresh : unit -> unit

Public Overrides Sub Refresh ()

Exemples

L’exemple de code suivant montre comment utiliser la Refresh méthode pour implémenter un bouton Actualiser pour le WebBrowser contrôle similaire à celui d’Internet Explorer. Cet exemple nécessite que votre formulaire contienne un WebBrowser contrôle appelé webBrowser1 et un Button contrôle appelé ButtonRefresh.

Pour obtenir l’exemple de code complet, consultez Guide pratique pour ajouter des fonctionnalités de navigateur web à une application 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

Remarques

Le WebBrowser contrôle stocke les pages Web des sites récemment visités dans un cache sur le disque dur local. Chaque page peut spécifier une date d’expiration indiquant la durée pendant laquelle elle restera dans le cache. Lorsque le contrôle accède à une page, il gagne du temps en affichant une version mise en cache, le cas échéant, au lieu de télécharger à nouveau la page. La Refresh méthode force le WebBrowser contrôle à recharger la page active en la téléchargeant, ce qui garantit que le contrôle affiche la dernière version. Vous pouvez utiliser cette méthode pour implémenter un bouton Actualiser similaire à celui d’Internet Explorer.

Notes

Une actualisation de document recharge simplement la page active, de sorte que les Navigatingévénements , Navigatedet DocumentCompleted ne se produisent pas lorsque vous appelez la Refresh méthode.

Voir aussi

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

Refresh(WebBrowserRefreshOption)

Recharge le document affiché actuellement dans le contrôle WebBrowser à l'aide des options d'actualisation spécifiées.

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)

Paramètres

opt

WebBrowserRefreshOption

Une des valeurs de l'objet WebBrowserRefreshOption.

Remarques

Le WebBrowser contrôle stocke les pages Web récemment visitées dans un cache sur le disque dur local. Chaque page peut spécifier une date d’expiration indiquant la durée pendant laquelle elle restera dans le cache. Lorsque le contrôle accède à une page, il gagne du temps en affichant une version mise en cache, le cas échéant, au lieu de télécharger à nouveau la page. La Refresh méthode force le WebBrowser contrôle à recharger la page active. Le type de rechargement dépend de la WebBrowserRefreshOption valeur spécifiée. Si vous appelez la Refresh méthode avec la WebBrowserRefreshOption.Completely valeur, la dernière version du document est téléchargée. Si vous utilisez la WebBrowserRefreshOption.IfExpired valeur, la dernière version est téléchargée uniquement si le document actuel a expiré. Si vous utilisez la WebBrowserRefreshOption.Normal valeur, le serveur envoie une copie du document stocké dans son propre cache.

Notes

Une actualisation de document recharge simplement la page active, de sorte que les Navigatingévénements , Navigatedet DocumentCompleted ne se produisent pas lorsque vous appelez la Refresh méthode.

Voir aussi

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