WebBrowser.Url Свойство

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

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