WebBrowser.Refresh Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
S’applique à
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
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.