Export (0) Print
Expand All

WebBrowser Class

Enables the user to navigate Web pages inside your form.

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

[ComVisibleAttribute(true)]
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
[DockingAttribute(DockingBehavior.AutoDock)]
[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
[PermissionSetAttribute(SecurityAction.LinkDemand, Name = "FullTrust")]
public class WebBrowser : WebBrowserBase

The WebBrowser type exposes the following members.

  NameDescription
Public methodWebBrowserInitializes a new instance of the WebBrowser class.
Top

  NameDescription
Public propertyAccessibilityObjectGets the AccessibleObject assigned to the control. (Inherited from Control.)
Public propertyAccessibleDefaultActionDescriptionGets or sets the default action description of the control for use by accessibility client applications. (Inherited from Control.)
Public propertyAccessibleDescriptionGets or sets the description of the control used by accessibility client applications. (Inherited from Control.)
Public propertyAccessibleNameGets or sets the name of the control used by accessibility client applications. (Inherited from Control.)
Public propertyAccessibleRoleGets or sets the accessible role of the control (Inherited from Control.)
Public propertyActiveXInstanceInfrastructure. Gets the underlying ActiveX WebBrowser control. (Inherited from WebBrowserBase.)
Public propertyAllowDropInfrastructure. This property is not supported by this control. (Inherited from WebBrowserBase.)
Public propertyAllowNavigationGets or sets a value indicating whether the control can navigate to another page after its initial page has been loaded.
Public propertyAllowWebBrowserDropGets or sets a value indicating whether the WebBrowser control navigates to documents that are dropped onto it.
Public propertyAnchorGets or sets the edges of the container to which a control is bound and determines how a control is resized with its parent. (Inherited from Control.)
Public propertyAutoScrollOffsetGets or sets where this control is scrolled to in ScrollControlIntoView. (Inherited from Control.)
Public propertyAutoSizeInfrastructure. This property is not relevant for this class. (Inherited from Control.)
Public propertyBackColorInfrastructure. This property is not meaningful for this control. (Inherited from WebBrowserBase.)
Public propertyBackgroundImageInfrastructure. This property is not supported by this control. (Inherited from WebBrowserBase.)
Public propertyBackgroundImageLayoutInfrastructure. This property is not supported by this control. (Inherited from WebBrowserBase.)
Public propertyBindingContextGets or sets the BindingContext for the control. (Inherited from Control.)
Public propertyBottomGets the distance, in pixels, between the bottom edge of the control and the top edge of its container's client area. (Inherited from Control.)
Public propertyBoundsGets or sets the size and location of the control including its nonclient elements, in pixels, relative to the parent control. (Inherited from Control.)
Protected propertyCanEnableImeGets a value indicating whether the ImeMode property can be set to an active value, to enable IME support. (Inherited from Control.)
Public propertyCanFocusGets a value indicating whether the control can receive focus. (Inherited from Control.)
Public propertyCanGoBackGets a value indicating whether a previous page in navigation history is available, which allows the GoBack method to succeed.
Public propertyCanGoForwardGets a value indicating whether a subsequent page in navigation history is available, which allows the GoForward method to succeed.
Protected propertyCanRaiseEventsDetermines if events can be raised on the control. (Inherited from Control.)
Public propertyCanSelectGets a value indicating whether the control can be selected. (Inherited from Control.)
Public propertyCaptureGets or sets a value indicating whether the control has captured the mouse. (Inherited from Control.)
Public propertyCausesValidationGets or sets a value indicating whether the control causes validation to be performed on any controls that require validation when it receives focus. (Inherited from Control.)
Public propertyClientRectangleGets the rectangle that represents the client area of the control. (Inherited from Control.)
Public propertyClientSizeGets or sets the height and width of the client area of the control. (Inherited from Control.)
Public propertyCompanyNameGets the name of the company or creator of the application containing the control. (Inherited from Control.)
Public propertyContainerGets the IContainer that contains the Component. (Inherited from Component.)
Public propertyContainsFocusGets a value indicating whether the control, or one of its child controls, currently has the input focus. (Inherited from Control.)
Public propertyContextMenuGets or sets the shortcut menu associated with the control. (Inherited from Control.)
Public propertyContextMenuStripGets or sets the ContextMenuStrip associated with this control. (Inherited from Control.)
Public propertyControlsGets the collection of controls contained within the control. (Inherited from Control.)
Public propertyCreatedGets a value indicating whether the control has been created. (Inherited from Control.)
Protected propertyCreateParamsGets the required creation parameters when the control handle is created. (Inherited from Control.)
Public propertyCursorInfrastructure. This property is not supported by this control. (Inherited from WebBrowserBase.)
Public propertyDataBindingsGets the data bindings for the control. (Inherited from Control.)
Protected propertyDefaultCursorGets or sets the default cursor for the control. (Inherited from Control.)
Protected propertyDefaultImeModeGets the default Input Method Editor (IME) mode supported by the control. (Inherited from Control.)
Protected propertyDefaultMarginGets the space, in pixels, that is specified by default between controls. (Inherited from Control.)
Protected propertyDefaultMaximumSizeGets the length and height, in pixels, that is specified as the default maximum size of a control. (Inherited from Control.)
Protected propertyDefaultMinimumSizeGets the length and height, in pixels, that is specified as the default minimum size of a control. (Inherited from Control.)
Protected propertyDefaultPaddingGets the internal spacing, in pixels, of the contents of a control. (Inherited from Control.)
Protected propertyDefaultSizeGets the default size of the control. (Overrides WebBrowserBase.DefaultSize.)
Protected propertyDesignModeGets a value that indicates whether the Component is currently in design mode. (Inherited from Component.)
Public propertyDisplayRectangleGets the rectangle that represents the display area of the control. (Inherited from Control.)
Public propertyDisposingGets a value indicating whether the base Control class is in the process of disposing. (Inherited from Control.)
Public propertyDockGets or sets which control borders are docked to its parent control and determines how a control is resized with its parent. (Inherited from Control.)
Public propertyDocumentGets an HtmlDocument representing the Web page currently displayed in the WebBrowser control.
Public propertyDocumentStreamGets or sets a stream containing the contents of the Web page displayed in the WebBrowser control.
Public propertyDocumentTextGets or sets the HTML contents of the page displayed in the WebBrowser control.
Public propertyDocumentTitleGets the title of the document currently displayed in the WebBrowser control.
Public propertyDocumentTypeGets the type of the document currently displayed in the WebBrowser control.
Protected propertyDoubleBufferedGets or sets a value indicating whether this control should redraw its surface using a secondary buffer to reduce or prevent flicker. (Inherited from Control.)
Public propertyEnabledInfrastructure. This property is not supported by this control. (Inherited from WebBrowserBase.)
Public propertyEncryptionLevelGets a value indicating the encryption method used by the document currently displayed in the WebBrowser control.
Protected propertyEventsGets the list of event handlers that are attached to this Component. (Inherited from Component.)
Public propertyFocusedGets a value indicating whether the control or any of its child windows has input focus. (Overrides Control.Focused.)
Public propertyFontInfrastructure. This property is not meaningful for this control. (Inherited from WebBrowserBase.)
Protected propertyFontHeightGets or sets the height of the font of the control. (Inherited from Control.)
Public propertyForeColorInfrastructure. This property is not meaningful for this control. (Inherited from WebBrowserBase.)
Public propertyHandleGets the window handle that the control is bound to. (Inherited from Control.)
Public propertyHasChildrenGets a value indicating whether the control contains one or more child controls. (Inherited from Control.)
Public propertyHeightGets or sets the height of the control. (Inherited from Control.)
Public propertyImeModeInfrastructure. This property is not meaningful for this control. (Inherited from WebBrowserBase.)
Protected propertyImeModeBaseGets or sets the IME mode of a control. (Inherited from Control.)
Public propertyInvokeRequiredGets a value indicating whether the caller must call an invoke method when making method calls to the control because the caller is on a different thread than the one the control was created on. (Inherited from Control.)
Public propertyIsAccessibleGets or sets a value indicating whether the control is visible to accessibility applications. (Inherited from Control.)
Public propertyIsBusyGets a value indicating whether the WebBrowser control is currently loading a new document.
Public propertyIsDisposedGets a value indicating whether the control has been disposed of. (Inherited from Control.)
Public propertyIsHandleCreatedGets a value indicating whether the control has a handle associated with it. (Inherited from Control.)
Public propertyIsMirroredGets a value indicating whether the control is mirrored. (Inherited from Control.)
Public propertyIsOfflineGets a value indicating whether the WebBrowser control is in offline mode.
Public propertyIsWebBrowserContextMenuEnabledGets or a sets a value indicating whether the shortcut menu of the WebBrowser control is enabled.
Public propertyLayoutEngineGets a cached instance of the control's layout engine. (Inherited from Control.)
Public propertyLeftGets or sets the distance, in pixels, between the left edge of the control and the left edge of its container's client area. (Inherited from Control.)
Public propertyLocationGets or sets the coordinates of the upper-left corner of the control relative to the upper-left corner of its container. (Inherited from Control.)
Public propertyMarginGets or sets the space between controls. (Inherited from Control.)
Public propertyMaximumSizeGets or sets the size that is the upper limit that GetPreferredSize can specify. (Inherited from Control.)
Public propertyMinimumSizeGets or sets the size that is the lower limit that GetPreferredSize can specify. (Inherited from Control.)
Public propertyNameGets or sets the name of the control. (Inherited from Control.)
Public propertyObjectForScriptingGets or sets an object that can be accessed by scripting code that is contained within a Web page displayed in the WebBrowser control.
Public propertyPaddingInfrastructure. This property is not meaningful for this control.
Public propertyParentGets or sets the parent container of the control. (Inherited from Control.)
Public propertyPreferredSizeGets the size of a rectangular area into which the control can fit. (Inherited from Control.)
Public propertyProductNameGets the product name of the assembly containing the control. (Inherited from Control.)
Public propertyProductVersionGets the version of the assembly containing the control. (Inherited from Control.)
Public propertyReadyStateGets a value indicating the current state of the WebBrowser control.
Public propertyRecreatingHandleGets a value indicating whether the control is currently re-creating its handle. (Inherited from Control.)
Public propertyRegionGets or sets the window region associated with the control. (Inherited from Control.)
Protected propertyRenderRightToLeft Obsolete. This property is now obsolete. (Inherited from Control.)
Protected propertyResizeRedrawGets or sets a value indicating whether the control redraws itself when resized. (Inherited from Control.)
Public propertyRightGets the distance, in pixels, between the right edge of the control and the left edge of its container's client area. (Inherited from Control.)
Public propertyRightToLeftInfrastructure. This property is not supported by this control. (Inherited from WebBrowserBase.)
Protected propertyScaleChildrenGets a value that determines the scaling of child controls. (Inherited from Control.)
Public propertyScriptErrorsSuppressedGets or sets a value indicating whether the WebBrowser displays dialog boxes such as script error messages.
Public propertyScrollBarsEnabledGets or sets a value indicating whether scroll bars are displayed in the WebBrowser control.
Protected propertyShowFocusCuesGets a value indicating whether the control should display focus rectangles. (Inherited from Control.)
Protected propertyShowKeyboardCuesGets a value indicating whether the user interface is in the appropriate state to show or hide keyboard accelerators. (Inherited from Control.)
Public propertySiteGets or sets the site of the control. (Inherited from WebBrowserBase.)
Public propertySizeGets or sets the height and width of the control. (Inherited from Control.)
Public propertyStatusTextGets the status text of the WebBrowser control.
Public propertyTabIndexGets or sets the tab order of the control within its container. (Inherited from Control.)
Public propertyTabStopGets or sets a value indicating whether the user can give the focus to this control using the TAB key. (Inherited from Control.)
Public propertyTagGets or sets the object that contains data about the control. (Inherited from Control.)
Public propertyTextInfrastructure. This property is not supported by this control. (Inherited from WebBrowserBase.)
Public propertyTopGets or sets the distance, in pixels, between the top edge of the control and the top edge of its container's client area. (Inherited from Control.)
Public propertyTopLevelControlGets the parent control that is not parented by another Windows Forms control. Typically, this is the outermost Form that the control is contained in. (Inherited from Control.)
Public propertyUrlGets or sets the URL of the current document.
Public propertyUseWaitCursorInfrastructure. This property is not supported by this control. (Inherited from WebBrowserBase.)
Public propertyVersionGets the version of Internet Explorer installed.
Public propertyVisibleGets or sets a value indicating whether the control and all its child controls are displayed. (Inherited from Control.)
Public propertyWebBrowserShortcutsEnabledGets or sets a value indicating whether keyboard shortcuts are enabled within the WebBrowser control.
Public propertyWidthGets or sets the width of the control. (Inherited from Control.)
Public propertyWindowTargetInfrastructure. This property is not relevant for this class. (Inherited from Control.)
Top

  NameDescription
Protected methodAccessibilityNotifyClients(AccessibleEvents, Int32)Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control. (Inherited from Control.)
Protected methodAccessibilityNotifyClients(AccessibleEvents, Int32, Int32)Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control . (Inherited from Control.)
Protected methodAttachInterfacesInfrastructure. Called by the control when the underlying ActiveX control is created. (Overrides WebBrowserBase.AttachInterfaces(Object).)
Public methodBeginInvoke(Delegate)Executes the specified delegate asynchronously on the thread that the control's underlying handle was created on. (Inherited from Control.)
Public methodBeginInvoke(Delegate, Object[])Executes the specified delegate asynchronously with the specified arguments, on the thread that the control's underlying handle was created on. (Inherited from Control.)
Public methodBringToFrontBrings the control to the front of the z-order. (Inherited from Control.)
Public methodContainsRetrieves a value indicating whether the specified control is a child of the control. (Inherited from Control.)
Protected methodCreateAccessibilityInstanceCreates a new accessibility object for the control. (Inherited from Control.)
Public methodCreateControlForces the creation of the visible control, including the creation of the handle and any visible child controls. (Inherited from Control.)
Protected methodCreateControlsInstanceCreates a new instance of the control collection for the control. (Inherited from Control.)
Public methodCreateGraphicsCreates the Graphics for the control. (Inherited from Control.)
Protected methodCreateHandleCreates a handle for the control. (Inherited from Control.)
Public methodCreateObjRefCreates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject.)
Protected methodCreateSinkAssociates the underlying ActiveX control with a client that can handle control events. (Overrides WebBrowserBase.CreateSink().)
Protected methodCreateWebBrowserSiteBaseReturns a reference to the unmanaged WebBrowser ActiveX control site, which you can extend to customize the managed WebBrowser control. (Overrides WebBrowserBase.CreateWebBrowserSiteBase().)
Protected methodDefWndProcSends the specified message to the default window procedure. (Inherited from Control.)
Protected methodDestroyHandleDestroys the handle associated with the control. (Inherited from Control.)
Protected methodDetachInterfacesInfrastructure. Called by the control when the underlying ActiveX control is discarded. (Overrides WebBrowserBase.DetachInterfaces().)
Protected methodDetachSinkReleases the event-handling client attached in the CreateSink method from the underlying ActiveX control. (Overrides WebBrowserBase.DetachSink().)
Public methodDispose()Releases all resources used by the Component. (Inherited from Component.)
Protected methodDispose(Boolean)Releases the unmanaged resources used by the WebBrowser and optionally releases the managed resources. (Overrides WebBrowserBase.Dispose(Boolean).)
Public methodDoDragDropBegins a drag-and-drop operation. (Inherited from Control.)
Public methodDrawToBitmapInfrastructure. This method is not supported by this control. (Inherited from WebBrowserBase.)
Public methodEndInvokeRetrieves the return value of the asynchronous operation represented by the IAsyncResult passed. (Inherited from Control.)
Public methodEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Protected methodFinalizeReleases unmanaged resources and performs other cleanup operations before the Component is reclaimed by garbage collection. (Inherited from Component.)
Public methodFindFormRetrieves the form that the control is on. (Inherited from Control.)
Public methodFocusSets input focus to the control. (Inherited from Control.)
Protected methodGetAccessibilityObjectByIdRetrieves the specified AccessibleObject. (Inherited from Control.)
Protected methodGetAutoSizeModeRetrieves a value indicating how a control will behave when its AutoSize property is enabled. (Inherited from Control.)
Public methodGetChildAtPoint(Point)Retrieves the child control that is located at the specified coordinates. (Inherited from Control.)
Public methodGetChildAtPoint(Point, GetChildAtPointSkip)Retrieves the child control that is located at the specified coordinates, specifying whether to ignore child controls of a certain type. (Inherited from Control.)
Public methodGetContainerControlReturns the next ContainerControl up the control's chain of parent controls. (Inherited from Control.)
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodGetLifetimeServiceRetrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
Public methodGetNextControlRetrieves the next control forward or back in the tab order of child controls. (Inherited from Control.)
Public methodGetPreferredSizeRetrieves the size of a rectangular area into which a control can be fitted. (Inherited from Control.)
Protected methodGetScaledBoundsRetrieves the bounds within which the control is scaled. (Inherited from Control.)
Protected methodGetServiceReturns an object that represents a service provided by the Component or by its Container. (Inherited from Component.)
Protected methodGetStyleRetrieves the value of the specified control style bit for the control. (Inherited from Control.)
Protected methodGetTopLevelDetermines if the control is a top-level control. (Inherited from Control.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodGoBackNavigates the WebBrowser control to the previous page in the navigation history, if one is available.
Public methodGoForwardNavigates the WebBrowser control to the next page in the navigation history, if one is available.
Public methodGoHomeNavigates the WebBrowser control to the home page of the current user.
Public methodGoSearchNavigates the WebBrowser control to the default search page of the current user.
Public methodHideConceals the control from the user. (Inherited from Control.)
Public methodInitializeLifetimeServiceObtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
Protected methodInitLayoutCalled after the control has been added to another container. (Inherited from Control.)
Public methodInvalidate()Invalidates the entire surface of the control and causes the control to be redrawn. (Inherited from Control.)
Public methodInvalidate(Boolean)Invalidates a specific region of the control and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control. (Inherited from Control.)
Public methodInvalidate(Rectangle)Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. (Inherited from Control.)
Public methodInvalidate(Region)Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. (Inherited from Control.)
Public methodInvalidate(Rectangle, Boolean)Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control. (Inherited from Control.)
Public methodInvalidate(Region, Boolean)Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control. (Inherited from Control.)
Public methodInvoke(Delegate)Executes the specified delegate on the thread that owns the control's underlying window handle. (Inherited from Control.)
Public methodInvoke(Delegate, Object[])Executes the specified delegate, on the thread that owns the control's underlying window handle, with the specified list of arguments. (Inherited from Control.)
Protected methodInvokeGotFocusRaises the GotFocus event for the specified control. (Inherited from Control.)
Protected methodInvokeLostFocusRaises the LostFocus event for the specified control. (Inherited from Control.)
Protected methodInvokeOnClickRaises the Click event for the specified control. (Inherited from Control.)
Protected methodInvokePaintRaises the Paint event for the specified control. (Inherited from Control.)
Protected methodInvokePaintBackgroundRaises the PaintBackground event for the specified control. (Inherited from Control.)
Protected methodIsInputCharDetermines if a character is an input character that the control recognizes. (Inherited from WebBrowserBase.)
Protected methodIsInputKeyDetermines whether the specified key is a regular input key or a special key that requires preprocessing. (Inherited from Control.)
Protected methodMemberwiseClone()Creates a shallow copy of the current Object. (Inherited from Object.)
Protected methodMemberwiseClone(Boolean)Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject.)
Public methodNavigate(String)Loads the document at the specified Uniform Resource Locator (URL) into the WebBrowser control, replacing the previous document.
Public methodNavigate(Uri)Loads the document at the location indicated by the specified Uri into the WebBrowser control, replacing the previous document.
Public methodNavigate(String, Boolean)Loads the document at the specified Uniform Resource Locator (URL) into a new browser window or into the WebBrowser control.
Public methodNavigate(String, String)Loads the document at the specified Uniform Resource Locator (URL) into the WebBrowser control, replacing the contents of the Web page frame with the specified name.
Public methodNavigate(Uri, Boolean)Loads the document at the location indicated by the specified Uri into a new browser window or into the WebBrowser control.
Public methodNavigate(Uri, String)Loads the document at the location indicated by the specified Uri into the WebBrowser control, replacing the contents of the Web page frame with the specified name.
Public methodNavigate(String, String, Byte[], String)Loads the document at the specified Uniform Resource Locator (URL) into the WebBrowser control, requesting it using the specified HTTP data and replacing the contents of the Web page frame with the specified name.
Public methodNavigate(Uri, String, Byte[], String)Loads the document at the location indicated by the specified Uri into the WebBrowser control, requesting it using the specified HTTP data and replacing the contents of the Web page frame with the specified name.
Protected methodNotifyInvalidateInfrastructure. Raises the Invalidated event with a specified region of the control to invalidate. (Inherited from Control.)
Protected methodOnAutoSizeChangedRaises the AutoSizeChanged event. (Inherited from Control.)
Protected methodOnBackColorChangedRaises the BackColorChanged event. (Inherited from WebBrowserBase.)
Protected methodOnBackgroundImageChangedRaises the BackgroundImageChanged event. (Inherited from Control.)
Protected methodOnBackgroundImageLayoutChangedRaises the BackgroundImageLayoutChanged event. (Inherited from Control.)
Protected methodOnBindingContextChangedRaises the BindingContextChanged event. (Inherited from Control.)
Protected methodOnCanGoBackChangedRaises the CanGoBackChanged event.
Protected methodOnCanGoForwardChangedRaises the CanGoForwardChanged event.
Protected methodOnCausesValidationChangedRaises the CausesValidationChanged event. (Inherited from Control.)
Protected methodOnChangeUICuesRaises the ChangeUICues event. (Inherited from Control.)
Protected methodOnClickRaises the Click event. (Inherited from Control.)
Protected methodOnClientSizeChangedRaises the ClientSizeChanged event. (Inherited from Control.)
Protected methodOnContextMenuChangedRaises the ContextMenuChanged event. (Inherited from Control.)
Protected methodOnContextMenuStripChangedRaises the ContextMenuStripChanged event. (Inherited from Control.)
Protected methodOnControlAddedRaises the ControlAdded event. (Inherited from Control.)
Protected methodOnControlRemovedRaises the ControlRemoved event. (Inherited from Control.)
Protected methodOnCreateControlRaises the CreateControl method. (Inherited from Control.)
Protected methodOnCursorChangedRaises the CursorChanged event. (Inherited from Control.)
Protected methodOnDockChangedRaises the DockChanged event. (Inherited from Control.)
Protected methodOnDocumentCompletedRaises the DocumentCompleted event.
Protected methodOnDocumentTitleChangedRaises the DocumentTitleChanged event.
Protected methodOnDoubleClickRaises the DoubleClick event. (Inherited from Control.)
Protected methodOnDragDropRaises the DragDrop event. (Inherited from Control.)
Protected methodOnDragEnterRaises the DragEnter event. (Inherited from Control.)
Protected methodOnDragLeaveRaises the DragLeave event. (Inherited from Control.)
Protected methodOnDragOverRaises the DragOver event. (Inherited from Control.)
Protected methodOnEnabledChangedRaises the EnabledChanged event. (Inherited from Control.)
Protected methodOnEncryptionLevelChangedRaises the EncryptionLevelChanged event.
Protected methodOnEnterRaises the Enter event. (Inherited from Control.)
Protected methodOnFileDownloadRaises the FileDownload event.
Protected methodOnFontChangedRaises the FontChanged event. (Inherited from WebBrowserBase.)
Protected methodOnForeColorChangedRaises the ForeColorChanged event. (Inherited from WebBrowserBase.)
Protected methodOnGiveFeedbackRaises the GiveFeedback event. (Inherited from Control.)
Protected methodOnGotFocusRaises the GotFocus event. (Inherited from WebBrowserBase.)
Protected methodOnHandleCreatedRaises the HandleCreated event. (Inherited from WebBrowserBase.)
Protected methodOnHandleDestroyedRaises the HandleDestroyed event. (Inherited from Control.)
Protected methodOnHelpRequestedRaises the HelpRequested event. (Inherited from Control.)
Protected methodOnImeModeChangedRaises the ImeModeChanged event. (Inherited from Control.)
Protected methodOnInvalidatedRaises the Invalidated event. (Inherited from Control.)
Protected methodOnKeyDownRaises the KeyDown event. (Inherited from Control.)
Protected methodOnKeyPressRaises the KeyPress event. (Inherited from Control.)
Protected methodOnKeyUpRaises the KeyUp event. (Inherited from Control.)
Protected methodOnLayoutRaises the Layout event. (Inherited from Control.)
Protected methodOnLeaveRaises the Leave event. (Inherited from Control.)
Protected methodOnLocationChangedRaises the LocationChanged event. (Inherited from Control.)
Protected methodOnLostFocusRaises the LostFocus event. (Inherited from WebBrowserBase.)
Protected methodOnMarginChangedRaises the MarginChanged event. (Inherited from Control.)
Protected methodOnMouseCaptureChangedRaises the MouseCaptureChanged event. (Inherited from Control.)
Protected methodOnMouseClickRaises the MouseClick event. (Inherited from Control.)
Protected methodOnMouseDoubleClickRaises the MouseDoubleClick event. (Inherited from Control.)
Protected methodOnMouseDownRaises the MouseDown event. (Inherited from Control.)
Protected methodOnMouseEnterRaises the MouseEnter event. (Inherited from Control.)
Protected methodOnMouseHoverRaises the MouseHover event. (Inherited from Control.)
Protected methodOnMouseLeaveRaises the MouseLeave event. (Inherited from Control.)
Protected methodOnMouseMoveRaises the MouseMove event. (Inherited from Control.)
Protected methodOnMouseUpRaises the MouseUp event. (Inherited from Control.)
Protected methodOnMouseWheelRaises the MouseWheel event. (Inherited from Control.)
Protected methodOnMoveRaises the Move event. (Inherited from Control.)
Protected methodOnNavigatedRaises the Navigated event.
Protected methodOnNavigatingRaises the Navigating event.
Protected methodOnNewWindowRaises the NewWindow event.
Protected methodOnNotifyMessageNotifies the control of Windows messages. (Inherited from Control.)
Protected methodOnPaddingChangedRaises the PaddingChanged event. (Inherited from Control.)
Protected methodOnPaintRaises the Paint event. (Inherited from Control.)
Protected methodOnPaintBackgroundPaints the background of the control. (Inherited from Control.)
Protected methodOnParentBackColorChangedRaises the BackColorChanged event when the BackColor property value of the control's container changes. (Inherited from Control.)
Protected methodOnParentBackgroundImageChangedRaises the BackgroundImageChanged event when the BackgroundImage property value of the control's container changes. (Inherited from Control.)
Protected methodOnParentBindingContextChangedRaises the BindingContextChanged event when the BindingContext property value of the control's container changes. (Inherited from Control.)
Protected methodOnParentChangedThis member overrides Control.OnParentChanged. (Inherited from WebBrowserBase.)
Protected methodOnParentCursorChangedRaises the CursorChanged event. (Inherited from Control.)
Protected methodOnParentEnabledChangedRaises the EnabledChanged event when the Enabled property value of the control's container changes. (Inherited from Control.)
Protected methodOnParentFontChangedRaises the FontChanged event when the Font property value of the control's container changes. (Inherited from Control.)
Protected methodOnParentForeColorChangedRaises the ForeColorChanged event when the ForeColor property value of the control's container changes. (Inherited from Control.)
Protected methodOnParentRightToLeftChangedRaises the RightToLeftChanged event when the RightToLeft property value of the control's container changes. (Inherited from Control.)
Protected methodOnParentVisibleChangedRaises the VisibleChanged event when the Visible property value of the control's container changes. (Inherited from Control.)
Protected methodOnPreviewKeyDownRaises the PreviewKeyDown event. (Inherited from Control.)
Protected methodOnPrintRaises the Paint event. (Inherited from Control.)
Protected methodOnProgressChangedRaises the ProgressChanged event.
Protected methodOnQueryContinueDragRaises the QueryContinueDrag event. (Inherited from Control.)
Protected methodOnRegionChangedRaises the RegionChanged event. (Inherited from Control.)
Protected methodOnResizeRaises the Resize event. (Inherited from Control.)
Protected methodOnRightToLeftChangedInfrastructure. This method is not meaningful for this control. (Inherited from WebBrowserBase.)
Protected methodOnSizeChangedRaises the SizeChanged event. (Inherited from Control.)
Protected methodOnStatusTextChangedRaises the StatusTextChanged event.
Protected methodOnStyleChangedRaises the StyleChanged event. (Inherited from Control.)
Protected methodOnSystemColorsChangedRaises the SystemColorsChanged event. (Inherited from Control.)
Protected methodOnTabIndexChangedRaises the TabIndexChanged event. (Inherited from Control.)
Protected methodOnTabStopChangedRaises the TabStopChanged event. (Inherited from Control.)
Protected methodOnTextChangedRaises the TextChanged event. (Inherited from Control.)
Protected methodOnValidatedRaises the Validated event. (Inherited from Control.)
Protected methodOnValidatingRaises the Validating event. (Inherited from Control.)
Protected methodOnVisibleChangedThis member overrides Control.OnVisibleChanged. (Inherited from WebBrowserBase.)
Public methodPerformLayout()Forces the control to apply layout logic to all its child controls. (Inherited from Control.)
Public methodPerformLayout(Control, String)Forces the control to apply layout logic to all its child controls. (Inherited from Control.)
Public methodPointToClientComputes the location of the specified screen point into client coordinates. (Inherited from Control.)
Public methodPointToScreenComputes the location of the specified client point into screen coordinates. (Inherited from Control.)
Public methodPreProcessControlMessagePreprocesses keyboard or input messages within the message loop before they are dispatched. (Inherited from Control.)
Public methodPreProcessMessagePreprocesses keyboard or input messages within the message loop before they are dispatched. (Inherited from WebBrowserBase.)
Public methodPrintPrints the document currently displayed in the WebBrowser control using the current print and page settings.
Protected methodProcessCmdKeyProcesses a command key. (Inherited from Control.)
Protected methodProcessDialogCharProcesses a dialog character. (Inherited from Control.)
Protected methodProcessDialogKeyProcesses a dialog key if the WebBrowser ActiveX control does not process it. (Inherited from WebBrowserBase.)
Protected methodProcessKeyEventArgsProcesses a key message and generates the appropriate control events. (Inherited from Control.)
Protected methodProcessKeyMessageProcesses a keyboard message. (Inherited from Control.)
Protected methodProcessKeyPreviewPreviews a keyboard message. (Inherited from Control.)
Protected methodProcessMnemonicProcesses a mnemonic character. (Inherited from WebBrowserBase.)
Protected methodRaiseDragEventInfrastructure. Raises the appropriate drag event. (Inherited from Control.)
Protected methodRaiseKeyEventInfrastructure. Raises the appropriate key event. (Inherited from Control.)
Protected methodRaiseMouseEventInfrastructure. Raises the appropriate mouse event. (Inherited from Control.)
Protected methodRaisePaintEventInfrastructure. Raises the appropriate paint event. (Inherited from Control.)
Protected methodRecreateHandleForces the re-creation of the handle for the control. (Inherited from Control.)
Public methodRectangleToClientComputes the size and location of the specified screen rectangle in client coordinates. (Inherited from Control.)
Public methodRectangleToScreenComputes the size and location of the specified client rectangle in screen coordinates. (Inherited from Control.)
Public methodRefresh()Reloads the document currently displayed in the WebBrowser control by checking the server for an updated version. (Overrides Control.Refresh().)
Public methodRefresh(WebBrowserRefreshOption)Reloads the document currently displayed in the WebBrowser control using the specified refresh options.
Public methodResetBackColorResets the BackColor property to its default value. (Inherited from Control.)
Public methodResetBindingsCauses a control bound to the BindingSource to reread all the items in the list and refresh their displayed values. (Inherited from Control.)
Public methodResetCursorResets the Cursor property to its default value. (Inherited from Control.)
Public methodResetFontResets the Font property to its default value. (Inherited from Control.)
Public methodResetForeColorResets the ForeColor property to its default value. (Inherited from Control.)
Public methodResetImeModeResets the ImeMode property to its default value. (Inherited from Control.)
Protected methodResetMouseEventArgsInfrastructure. Resets the control to handle the MouseLeave event. (Inherited from Control.)
Public methodResetRightToLeftResets the RightToLeft property to its default value. (Inherited from Control.)
Public methodResetTextResets the Text property to its default value. (Inherited from Control.)
Public methodResumeLayout()Resumes usual layout logic. (Inherited from Control.)
Public methodResumeLayout(Boolean)Resumes usual layout logic, optionally forcing an immediate layout of pending layout requests. (Inherited from Control.)
Protected methodRtlTranslateAlignment(ContentAlignment)Converts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text. (Inherited from Control.)
Protected methodRtlTranslateAlignment(HorizontalAlignment)Converts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text. (Inherited from Control.)
Protected methodRtlTranslateAlignment(LeftRightAlignment)Converts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text. (Inherited from Control.)
Protected methodRtlTranslateContentConverts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text. (Inherited from Control.)
Protected methodRtlTranslateHorizontalConverts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text. (Inherited from Control.)
Protected methodRtlTranslateLeftRightConverts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text. (Inherited from Control.)
Public methodScale(Single) Obsolete. Scales the control and any child controls. (Inherited from Control.)
Public methodScale(SizeF)Scales the control and all child controls by the specified scaling factor. (Inherited from Control.)
Public methodScale(Single, Single) Obsolete. Scales the entire control and any child controls. (Inherited from Control.)
Protected methodScaleControlScales a control's location, size, padding and margin. (Inherited from Control.)
Protected methodScaleCoreInfrastructure. This method is not relevant for this class. (Inherited from Control.)
Public methodSelect()Activates the control. (Inherited from Control.)
Protected methodSelect(Boolean, Boolean)Activates a child control. Optionally specifies the direction in the tab order to select the control from. (Inherited from Control.)
Public methodSelectNextControlActivates the next control. (Inherited from Control.)
Public methodSendToBackSends the control to the back of the z-order. (Inherited from Control.)
Protected methodSetAutoSizeModeSets a value indicating how a control will behave when its AutoSize property is enabled. (Inherited from Control.)
Public methodSetBounds(Int32, Int32, Int32, Int32)Sets the bounds of the control to the specified location and size. (Inherited from Control.)
Public methodSetBounds(Int32, Int32, Int32, Int32, BoundsSpecified)Sets the specified bounds of the control to the specified location and size. (Inherited from Control.)
Protected methodSetBoundsCorePerforms the work of setting the specified bounds of this control. (Inherited from Control.)
Protected methodSetClientSizeCoreSets the size of the client area of the control. (Inherited from Control.)
Protected methodSetStyleSets a specified ControlStyles flag to either true or false. (Inherited from Control.)
Protected methodSetTopLevelSets the control as the top-level control. (Inherited from Control.)
Protected methodSetVisibleCoreSets the control to the specified visible state. (Inherited from Control.)
Public methodShowDisplays the control to the user. (Inherited from Control.)
Public methodShowPageSetupDialogOpens the Internet Explorer Page Setup dialog box.
Public methodShowPrintDialogOpens the Internet Explorer Print dialog box without setting header and footer values.
Public methodShowPrintPreviewDialogOpens the Internet Explorer Print Preview dialog box.
Public methodShowPropertiesDialogOpens the Internet Explorer Properties dialog box for the current document.
Public methodShowSaveAsDialogOpens the Internet Explorer Save Web Page dialog box or the Save dialog box of the hosted document if it is not an HTML page.
Protected methodSizeFromClientSizeDetermines the size of the entire control from the height and width of its client area. (Inherited from Control.)
Public methodStopCancels any pending navigation and stops any dynamic page elements, such as background sounds and animations.
Public methodSuspendLayoutTemporarily suspends the layout logic for the control. (Inherited from Control.)
Public methodToStringReturns a String containing the name of the Component, if any. This method should not be overridden. (Inherited from Component.)
Public methodUpdateCauses the control to redraw the invalidated regions within its client area. (Inherited from Control.)
Protected methodUpdateBounds()Updates the bounds of the control with the current size and location. (Inherited from Control.)
Protected methodUpdateBounds(Int32, Int32, Int32, Int32)Updates the bounds of the control with the specified size and location. (Inherited from Control.)
Protected methodUpdateBounds(Int32, Int32, Int32, Int32, Int32, Int32)Updates the bounds of the control with the specified size, location, and client size. (Inherited from Control.)
Protected methodUpdateStylesForces the assigned styles to be reapplied to the control. (Inherited from Control.)
Protected methodUpdateZOrderUpdates the control in its parent's z-order. (Inherited from Control.)
Protected methodWndProcThis member overrides WndProc. (Overrides WebBrowserBase.WndProc(Message).)
Top

  NameDescription
