WebBrowser.Url WebBrowser.Url WebBrowser.Url WebBrowser.Url Property

Définition

Obtient ou définit l'URL du document actif.Gets or sets the URL of the current document.

public:
 property Uri ^ Url { Uri ^ get(); void set(Uri ^ value); };
[System.ComponentModel.Bindable(true)]
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.WebBrowserUriTypeConverter))]
public Uri Url { get; set; }
member this.Url : Uri with get, set
Public Property Url As Uri

Valeur de propriété

Uri représentant l'URL du document actif.A Uri representing the URL of the current document.

Exceptions

Cette instance de WebBrowser n'est plus valide.This WebBrowser instance is no longer valid.

Une référence à une implémentation de l'interface IWebBrowser2 n'a pas pu être récupérée du contrôle WebBrowser ActiveX sous-jacent.A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

La valeur spécifiée lors de la définition de cette propriété n'est pas un URI absolu.The specified value when setting this property is not an absolute URI. Pour plus d'informations, consultez IsAbsoluteUri.For more information, see IsAbsoluteUri.

Exemples

L’exemple de code suivant montre comment utiliser la Url propriété pour implémenter une barre d’adresses WebBrowser pour le contrôle.The following code example demonstrates how to use the Url property to implement an address bar for the WebBrowser control. Cet exemple suppose que votre formulaire contient un WebBrowser contrôle appelé webBrowser1, un TextBox contrôle TextBoxAddressappelé et un Button contrôle appelé ButtonGo.This example requires that your form contains a WebBrowser control called webBrowser1, a TextBox control called TextBoxAddress, and a Button control called ButtonGo. Lorsque vous tapez une URL dans la zone de texte et appuyez sur entrée ou **** cliquez sur le bouton WebBrowser atteindre, le contrôle navigue vers l’URL spécifiée.When you type a URL into the text box and press ENTER or click the Go button, the WebBrowser control navigates to the URL specified. Lorsque vous naviguez en cliquant sur un lien hypertexte, la zone de texte est automatiquement mise à jour pour afficher l’URL actuelle.When you navigate by clicking a hyperlink, the text box automatically updates to display the current URL.

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

Remarques

La définition de cette propriété revient à appeler Navigate la méthode et à lui transmettre l’URL spécifiée.Setting this property is equivalent to calling the Navigate method and passing it the specified URL.

Le WebBrowser contrôle gère une liste historique de toutes les pages Web visitées pendant une session de navigation.The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. Lorsque vous définissez la Url propriété, le WebBrowser contrôle navigue vers l’URL spécifiée et l’ajoute à la fin de la liste d’historique.When you set the Url property, the WebBrowser control navigates to the specified URL and adds it to the end of the history list.

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. Utilisez la Refresh méthode pour forcer 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.Use the Refresh method to force the WebBrowser control to reload the current page by downloading it, ensuring that the control displays the latest version.

Notes

Cette propriété contient l’URL du document actif, même si un autre document a été demandé.This property contains the URL of the current document, even if another document has been requested. Si vous définissez la valeur de cette propriété, puis la récupérez de nouveau immédiatement, la valeur récupérée peut être différente de la valeur définie WebBrowser si le contrôle n’a pas eu le temps de charger le nouveau document.If you set the value of this property and then immediately retrieve it again, the value retrieved may be different than the value set if the WebBrowser control has not had time to load the new document. Vous pouvez récupérer la nouvelle valeur dans un DocumentCompleted gestionnaire d’événements.You can retrieve the new value in a DocumentCompleted event handler.

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.

S’applique à

Voir aussi