WebBrowserNavigatingEventArgs.TargetFrameName Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets the name of the Web page frame in which the new document will be loaded.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public string TargetFrameName { get; }

Property Value

Type: System.String

The name of the frame in which the new document will be loaded.

The following code example demonstrates the use of this member. In the example, an event handler reports on the occurrence of the WebBrowser.Navigating event. This report helps you to learn when the event occurs and can assist you in debugging. To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

To run the example code, paste it into a project that contains an instance of type WebBrowser named WebBrowser1. Then ensure that the event handler is associated with the WebBrowser.Navigating event.

private void WebBrowser1_Navigating(Object sender, WebBrowserNavigatingEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Url", e.Url );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "TargetFrameName", e.TargetFrameName );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Cancel", e.Cancel );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "Navigating Event" );
}

WebPermission

for accessing the current URL. Associated enumerations: NetworkAccess.Connect

.NET Framework
Available since 2.0
Return to top
Show: