WebBrowser.Url Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Geçerli belgenin URL'sini alır veya ayarlar.

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

Özellik Değeri

Uri

Uri Geçerli belgenin URL'sini temsil eden bir.

Öznitelikler

BindableAttribute TypeConverterAttribute

Özel durumlar

ObjectDisposedException

Bu WebBrowser örnek artık geçerli değil.

InvalidOperationException

Arabirimin bir uygulamasına IWebBrowser2 başvuru, temel alınan ActiveX WebBrowser denetiminden alınamadı.

ArgumentException

Bu özellik ayarlanırken belirtilen değer mutlak bir URI değil. Daha fazla bilgi için bkz. IsAbsoluteUri.

Örnekler

Aşağıdaki kod örneği, denetimin adres çubuğunu uygulamak için WebBrowser özelliğinin nasıl kullanılacağını Url gösterir. Bu örnek, formunuzun adlı bir WebBrowser denetim, adlı webBrowser1bir TextBox denetim ve adlı TextBoxAddressbir denetim içermesini ButtonButtonGogerektirir. Metin kutusuna bir URL yazıp ENTER tuşuna bastığınızda veya Git düğmesine tıkladığınızda, WebBrowser denetim belirtilen URL'ye gider. Köprüye tıklayarak gezindiğinizde, metin kutusu geçerli URL'yi görüntüleyecek şekilde otomatik olarak güncelleştirilir.

// 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

Açıklamalar

Bu özelliğin ayarlanması, yöntemini çağırmak Navigate ve belirtilen URL'yi geçirmekle eşdeğerdir.

Denetim, WebBrowser gözatma oturumu sırasında ziyaret edilen tüm Web sayfalarının geçmiş listesini tutar. Özelliğini ayarladığınızda UrlWebBrowser , denetim belirtilen URL'ye gider ve geçmiş listesinin sonuna ekler.

Denetim, WebBrowser son ziyaret edilen sitelerdeki Web sayfalarını yerel sabit diskteki bir önbellekte depolar. Her sayfa önbellekte ne kadar süre kalacağını belirten bir sona erme tarihi belirtebilir. Denetim bir sayfaya gittiği zaman, sayfayı yeniden indirmek yerine, varsa önbelleğe alınmış bir sürümü görüntüleyerek zaman kazandırır. Denetimi indirerek Refresh geçerli sayfayı yeniden yüklemeye zorlamak WebBrowser ve denetimin en son sürümü görüntülemesini sağlamak için yöntemini kullanın.

Not

Bu özellik, başka bir belge istenmiş olsa bile geçerli belgenin URL'sini içerir. Bu özelliğin değerini ayarlar ve hemen yeniden alırsanız, denetimin yeni belgeyi yüklemek için zamanı yoksa WebBrowser alınan değer ayarlanan değerden farklı olabilir. Yeni değeri bir DocumentCompleted olay işleyicisinde alabilirsiniz.

Ayrıca bkz.

• Navigate
• DocumentCompleted
• WebBrowser Denetimi
• IWebBrowser2 Arabirimi