WebBrowserNavigatingEventArgs Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Navigating olayı için veriler sağlar.
public ref class WebBrowserNavigatingEventArgs : System::ComponentModel::CancelEventArgs
public class WebBrowserNavigatingEventArgs : System.ComponentModel.CancelEventArgs
type WebBrowserNavigatingEventArgs = class
inherit CancelEventArgs
Public Class WebBrowserNavigatingEventArgs
Inherits CancelEventArgs
- Devralma
Örnekler
Aşağıdaki kod örneği, web sayfası formu doldurulmadığında gezintiyi iptal etmek için olay işleyicisinin WebBrowser.Navigating nasıl kullanılacağını gösterir.
WebBrowser.Document özelliği, form giriş alanının bir değer içerip içermediğini belirlemek için kullanılır. Bu örnek, formunuzun adlı webBrowser1
bir WebBrowser denetim içermesi gerekir.
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
Açıklamalar
Olay, WebBrowser.Navigating denetim yeni bir belgeye gitmeden önce WebBrowser gerçekleşir. Belirli koşullar karşılanmadıysa( örneğin, kullanıcı formu tamamen doldurmadığında) gezinti başlamadan önce bu olayı iptal etmek için bu olayı işleyebilirsiniz. Bunu yapmak için olay işleyicisine geçirilen nesnenin WebBrowserNavigatingEventArgs özelliğini olarak true
ayarlayınCancel. Bu nesneyi, özelliği aracılığıyla Url yeni belgenin konumunu almak için de kullanabilirsiniz. Yeni belge bir Web sayfası çerçevesinde görüntülenecekse, özelliği aracılığıyla TargetFrameName çerçevenin adını alabilirsiniz.
Oluşturucular
WebBrowserNavigatingEventArgs(Uri, String) |
WebBrowserNavigatingEventArgs sınıfının yeni bir örneğini başlatır. |
Özellikler
Cancel |
Olayın iptal edilip edilmeyeceğini belirten bir değer alır veya ayarlar. (Devralındığı yer: CancelEventArgs) |
TargetFrameName |
Yeni belgenin yüklendiği Web sayfası çerçevesinin adını alır. |
Url |
Denetimin gezindiği belgenin WebBrowser konumunu alır. |
Yöntemler
Equals(Object) |
Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object) |
GetHashCode() |
Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object) |
GetType() |
Type Geçerli örneğini alır. (Devralındığı yer: Object) |
MemberwiseClone() |
Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object) |
ToString() |
Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object) |