WebBrowser.Url Properti

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Mendapatkan atau mengatur URL dokumen saat ini.

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

Nilai Properti

Uri

yang Uri mewakili URL dokumen saat ini.

Atribut

BindableAttribute TypeConverterAttribute

Pengecualian

ObjectDisposedException

Instans ini WebBrowser tidak lagi valid.

InvalidOperationException

Referensi ke implementasi IWebBrowser2 antarmuka tidak dapat diambil dari kontrol ActiveX WebBrowser yang mendasar.

ArgumentException

Nilai yang ditentukan saat mengatur properti ini bukan URI absolut. Untuk informasi selengkapnya, lihat IsAbsoluteUri.

Contoh

Contoh kode berikut menunjukkan cara menggunakan Url properti untuk mengimplementasikan bilah alamat untuk WebBrowser kontrol. Contoh ini mengharuskan formulir Anda berisi kontrol yang WebBrowser disebut webBrowser1, kontrol yang TextBox disebut TextBoxAddress, dan kontrol yang Button disebut ButtonGo. Saat Anda mengetik URL ke dalam kotak teks dan menekan ENTER atau klik tombol Buka , WebBrowser kontrol menavigasi ke URL yang ditentukan. Saat Anda menavigasi dengan mengklik hyperlink, kotak teks secara otomatis diperbarui untuk menampilkan URL saat ini.

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

Keterangan

Mengatur properti ini setara dengan memanggil Navigate metode dan meneruskannya ke URL yang ditentukan.

Kontrol WebBrowser mempertahankan daftar riwayat semua halaman Web yang dikunjungi selama sesi penjelajahan. Saat Anda mengatur Url properti , WebBrowser kontrol menavigasi ke URL yang ditentukan dan menambahkannya ke akhir daftar riwayat.

Kontrol WebBrowser menyimpan halaman Web dari situs yang baru-baru ini dikunjungi dalam singgahan pada hard disk lokal. Setiap halaman dapat menentukan tanggal kedaluwarsa yang menunjukkan berapa lama akan tetap berada di cache. Saat kontrol menavigasi ke halaman, kontrol menghemat waktu dengan menampilkan versi yang di-cache, jika tersedia, daripada mengunduh halaman lagi. Refresh Gunakan metode untuk memaksa WebBrowser kontrol memuat ulang halaman saat ini dengan mengunduhnya, memastikan bahwa kontrol menampilkan versi terbaru.

Catatan

Properti ini berisi URL dokumen saat ini, meskipun dokumen lain telah diminta. Jika Anda mengatur nilai properti ini dan kemudian segera mengambilnya lagi, nilai yang diambil mungkin berbeda dari nilai yang ditetapkan jika WebBrowser kontrol belum sempat memuat dokumen baru. Anda dapat mengambil nilai baru dalam DocumentCompleted penanganan aktivitas.

Lihat juga

• Navigate
• DocumentCompleted
• Kontrol WebBrowser
• Antarmuka IWebBrowser2