Public eventAutoSizeChangedInfrastructure. This event is not relevant for this class. (Inherited from Control.)
Public eventBackColorChangedInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventBackgroundImageChangedInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventBackgroundImageLayoutChangedInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventBindingContextChangedInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventCanGoBackChangedOccurs when the CanGoBack property value changes.
Public eventCanGoForwardChangedOccurs when the CanGoForward property value changes.
Public eventCausesValidationChangedOccurs when the value of the CausesValidation property changes. (Inherited from Control.)
Public eventChangeUICuesInfrastructure. Occurs when the focus or keyboard user interface (UI) cues change. (Inherited from WebBrowserBase.)
Public eventClickInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventClientSizeChangedOccurs when the value of the ClientSize property changes. (Inherited from Control.)
Public eventContextMenuChangedOccurs when the value of the ContextMenu property changes. (Inherited from Control.)
Public eventContextMenuStripChangedOccurs when the value of the ContextMenuStrip property changes. (Inherited from Control.)
Public eventControlAddedOccurs when a new control is added to the Control.ControlCollection. (Inherited from Control.)
Public eventControlRemovedOccurs when a control is removed from the Control.ControlCollection. (Inherited from Control.)
Public eventCursorChangedInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventDisposedOccurs when the component is disposed by a call to the Dispose method. (Inherited from Component.)
Public eventDockChangedOccurs when the value of the Dock property changes. (Inherited from Control.)
Public eventDocumentCompletedOccurs when the WebBrowser control finishes loading a document.
Public eventDocumentTitleChangedOccurs when the DocumentTitle property value changes.
Public eventDoubleClickInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventDragDropInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventDragEnterInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventDragLeaveInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventDragOverInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventEnabledChangedInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventEncryptionLevelChangedOccurs when the WebBrowser control navigates to or away from a Web site that uses encryption.
Public eventEnterInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventFileDownloadOccurs when the WebBrowser control downloads a file.
Public eventFontChangedInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventForeColorChangedInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventGiveFeedbackInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventGotFocusOccurs when the control receives focus. (Inherited from Control.)
Public eventHandleCreatedOccurs when a handle is created for the control. (Inherited from Control.)
Public eventHandleDestroyedOccurs when the control's handle is in the process of being destroyed. (Inherited from Control.)
Public eventHelpRequestedInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventImeModeChangedInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventInvalidatedOccurs when a control's display requires redrawing. (Inherited from Control.)
Public eventKeyDownInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventKeyPressInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventKeyUpInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventLayoutInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventLeaveInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventLocationChangedOccurs when the Location property value has changed. (Inherited from Control.)
Public eventLostFocusOccurs when the control loses focus. (Inherited from Control.)
Public eventMarginChangedOccurs when the control's margin changes. (Inherited from Control.)
Public eventMouseCaptureChangedInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventMouseClickInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventMouseDoubleClickInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventMouseDownInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventMouseEnterInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventMouseHoverInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventMouseLeaveInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventMouseMoveInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventMouseUpInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventMouseWheelInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventMoveOccurs when the control is moved. (Inherited from Control.)
Public eventNavigatedOccurs when the WebBrowser control has navigated to a new document and has begun loading it.
Public eventNavigatingOccurs before the WebBrowser control navigates to a new document.
Public eventNewWindowOccurs before a new browser window is opened.
Public eventPaddingChangedInfrastructure. Occurs when the value of the Padding property changes.
Public eventPaintInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventParentChangedOccurs when the Parent property value changes. (Inherited from Control.)
Public eventPreviewKeyDownOccurs before the KeyDown event when a key is pressed while focus is on this control. (Inherited from Control.)
Public eventProgressChangedOccurs when the WebBrowser control has updated information on the download progress of a document it is navigating to.
Public eventQueryAccessibilityHelpInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventQueryContinueDragInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventRegionChangedOccurs when the value of the Region property changes. (Inherited from Control.)
Public eventResizeOccurs when the control is resized. (Inherited from Control.)
Public eventRightToLeftChangedInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventSizeChangedOccurs when the Size property value changes. (Inherited from Control.)
Public eventStatusTextChangedOccurs when the StatusText property value changes.
Public eventStyleChangedInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventSystemColorsChangedOccurs when the system colors change. (Inherited from Control.)
Public eventTabIndexChangedOccurs when the TabIndex property value changes. (Inherited from Control.)
Public eventTabStopChangedOccurs when the TabStop property value changes. (Inherited from Control.)
Public eventTextChangedInfrastructure. This event is not supported by this control. (Inherited from WebBrowserBase.)
Public eventValidatedOccurs when the control is finished validating. (Inherited from Control.)
Public eventValidatingOccurs when the control is validating. (Inherited from Control.)
Public eventVisibleChangedOccurs when the Visible property value changes. (Inherited from Control.)
Top

  NameDescription
