WebBrowser.Refresh WebBrowser.Refresh WebBrowser.Refresh WebBrowser.Refresh Method

Définition

Recharge le document affiché actuellement dans le contrôle WebBrowser.Reloads the document currently displayed in the WebBrowser control.

Surcharges

Refresh() Refresh() Refresh() Refresh()

Recharge le document affiché actuellement dans le contrôle WebBrowser en recherchant sur le serveur une version à jour.Reloads the document currently displayed in the WebBrowser control by checking the server for an updated version.

Refresh(WebBrowserRefreshOption) Refresh(WebBrowserRefreshOption) Refresh(WebBrowserRefreshOption) Refresh(WebBrowserRefreshOption)

Recharge le document affiché actuellement dans le contrôle WebBrowser à l'aide des options d'actualisation spécifiées.Reloads the document currently displayed in the WebBrowser control using the specified refresh options.

Refresh() Refresh() Refresh() Refresh()

Recharge le document affiché actuellement dans le contrôle WebBrowser en recherchant sur le serveur une version à jour.Reloads the document currently displayed in the WebBrowser control by checking the server for an updated version.

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 d' actualisation pour le WebBrowser contrôle semblable à celui d’Internet Explorer.The following code example demonstrates how to use the Refresh method to implement a Refresh button for the WebBrowser control similar to the one in Internet Explorer. Cet exemple suppose que votre formulaire contient un WebBrowser contrôle nommé webBrowser1 et un Button contrôle appelé ButtonRefresh.This example requires that your form contains a WebBrowser control called webBrowser1 and a Button control called ButtonRefresh.

Pour obtenir un exemple de code complet , consultez Procédure: Ajoutez des fonctionnalités de navigateur Web à uneapplication Windows Forms.For the complete code example, see How to: Add Web Browser Capabilities to a Windows Forms Application.

// 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.The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Chaque page peut spécifier une date d’expiration indiquant la durée pendant laquelle elle sera conservée dans le cache.Each page can specify an expiration date indicating how long it will remain in the cache. Lorsque le contrôle navigue vers une page, il fait gagner du temps en affichant une version mise en cache, si elle est disponible, au lieu de télécharger à nouveau la page.When the control navigates to a page, it saves time by displaying a cached version, if one is available, rather than downloading the page again. La Refresh méthode force le WebBrowser contrôle à recharger la page actuelle en la téléchargeant, en veillant à ce que le contrôle affiche la version la plus récente.The Refresh method forces the WebBrowser control to reload the current page by downloading it, ensuring that the control displays the latest version. Vous pouvez utiliser cette méthode pour implémenter un bouton d' actualisation semblable à celui d’Internet Explorer.You can use this method to implement a Refresh button similar to the one in Internet Explorer.

Notes

L’actualisation d’un document recharge simplement la page active, donc Navigatingles Navigatedévénements, DocumentCompleted et ne se produisent pas quand vous appelez Refresh la méthode.A document refresh simply reloads the current page, so the Navigating, Navigated, and DocumentCompleted events do not occur when you call the Refresh method.

Sécurité

SecurityPermission
pour que les appelants immédiats utilisent ce contrôle.for immediate callers to use this control. Valeur de la LinkDemanddemande:; Jeux d’autorisations nommés: FullTrust.Demand value: LinkDemand; Named Permission Sets: FullTrust.

Voir aussi

Refresh(WebBrowserRefreshOption) Refresh(WebBrowserRefreshOption) Refresh(WebBrowserRefreshOption) Refresh(WebBrowserRefreshOption)

Recharge le document affiché actuellement dans le contrôle WebBrowser à l'aide des options d'actualisation spécifiées.Reloads the document currently displayed in the WebBrowser control using the specified refresh options.

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

Remarques

Le WebBrowser contrôle stocke les pages Web récemment visitées dans un cache sur le disque dur local.The WebBrowser control stores recently visited Web pages in a cache on the local hard disk. Chaque page peut spécifier une date d’expiration indiquant la durée pendant laquelle elle sera conservée dans le cache.Each page can specify an expiration date indicating how long it will remain in the cache. Lorsque le contrôle navigue vers une page, il fait gagner du temps en affichant une version mise en cache, si elle est disponible, au lieu de télécharger à nouveau la page.When the control navigates to a page, it saves time by displaying a cached version, if one is available, rather than downloading the page again. La Refresh méthode force le WebBrowser contrôle à recharger la page actuelle.The Refresh method forces the WebBrowser control to reload the current page. Le type de rechargement dépend de WebBrowserRefreshOption la valeur spécifiée.The type of reload depends on the WebBrowserRefreshOption value specified. Si vous appelez la Refresh méthode avec la WebBrowserRefreshOption.Completely valeur, la version la plus récente du document est téléchargée.If you call the Refresh method with the WebBrowserRefreshOption.Completely value, the latest version of the document is downloaded. Si vous utilisez la WebBrowserRefreshOption.IfExpired valeur, la version la plus récente est téléchargée uniquement si le document actif a expiré.If you use the WebBrowserRefreshOption.IfExpired value, the latest version is downloaded only if the current document has expired. Si vous utilisez la WebBrowserRefreshOption.Normal valeur, le serveur envoie une copie du document stocké dans son propre cache.If you use the WebBrowserRefreshOption.Normal value, the server sends a copy of the document stored in its own cache.

Notes

L’actualisation d’un document recharge simplement la page active, donc Navigatingles Navigatedévénements, DocumentCompleted et ne se produisent pas quand vous appelez Refresh la méthode.A document refresh simply reloads the current page, so the Navigating, Navigated, and DocumentCompleted events do not occur when you call the Refresh method.

Sécurité

SecurityPermission
pour que les appelants immédiats utilisent ce contrôle.for immediate callers to use this control. Valeur de la LinkDemanddemande:; Jeux d’autorisations nommés: FullTrust.Demand value: LinkDemand; Named Permission Sets: FullTrust.

Voir aussi

S’applique à