WebBrowser.Navigating Gebeurtenis
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Vindt plaats voordat het WebBrowser besturingselement naar een nieuw document navigeert.
public:
event System::Windows::Forms::WebBrowserNavigatingEventHandler ^ Navigating;public event System.Windows.Forms.WebBrowserNavigatingEventHandler Navigating;public event System.Windows.Forms.WebBrowserNavigatingEventHandler? Navigating;member this.Navigating : System.Windows.Forms.WebBrowserNavigatingEventHandler Public Custom Event Navigating As WebBrowserNavigatingEventHandler Public Event Navigating As WebBrowserNavigatingEventHandler Gebeurtenistype
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u een handler gebruikt voor de Navigating gebeurtenis om navigatie te annuleren wanneer een webpaginaformulier niet is ingevuld. De Document eigenschap wordt gebruikt om te bepalen of het invoerveld van het formulier een waarde bevat.
In dit voorbeeld is vereist dat uw formulier een WebBrowser besturingselement bevat dat wordt aangeroepen webBrowser1 en dat uw formulierklasse ComVisibleAttribute het toegankelijk maakt voor COM.
Zie Hoe to: Web Browser Capabilities toevoegen aan een Windows Forms Application voor een volledig codevoorbeeld waarnaar u de volgende code kunt plakken.
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
Opmerkingen
Het WebBrowser besturingselement navigeert naar een nieuw document wanneer een van de volgende eigenschappen is ingesteld of methoden wordt aangeroepen:
U kunt de Navigating gebeurtenis afhandelen om navigatie te annuleren als aan bepaalde voorwaarden niet is voldaan, bijvoorbeeld wanneer de gebruiker een formulier niet volledig heeft ingevuld. Als u de navigatie wilt annuleren, stelt u de Cancel eigenschap van het WebBrowserNavigatingEventArgs object in dat aan de gebeurtenis-handler is doorgegeven.true U kunt dit object ook gebruiken om de URL van het nieuwe document op te halen via de WebBrowserNavigatingEventArgs.Url eigenschap. Als het nieuwe document wordt weergegeven in een webpaginaframe, kunt u de naam van het frame ophalen via de WebBrowserNavigatingEventArgs.TargetFrameName eigenschap.
Navigated De gebeurtenis verwerken om een melding te ontvangen wanneer het besturingselement de WebBrowser navigatie voltooit en het document op de nieuwe locatie is geladen. DocumentCompleted De gebeurtenis verwerken om een melding te ontvangen wanneer het besturingselement klaar is met het WebBrowser laden van het nieuwe document.
Zie Gebeurtenissen verwerken en genereren voor meer informatie over het afhandelen van gebeurtenissen.