Explicit interface implemetationPrivate methodIDropTarget.OnDragDropInfrastructure. Raises the DragDrop event. (Inherited from Control.)
Explicit interface implemetationPrivate methodIDropTarget.OnDragEnterInfrastructure. Raises the DragEnter event. (Inherited from Control.)
Explicit interface implemetationPrivate methodIDropTarget.OnDragLeaveInfrastructure. Raises the DragLeave event. (Inherited from Control.)
Explicit interface implemetationPrivate methodIDropTarget.OnDragOverInfrastructure. Raises the DragOver event. (Inherited from Control.)
Top

The WebBrowser control lets you host Web pages and other browser-enabled documents in your Windows Forms applications. You can use the WebBrowser control, for example, to provide integrated HTML-based user assistance or Web browsing capabilities in your application. Additionally, you can use the WebBrowser control to add your existing Web-based controls to your Windows Forms client applications.

Important noteImportant

The WebBrowser control is resource-intensive. Be sure to call the Dispose() method when you are finished using the control to ensure that all resources are released in a timely fashion. You must call the Dispose() method on the same thread that attached the events, which should always be the message or user-interface (UI) thread.

The WebBrowser control cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

The WebBrowser control has several properties, methods, and events related to navigation. The following members let you navigate the control to a specific URL, move backward and forward through the navigation history list, and load the home page and search page of the current user:

