WebBrowser.EncryptionLevelChanged Event

 

Occurs when the WebBrowser control navigates to or away from a Web site that uses encryption.

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

[BrowsableAttribute(false)]
public event EventHandler EncryptionLevelChanged

You can use this event with the EncryptionLevel property to implement an indicator in the user interface of your application similar to the lock icon in Internet Explorer. In a handler for this event, check the value of the EncryptionLevel property to determine whether you should hide or display the indicator. To mimic the behavior of the lock icon in Internet Explorer, you can also provide a ToolTip that shows the encryption level when the mouse pointer hovers over the indicator.

For more information about handling events, see Handling and Raising Events.

The following code example demonstrates the use of this member. In the example, an event handler reports on the occurrence of the EncryptionLevelChanged 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 EncryptionLevelChanged event.

private void WebBrowser1_EncryptionLevelChanged(Object sender, EventArgs e) {

   MessageBox.Show("You are in the WebBrowser.EncryptionLevelChanged event.");

}

SecurityPermission

for immediate callers to use this control. Demand value: LinkDemand; NIB: Named Permission Sets: FullTrust.

.NET Framework
Available since 2.0
Return to top
Show: