Export (0) Print
Expand All

HttpBrowserCapabilities Class

Enables the server to gather information on the capabilities of the browser that is running on the client.

Namespace:  System.Web
Assembly:  System.Web (in System.Web.dll)

public class HttpBrowserCapabilities : HttpCapabilitiesBase

The HttpBrowserCapabilities type exposes the following members.

  NameDescription
Public methodHttpBrowserCapabilitiesCreates a new instance of the HttpBrowserCapabilities class.
Top

  NameDescription
Public propertyActiveXControlsGets a value indicating whether the browser supports ActiveX controls. (Inherited from HttpCapabilitiesBase.)
Public propertyAdaptersInfrastructure. Returns the collection of available control adapters. (Inherited from HttpCapabilitiesBase.)
Public propertyAOLGets a value indicating whether the client is an America Online (AOL) browser. (Inherited from HttpCapabilitiesBase.)
Public propertyBackgroundSoundsGets a value indicating whether the browser supports playing background sounds using the <bgsounds> HTML element. (Inherited from HttpCapabilitiesBase.)
Public propertyBetaGets a value indicating whether the browser is a beta version. (Inherited from HttpCapabilitiesBase.)
Public propertyBrowserGets the browser string (if any) that was sent by the browser in the User-Agent request header. (Inherited from HttpCapabilitiesBase.)
Public propertyBrowsersGets an ArrayList of the browsers in the Capabilities dictionary. (Inherited from HttpCapabilitiesBase.)
Public propertyCanCombineFormsInDeckGets a value indicating whether the browser supports decks that contain multiple forms, such as separate cards. (Inherited from HttpCapabilitiesBase.)
Public propertyCanInitiateVoiceCallGets a value indicating whether the browser device is capable of initiating a voice call. (Inherited from HttpCapabilitiesBase.)
Public propertyCanRenderAfterInputOrSelectElementGets a value indicating whether the browser supports page content following WML <select> or <input> elements. (Inherited from HttpCapabilitiesBase.)
Public propertyCanRenderEmptySelectsGets a value indicating whether the browser supports empty HTML <select> elements. (Inherited from HttpCapabilitiesBase.)
Public propertyCanRenderInputAndSelectElementsTogetherGets a value indicating whether the browser supports WML INPUT and SELECT elements together on the same card. (Inherited from HttpCapabilitiesBase.)
Public propertyCanRenderMixedSelectsGets a value indicating whether the browser supports WML <option> elements that specify both onpick and value attributes. (Inherited from HttpCapabilitiesBase.)
Public propertyCanRenderOneventAndPrevElementsTogetherGets a value indicating whether the browser supports WML <onevent> and <prev> elements that coexist within the same WML card. (Inherited from HttpCapabilitiesBase.)
Public propertyCanRenderPostBackCardsGets a value indicating whether the browser supports WML cards for postback. (Inherited from HttpCapabilitiesBase.)
Public propertyCanRenderSetvarZeroWithMultiSelectionListGets a value indicating whether the browser supports WML <setvar> elements with a value attribute of 0. (Inherited from HttpCapabilitiesBase.)
Public propertyCanSendMailGets a value indicating whether the browser supports sending e-mail by using the HTML <mailto> element for displaying electronic addresses. (Inherited from HttpCapabilitiesBase.)
Public propertyCapabilitiesInfrastructure. Used internally to get the defined capabilities of the browser. (Inherited from HttpCapabilitiesBase.)
Public propertyCDFGets a value indicating whether the browser supports Channel Definition Format (CDF) for webcasting. (Inherited from HttpCapabilitiesBase.)
Public propertyClrVersionGets the version of the .NET Framework that is installed on the client. (Inherited from HttpCapabilitiesBase.)
Public propertyCookiesGets a value indicating whether the browser supports cookies. (Inherited from HttpCapabilitiesBase.)
Public propertyCrawlerGets a value indicating whether the browser is a search engine Web crawler. (Inherited from HttpCapabilitiesBase.)
Public propertyDefaultSubmitButtonLimitReturns the maximum number of Submit buttons that are allowed for a form. (Inherited from HttpCapabilitiesBase.)
Public propertyEcmaScriptVersionGets the version number of ECMAScript that the browser supports. (Inherited from HttpCapabilitiesBase.)
Public propertyFramesGets a value indicating whether the browser supports HTML frames. (Inherited from HttpCapabilitiesBase.)
Public propertyGatewayMajorVersionGets the major version number of the wireless gateway used to access the server, if known. (Inherited from HttpCapabilitiesBase.)
Public propertyGatewayMinorVersionGets the minor version number of the wireless gateway used to access the server, if known. (Inherited from HttpCapabilitiesBase.)
Public propertyGatewayVersionGets the version of the wireless gateway used to access the server, if known. (Inherited from HttpCapabilitiesBase.)
Public propertyHasBackButtonGets a value indicating whether the browser has a dedicated Back button. (Inherited from HttpCapabilitiesBase.)
Public propertyHidesRightAlignedMultiselectScrollbarsGets a value indicating whether the scrollbar of an HTML <select multiple> element with an align attribute value of right is obscured upon rendering. (Inherited from HttpCapabilitiesBase.)
Public propertyHtmlTextWriterGets or sets the fully qualified class name of the HtmlTextWriter to use. (Inherited from HttpCapabilitiesBase.)
Public propertyIdGets the internal identifier of the browser as specified in the browser definition file. (Inherited from HttpCapabilitiesBase.)
Public propertyInputTypeReturns the type of input supported by browser. (Inherited from HttpCapabilitiesBase.)
Public propertyIsColorGets a value indicating whether the browser has a color display. (Inherited from HttpCapabilitiesBase.)
Public propertyIsMobileDeviceGets a value indicating whether the browser is a recognized mobile device. (Inherited from HttpCapabilitiesBase.)
Public propertyItemGets the value of the specified browser capability. In C#, this property is the indexer for the class. (Inherited from HttpCapabilitiesBase.)
Public propertyJavaAppletsGets a value indicating whether the browser supports Java. (Inherited from HttpCapabilitiesBase.)
Public propertyJavaScript Obsolete. Gets a value indicating whether the browser supports JavaScript. (Inherited from HttpCapabilitiesBase.)
Public propertyJScriptVersionGets the JScript version that the browser supports. (Inherited from HttpCapabilitiesBase.)
Public propertyMajorVersionGets the major (integer) version number of the browser. (Inherited from HttpCapabilitiesBase.)
Public propertyMaximumHrefLengthGets the maximum length in characters for the href attribute of an HTML <a> (anchor) element. (Inherited from HttpCapabilitiesBase.)
Public propertyMaximumRenderedPageSizeGets the maximum length of the page, in bytes, which the browser can display. (Inherited from HttpCapabilitiesBase.)
Public propertyMaximumSoftkeyLabelLengthReturns the maximum length of the text that a soft-key label can display. (Inherited from HttpCapabilitiesBase.)
Public propertyMinorVersionGets the minor (that is, decimal) version number of the browser. (Inherited from HttpCapabilitiesBase.)
Public propertyMinorVersionStringGets the minor (decimal) version number of the browser as a string. (Inherited from HttpCapabilitiesBase.)
Public propertyMobileDeviceManufacturerReturns the name of the manufacturer of a mobile device, if known. (Inherited from HttpCapabilitiesBase.)
Public propertyMobileDeviceModelGets the model name of a mobile device, if known. (Inherited from HttpCapabilitiesBase.)
Public propertyMSDomVersionGets the version of Microsoft HTML (MSHTML) Document Object Model (DOM) that the browser supports. (Inherited from HttpCapabilitiesBase.)
Public propertyNumberOfSoftkeysReturns the number of soft keys on a mobile device. (Inherited from HttpCapabilitiesBase.)
Public propertyPlatformGets the name of the platform that the client uses, if it is known. (Inherited from HttpCapabilitiesBase.)
Public propertyPreferredImageMimeReturns the MIME type of the type of image content typically preferred by the browser. (Inherited from HttpCapabilitiesBase.)
Public propertyPreferredRenderingMimeReturns the MIME type of the type of content typically preferred by the browser. (Inherited from HttpCapabilitiesBase.)
Public propertyPreferredRenderingTypeGets the general name for the type of content that the browser prefers. (Inherited from HttpCapabilitiesBase.)
Public propertyPreferredRequestEncodingGets the request encoding preferred by the browser. (Inherited from HttpCapabilitiesBase.)
Public propertyPreferredResponseEncodingGets the response encoding preferred by the browser. (Inherited from HttpCapabilitiesBase.)
Public propertyRendersBreakBeforeWmlSelectAndInputGets a value indicating whether the browser renders a line break before <select> or <input> elements. (Inherited from HttpCapabilitiesBase.)
Public propertyRendersBreaksAfterHtmlListsGets a value indicating whether the browser renders a line break after list-item elements. (Inherited from HttpCapabilitiesBase.)
Public propertyRendersBreaksAfterWmlAnchorGets a value indicating whether the browser renders a line break after a stand-alone HTML <a> (anchor) element. (Inherited from HttpCapabilitiesBase.)
Public propertyRendersBreaksAfterWmlInputGets a value indicating whether the browser renders a line break after an HTML <input> element. (Inherited from HttpCapabilitiesBase.)
Public propertyRendersWmlDoAcceptsInlineGets a value indicating whether the mobile-device browser renders a WML do-based form accept construct as an inline button rather than as a soft key. (Inherited from HttpCapabilitiesBase.)
Public propertyRendersWmlSelectsAsMenuCardsGets a value indicating whether the browser renders WML <select> elements as menu cards, rather than as a combo box. (Inherited from HttpCapabilitiesBase.)
Public propertyRequiredMetaTagNameValueInfrastructure. Used internally to produce a meta-tag required by some browsers. (Inherited from HttpCapabilitiesBase.)
Public propertyRequiresAttributeColonSubstitutionGets a value indicating whether the browser requires colons in element attribute values to be substituted with a different character. (Inherited from HttpCapabilitiesBase.)
Public propertyRequiresContentTypeMetaTagGets a value indicating whether the browser requires an HTML <meta> element for which the content-type attribute is specified. (Inherited from HttpCapabilitiesBase.)
Public propertyRequiresControlStateInSessionGets a value indicating whether the browser requires control state to be maintained in sessions. (Inherited from HttpCapabilitiesBase.)
Public propertyRequiresDBCSCharacterGets a value indicating whether the browser requires a double-byte character set. (Inherited from HttpCapabilitiesBase.)
Public propertyRequiresHtmlAdaptiveErrorReportingGets a value indicating whether the browser requires nonstandard error messages. (Inherited from HttpCapabilitiesBase.)
Public propertyRequiresLeadingPageBreakGets a value indicating whether the browser requires the first element in the body of a Web page to be an HTML <br> element. (Inherited from HttpCapabilitiesBase.)
Public propertyRequiresNoBreakInFormattingGets a value indicating whether the browser does not support HTML <br> elements to format line breaks. (Inherited from HttpCapabilitiesBase.)
Public propertyRequiresOutputOptimizationGets a value indicating whether the browser requires pages to contain a size-optimized form of markup language tags. (Inherited from HttpCapabilitiesBase.)
Public propertyRequiresPhoneNumbersAsPlainTextGets a value indicating whether the browser supports phone dialing based on plain text, or whether it requires special markup. (Inherited from HttpCapabilitiesBase.)
Public propertyRequiresSpecialViewStateEncodingGets a value indicating whether the browser requires VIEWSTATE values to be specially encoded. (Inherited from HttpCapabilitiesBase.)
Public propertyRequiresUniqueFilePathSuffixGets a value indicating whether the browser requires unique form-action URLs. (Inherited from HttpCapabilitiesBase.)
Public propertyRequiresUniqueHtmlCheckboxNamesGets a value indicating whether the browser requires unique name attribute values of multiple HTML <input type="checkbox"> elements. (Inherited from HttpCapabilitiesBase.)
Public propertyRequiresUniqueHtmlInputNamesGets a value indicating whether the browser requires unique name attribute values of multiple HTML <input> elements. (Inherited from HttpCapabilitiesBase.)
Public propertyRequiresUrlEncodedPostfieldValuesGets a value indicating whether postback data sent by the browser will be UrlEncoded. (Inherited from HttpCapabilitiesBase.)
Public propertyScreenBitDepthReturns the depth of the display, in bits per pixel. (Inherited from HttpCapabilitiesBase.)
Public propertyScreenCharactersHeightReturns the approximate height of the display, in character lines. (Inherited from HttpCapabilitiesBase.)
Public propertyScreenCharactersWidthReturns the approximate width of the display, in characters. (Inherited from HttpCapabilitiesBase.)
Public propertyScreenPixelsHeightReturns the approximate height of the display, in pixels. (Inherited from HttpCapabilitiesBase.)
Public propertyScreenPixelsWidthReturns the approximate width of the display, in pixels. (Inherited from HttpCapabilitiesBase.)
Public propertySupportsAccesskeyAttributeGets a value indicating whether the browser supports the ACCESSKEY attribute of HTML <a> (anchor) and <input> elements. (Inherited from HttpCapabilitiesBase.)
Public propertySupportsBodyColorGets a value indicating whether the browser supports the bgcolor attribute of the HTML <body> element. (Inherited from HttpCapabilitiesBase.)
Public propertySupportsBoldGets a value indicating whether the browser supports HTML <b> elements to format bold text. (Inherited from HttpCapabilitiesBase.)
Public propertySupportsCacheControlMetaTagGets a value indicating whether the browser supports the cache-control value for the http-equiv attribute of HTML <meta> elements. (Inherited from HttpCapabilitiesBase.)
Public propertySupportsCallbackGets a value indicating whether the browser supports callback scripts. (Inherited from HttpCapabilitiesBase.)
Public propertySupportsCssGets a value indicating whether the browser supports Cascading Style Sheets (CSS). (Inherited from HttpCapabilitiesBase.)
Public propertySupportsDivAlignGets a value indicating whether the browser supports the align attribute of HTML <div> elements. (Inherited from HttpCapabilitiesBase.)
Public propertySupportsDivNoWrapGets a value indicating whether the browser supports the nowrap attribute of HTML <div> elements. (Inherited from HttpCapabilitiesBase.)
Public propertySupportsEmptyStringInCookieValueGets a value indicating whether the browser supports empty (null) strings in cookie values. (Inherited from HttpCapabilitiesBase.)
Public propertySupportsFontColorGets a value indicating whether the browser supports the color attribute of HTML <font> elements. (Inherited from HttpCapabilitiesBase.)
Public propertySupportsFontNameGets a value indicating whether the browser supports the name attribute of HTML <font> elements. (Inherited from HttpCapabilitiesBase.)
Public propertySupportsFontSizeGets a value indicating whether the browser supports the size attribute of HTML <font> elements. (Inherited from HttpCapabilitiesBase.)
Public propertySupportsImageSubmitGets a value indicating whether the browser supports using a custom image in place of a standard form Submit button. (Inherited from HttpCapabilitiesBase.)
Public propertySupportsIModeSymbolsGets a value indicating whether the browser supports i-mode symbols. (Inherited from HttpCapabilitiesBase.)
Public propertySupportsInputIStyleGets a value indicating whether the browser supports the istyle attribute of HTML <input> elements. (Inherited from HttpCapabilitiesBase.)
Public propertySupportsInputModeGets a value indicating whether the browser supports the mode attribute of HTML <input> elements. (Inherited from HttpCapabilitiesBase.)
Public propertySupportsItalicGets a value indicating whether the browser supports HTML <i> elements to format italic text. (Inherited from HttpCapabilitiesBase.)
Public propertySupportsJPhoneMultiMediaAttributesGets a value indicating whether the browser supports J-Phone multimedia attributes. (Inherited from HttpCapabilitiesBase.)
Public propertySupportsJPhoneSymbolsGets a value indicating whether the browser supports J-Phone–specific picture symbols. (Inherited from HttpCapabilitiesBase.)
Public propertySupportsQueryStringInFormActionGets a value indicating whether the browser supports a query string in the action attribute value of HTML <form> elements. (Inherited from HttpCapabilitiesBase.)
Public propertySupportsRedirectWithCookieGets a value indicating whether the browser supports cookies on redirection. (Inherited from HttpCapabilitiesBase.)
Public propertySupportsSelectMultipleGets a value indicating whether the browser supports the multiple attribute of HTML <select> elements. (Inherited from HttpCapabilitiesBase.)
Public propertySupportsUncheckGets a value indicating whether the clearing of a checked HTML <input type=checkbox> element is reflected in postback data. (Inherited from HttpCapabilitiesBase.)
Public propertySupportsXmlHttpGets a value indicating whether the browser supports receiving XML over HTTP. (Inherited from HttpCapabilitiesBase.)
Public propertyTablesGets a value indicating whether the browser supports HTML <table> elements. (Inherited from HttpCapabilitiesBase.)
Public propertyTagWriterInfrastructure. Used internally to get the type of the object that is used to write tags for the browser. (Inherited from HttpCapabilitiesBase.)
Public propertyTypeGets the name and major (integer) version number of the browser. (Inherited from HttpCapabilitiesBase.)
Public propertyUseOptimizedCacheKeyInfrastructure. Used internally to get a value indicating whether to use an optimized cache key. (Inherited from HttpCapabilitiesBase.)
Public propertyVBScriptGets a value indicating whether the browser supports Visual Basic Scripting edition (VBScript). (Inherited from HttpCapabilitiesBase.)
Public propertyVersionGets the full version number (integer and decimal) of the browser as a string. (Inherited from HttpCapabilitiesBase.)
Public propertyW3CDomVersionGets the version of the World Wide Web Consortium (W3C) XML Document Object Model (DOM) that the browser supports. (Inherited from HttpCapabilitiesBase.)
Public propertyWin16Gets a value indicating whether the client is a Win16-based computer. (Inherited from HttpCapabilitiesBase.)
Public propertyWin32Gets a value indicating whether the client is a Win32-based computer. (Inherited from HttpCapabilitiesBase.)
Top

  NameDescription