If the navigation is unsuccessful, a page indicating the problem is displayed. Navigation with any of these members causes the Navigating, Navigated, and DocumentCompleted events to occur at different stages of navigation.

These and other members, such as the Stop and Refresh methods, let you implement user interface controls in your application similar to those in Internet Explorer. Some members are useful even when you do not want to display the WebBrowser control on your form. For example, you can use the Print method to print the latest version of a Web page without displaying the page to the user.

The WebBrowser control also lets you display content that you create in your application or you retrieve from a database or resource file. Use the DocumentText or DocumentStream property to get or set the contents of the current document as a string or data stream.

You can also manipulate the contents of a Web page through the Document property, which contains an HtmlDocument object that provides managed access to the HTML document object model (DOM) for the current page. This property is useful, when used in combination with the ObjectForScripting property, to implement two-way communication between your application code and dynamic HTML (DHTML) code in a Web page, letting you combine Web-based controls and Windows Forms controls in a single user interface. You can use the Document property to call scripting code methods from your application. Your scripting code can access your application through the window.external object, which is a built-in DOM object provided for host access, and which maps to the object that you specify for the ObjectForScripting property.

The WebBrowser control is a managed wrapper for the ActiveX WebBrowser control, and uses whichever version of the control is installed on the user's computer.

NoteNote

