WebBrowserNavigatingEventArgs Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menyediakan data untuk peristiwa tersebut Navigating .
public ref class WebBrowserNavigatingEventArgs : System::ComponentModel::CancelEventArgs
public class WebBrowserNavigatingEventArgs : System.ComponentModel.CancelEventArgs
type WebBrowserNavigatingEventArgs = class
inherit CancelEventArgs
Public Class WebBrowserNavigatingEventArgs
Inherits CancelEventArgs
- Warisan
Contoh
Contoh kode berikut menunjukkan cara menggunakan handler untuk acara guna WebBrowser.Navigating membatalkan navigasi saat formulir halaman Web belum diisi. Properti WebBrowser.Document digunakan untuk menentukan apakah bidang input formulir berisi nilai. Contoh ini mengharuskan formulir Anda berisi kontrol yang WebBrowser disebut webBrowser1
.
private void Form1_Load(object sender, EventArgs e)
{
webBrowser1.DocumentText =
"<html><body>Please enter your name:<br/>" +
"<input type='text' name='userName'/><br/>" +
"<a href='http://www.microsoft.com'>continue</a>" +
"</body></html>";
webBrowser1.Navigating +=
new WebBrowserNavigatingEventHandler(webBrowser1_Navigating);
}
private void webBrowser1_Navigating(object sender,
WebBrowserNavigatingEventArgs e)
{
System.Windows.Forms.HtmlDocument document =
this.webBrowser1.Document;
if (document != null && document.All["userName"] != null &&
String.IsNullOrEmpty(
document.All["userName"].GetAttribute("value")))
{
e.Cancel = true;
System.Windows.Forms.MessageBox.Show(
"You must enter your name before you can navigate to " +
e.Url.ToString());
}
}
Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) _
Handles Me.Load
webBrowser1.DocumentText = _
"<html><body>Please enter your name:<br/>" & _
"<input type='text' name='userName'/><br/>" & _
"<a href='http://www.microsoft.com'>continue</a>" & _
"</body></html>"
End Sub
Private Sub webBrowser1_Navigating( _
ByVal sender As Object, ByVal e As WebBrowserNavigatingEventArgs) _
Handles webBrowser1.Navigating
Dim document As System.Windows.Forms.HtmlDocument = _
webBrowser1.Document
If document IsNot Nothing And _
document.All("userName") IsNot Nothing And _
String.IsNullOrEmpty( _
document.All("userName").GetAttribute("value")) Then
e.Cancel = True
MsgBox("You must enter your name before you can navigate to " & _
e.Url.ToString())
End If
End Sub
Keterangan
Peristiwa WebBrowser.Navigating terjadi sebelum WebBrowser kontrol menavigasi ke dokumen baru. Anda dapat menangani peristiwa ini untuk membatalkan navigasi sebelum dimulai jika kondisi tertentu belum terpenuhi, misalnya, ketika pengguna belum sepenuhnya mengisi formulir. Untuk melakukan ini, atur Cancel properti objek yang WebBrowserNavigatingEventArgs diteruskan ke penanganan aktivitas ke true
. Anda juga dapat menggunakan objek ini untuk mengambil lokasi dokumen baru melalui Url properti . Jika dokumen baru akan ditampilkan dalam bingkai halaman Web, Anda dapat mengambil nama bingkai melalui TargetFrameName properti .
Konstruktor
WebBrowserNavigatingEventArgs(Uri, String) |
Menginisialisasi instans baru kelas WebBrowserNavigatingEventArgs. |
Properti
Cancel |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah acara harus dibatalkan. (Diperoleh dari CancelEventArgs) |
TargetFrameName |
Mendapatkan nama bingkai halaman Web tempat dokumen baru akan dimuat. |
Url |
Mendapatkan lokasi dokumen tempat WebBrowser kontrol menavigasi. |
Metode
Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
GetType() |
Mendapatkan dari instans Type saat ini. (Diperoleh dari Object) |
MemberwiseClone() |
Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object) |
ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |