WebBrowser.Url Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Pobiera lub ustawia adres URL bieżącego dokumentu.

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

Wartość właściwości

Uri

Reprezentujący Uri adres URL bieżącego dokumentu.

Atrybuty

BindableAttribute TypeConverterAttribute

Wyjątki

ObjectDisposedException

To WebBrowser wystąpienie nie jest już prawidłowe.

InvalidOperationException

Nie można pobrać odwołania do implementacji interfejsu IWebBrowser2 z bazowej kontrolki ActiveX WebBrowser .

ArgumentException

Określona wartość podczas ustawiania tej właściwości nie jest bezwzględnym identyfikatorem URI. Aby uzyskać więcej informacji, zobacz IsAbsoluteUri.

Przykłady

W poniższym przykładzie kodu pokazano, jak za pomocą Url właściwości zaimplementować pasek adresu dla kontrolki WebBrowser . W tym przykładzie formularz zawiera kontrolkę WebBrowser o nazwie , kontrolkę TextBox o webBrowser1nazwie TextBoxAddressi kontrolkę Button o nazwie ButtonGo. Po wpiseniu adresu URL w polu tekstowym i naciśnięciu klawisza ENTER lub kliknięciu przycisku Przejdź kontrolka WebBrowser przechodzi do określonego adresu URL. Po kliknięciu hiperlinku pole tekstowe jest automatycznie aktualizowane w celu wyświetlenia bieżącego adresu 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

Uwagi

Ustawienie tej właściwości jest równoważne wywołaniu Navigate metody i przekazaniu jej określonego adresu URL.

Kontrolka WebBrowser utrzymuje listę historii wszystkich stron sieci Web odwiedzanych podczas sesji przeglądania. Po ustawieniu właściwości kontrolka UrlWebBrowser przechodzi do określonego adresu URL i dodaje ją na końcu listy historii.

Kontrolka WebBrowser przechowuje strony sieci Web z ostatnio odwiedzanych witryn w pamięci podręcznej na lokalnym dysku twardym. Każda strona może określić datę wygaśnięcia wskazującą, jak długo pozostanie w pamięci podręcznej. Gdy kontrolka przechodzi do strony, oszczędza czas, wyświetlając w pamięci podręcznej wersję, jeśli jest dostępna, zamiast ponownie pobierać stronę. Refresh Użyj metody , aby wymusić WebBrowser ponowne załadowanie bieżącej strony, pobierając ją, upewniając się, że kontrolka wyświetla najnowszą wersję.

Uwaga

Ta właściwość zawiera adres URL bieżącego dokumentu, nawet jeśli zażądano innego dokumentu. Jeśli ustawisz wartość tej właściwości, a następnie natychmiast pobierzesz ją ponownie, pobrana wartość może być inna niż wartość ustawiona, jeśli WebBrowser kontrolka nie miała czasu na załadowanie nowego dokumentu. Nową wartość można pobrać w procedurze obsługi zdarzeń DocumentCompleted .

Zobacz też

• Navigate
• DocumentCompleted
• WebBrowser — Formant
• IWebBrowser2, interfejs