WebBrowser.Url Proprietà

Definizione

Ottiene o imposta l'URL del documento corrente.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; }
[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.WebBrowserUriTypeConverter))>]
member this.Url : Uri with get, set
Public Property Url As Uri

Valore della proprietà

Uri

Uri che rappresenta l'URL del documento corrente.A Uri representing the URL of the current document.

Attributi

Eccezioni

Questa istanza di WebBrowser non è più valida.This WebBrowser instance is no longer valid.

Non è stato possibile recuperare un riferimento a un'implementazione dell'interfaccia IWebBrowser2 dal controllo ActiveX WebBrowser sottostante.A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

Il valore specificato al momento dell'impostazione della proprietà non è un URI assoluto.The specified value when setting this property is not an absolute URI. Per altre informazioni, vedere IsAbsoluteUri.For more information, see IsAbsoluteUri.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare la Url proprietà per implementare una barra degli indirizzi per il WebBrowser controllo.The following code example demonstrates how to use the Url property to implement an address bar for the WebBrowser control. Questo esempio richiede che il form contenga un WebBrowser controllo denominato webBrowser1 , un TextBox controllo denominato TextBoxAddress e un Button controllo denominato ButtonGo .This example requires that your form contains a WebBrowser control called webBrowser1, a TextBox control called TextBoxAddress, and a Button control called ButtonGo. Quando si digita un URL nella casella di testo e si preme INVIO o si fa clic sul pulsante Vai , il WebBrowser controllo passa all'URL specificato.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. Quando si esegue la navigazione facendo clic su un collegamento ipertestuale, la casella di testo viene aggiornata automaticamente per visualizzare l'URL corrente.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

Commenti

L'impostazione di questa proprietà equivale alla chiamata al Navigate metodo e al passaggio dell'URL specificato.Setting this property is equivalent to calling the Navigate method and passing it the specified URL.

Il WebBrowser controllo gestisce un elenco di cronologia di tutte le pagine Web visitate durante una sessione di esplorazione.The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. Quando si imposta la Url proprietà, il WebBrowser controllo si sposta sull'URL specificato e lo aggiunge alla fine dell'elenco della cronologia.When you set the Url property, the WebBrowser control navigates to the specified URL and adds it to the end of the history list.

Il WebBrowser controllo archivia le pagine Web da siti visitati di recente in una cache sul disco rigido locale.The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Ogni pagina può specificare una data di scadenza che indica per quanto tempo rimarrà nella cache.Each page can specify an expiration date indicating how long it will remain in the cache. Quando il controllo passa a una pagina, consente di risparmiare tempo visualizzando una versione memorizzata nella cache, se disponibile, anziché scaricare di nuovo la pagina.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. Usare il Refresh metodo per forzare il WebBrowser controllo per ricaricare la pagina corrente scaricando il controllo, assicurando che il controllo visualizzi la versione più recente.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.

Nota

Questa proprietà contiene l'URL del documento corrente, anche se è stato richiesto un altro documento.This property contains the URL of the current document, even if another document has been requested. Se si imposta il valore di questa proprietà e quindi lo si recupera immediatamente, il valore recuperato può essere diverso dal valore impostato se il WebBrowser controllo non ha avuto tempo per caricare il nuovo documento.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. È possibile recuperare il nuovo valore in un DocumentCompleted gestore eventi.You can retrieve the new value in a DocumentCompleted event handler.

Si applica a

Vedi anche