WebBrowser.Url Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit l'URL du document actif.

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; }

[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.WebBrowserUriTypeConverter))>]
member this.Url : Uri with get, set

Public Property Url As Uri

Valeur de propriété

Uri

Uri représentant l'URL du document actif.

Attributs

BindableAttribute TypeConverterAttribute

Exceptions

ObjectDisposedException

Cette instance de WebBrowser n'est plus valide.

InvalidOperationException

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.

ArgumentException

La valeur spécifiée lors de la définition de cette propriété n'est pas un URI absolu. Pour plus d'informations, consultez IsAbsoluteUri.

Exemples

L’exemple de code suivant montre comment utiliser la Url propriété pour implémenter une barre d’adresse pour le WebBrowser contrôle. Cet exemple nécessite que votre formulaire contienne un WebBrowser contrôle appelé webBrowser1, un TextBox contrôle appelé TextBoxAddresset un Button contrôle appelé ButtonGo. Lorsque vous tapez une URL dans la zone de texte et que vous appuyez sur ENTRÉE ou cliquez sur le bouton Atteindre , le WebBrowser contrôle accède à l’URL spécifiée. Lorsque vous naviguez en cliquant sur un lien hypertexte, la zone de texte est automatiquement mise à jour pour afficher l’URL actuelle.

// 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 la Navigate méthode et à lui transmettre l’URL spécifiée.

Le WebBrowser contrôle conserve une liste d’historique de toutes les pages Web visitées pendant une session de navigation. Lorsque vous définissez la Url propriété, le WebBrowser contrôle accède à l’URL spécifiée et l’ajoute à la fin de la liste d’historique.

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. Utilisez la Refresh méthode pour forcer le WebBrowser contrôle à recharger la page active en la téléchargeant, en vous assurant que le contrôle affiche la dernière version.

Notes

Cette propriété contient l’URL du document actif, même si un autre document a été demandé. Si vous définissez la valeur de cette propriété, puis que vous la récupérez immédiatement, la valeur récupérée peut être différente de la valeur définie si le contrôle n’a pas eu le WebBrowser temps de charger le nouveau document. Vous pouvez récupérer la nouvelle valeur dans un gestionnaire d’événements DocumentCompleted .

Voir aussi

• Navigate
• DocumentCompleted
• WebBrowser, contrôle
• IWebBrowser2, interface