This class makes security demands at the class level. A SecurityException is thrown when a derived class or any caller in the call stack does not have full trust permission. For details about security demands, see Link Demands and Inheritance Demands.

NoteNote

The WebBrowser class can only be used in threads set to single thread apartment (STA) mode. To use this class, ensure that your Main method is marked with the STAThreadAttribute attribute.

The following code example demonstrates how to implement an address bar for use with the WebBrowser control. This example requires that you have a form that contains a WebBrowser control called webBrowser1, a TextBox control called TextBoxAddress, and a Button control called ButtonGo. When you type a URL into the text box and press ENTER or click the Go button, the WebBrowser control navigates to the URL specified. When you navigate by clicking a hyperlink, the text box automatically updates to display the current URL.

For the complete code example, see How to: Add Web Browser Capabilities to a Windows Forms Application.

// Navigates to the URL in the address box when  
// the ENTER key is pressed while the ToolStripTextBox has focus. 
private void toolStripTextBox1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Enter)
    {
        Navigate(toolStripTextBox1.Text);
    }
}

// Navigates to the URL in the address box when  
// the Go button is clicked. 
private void goButton_Click(object sender, EventArgs e)
{
    Navigate(toolStripTextBox1.Text);
}

// Navigates to the given URL if it is valid. 
private void Navigate(String address)
{
    if (String.IsNullOrEmpty(address)) return;
    if (address.Equals("about:blank")) return;
    if (!address.StartsWith("http://") &&
        !address.StartsWith("https://"))
    {
        address = "http://" + address;
    }
    try
    {
        webBrowser1.Navigate(new Uri(address));
    }
    catch (System.UriFormatException)
    {
        return;
    }
}

// Updates the URL in TextBoxAddress upon navigation. 
private void webBrowser1_Navigated(object sender,
    WebBrowserNavigatedEventArgs e)
{
    toolStripTextBox1.Text = webBrowser1.Url.ToString();
}

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show:
© 2014 Microsoft