WebBrowser.Url Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

WebBrowser.cs

Возвращает или задает URL-адрес текущего документа.

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

Значение свойства

Uri

Представляет Uri URL-адрес текущего документа.

Атрибуты

BindableAttribute TypeConverterAttribute

Исключения

ObjectDisposedException

Этот WebBrowser экземпляр больше недействителен.

InvalidOperationException

Не удалось получить ссылку на реализацию IWebBrowser2 интерфейса из базового элемента управления ActiveX WebBrowser .

ArgumentException

Указанное значение при задании этого свойства не является абсолютным универсальным кодом ресурса (URI). Дополнительные сведения см. в разделе IsAbsoluteUri.

Примеры

В следующем примере кода показано, как использовать Url свойство для реализации адресной строки элемента WebBrowser управления. В этом примере требуется, чтобы форма содержала WebBrowser элемент управления , TextBox называемый TextBoxAddressэлемент webBrowser1управления, а Button также называемый ButtonGoэлемент управления. При вводе URL-адреса в текстовое поле и нажатии клавиши ВВОД или нажатия кнопки WebBrowserGo элемент управления переходит к указанному URL-адресу. При переходе по гиперссылке текстовое поле автоматически обновляется для отображения текущего 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

Комментарии

Задание этого свойства эквивалентно вызову метода и передаче указанного Navigate URL-адреса.

Элемент WebBrowser управления поддерживает список журналов всех веб-страниц, посещаемых во время сеанса просмотра. При задании Url свойства WebBrowser элемент управления переходит к указанному URL-адресу и добавляет его в конец списка журнала.

Элемент WebBrowser управления сохраняет веб-страницы из недавно посещаемых сайтов в кэше на локальном жестком диске. Каждая страница может указать дату окончания срока действия, указывающую, сколько времени она останется в кэше. Когда элемент управления переходит на страницу, он экономит время, отображая кэшированную версию, если она доступна, а не скачивание страницы снова. Refresh Используйте метод, чтобы принудительно WebBrowser перезагрузить текущую страницу, загрузив его, чтобы элемент управления отображал последнюю версию.

Замечание

Это свойство содержит URL-адрес текущего документа, даже если запрашивается другой документ. Если задать значение этого свойства, а затем сразу же получить его снова, полученное значение может отличаться от значения, заданного, если WebBrowser элемент управления не имел времени для загрузки нового документа. Вы можете получить новое значение в обработчике DocumentCompleted событий.

См. также раздел

• Navigate
• DocumentCompleted
• Элемент управления WebBrowser
• Интерфейс IWebBrowser2