Public methodAddBrowserInfrastructure. Used internally to add an entry to the internal collection of browsers for which capabilities are recognized. (Inherited from HttpCapabilitiesBase.)
Public methodCreateHtmlTextWriterCreates a new instance of the HtmlTextWriter to be used. (Inherited from HttpCapabilitiesBase.)
Public methodDisableOptimizedCacheKeyInfrastructure. Used internally to disable use of an optimized cache key. (Inherited from HttpCapabilitiesBase.)
Public methodEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetClrVersionsReturns all versions of the .NET Framework common language runtime that are installed on the client. (Inherited from HttpCapabilitiesBase.)
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodInitInfrastructure. Used internally to initialize an internal set of values. (Inherited from HttpCapabilitiesBase.)
Public methodIsBrowserGets a value indicating whether the client browser is the same as the specified browser. (Inherited from HttpCapabilitiesBase.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Top

  NameDescription
Explicit interface implemetationPrivate methodIFilterResolutionService.CompareFiltersInfrastructure. Used internally to compare filters. (Inherited from HttpCapabilitiesBase.)
Explicit interface implemetationPrivate methodIFilterResolutionService.EvaluateFilterInfrastructure. Used internally to evaluate a filter. (Inherited from HttpCapabilitiesBase.)
Top

The HttpBrowserCapabilities properties are accessible through the Browser property of the ASP.NET intrinsic Request object.

TopicLocation
How to: Detect Browser Types in ASP.NET Web PagesBuilding ASP .NET Web Applications
How to: Detect Browser Types in ASP.NET Web PagesBuilding ASP .NET Web Applications

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

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.

Show:
© 2014 Microsoft