MobileCapabilities Class
Note: This API is now obsolete.
Provides a single source for accessing capability information about a client device and for performing queries against device capabilities. For information about how to develop ASP.NET mobile applications, see the www.asp.net/mobile Web site.
System.Web.Configuration.HttpCapabilitiesBase
System.Web.HttpBrowserCapabilities
System.Web.Mobile.MobileCapabilities
Assembly: System.Web.Mobile (in System.Web.Mobile.dll)
[<ObsoleteAttribute("The System.Web.Mobile.dll assembly has been deprecated and should no longer be used. For information about how to develop ASP.NET mobile applications, see http://go.microsoft.com/fwlink/?LinkId=157231.")>] [<AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)>] [<AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)>] type MobileCapabilities = class inherit HttpBrowserCapabilities end
The MobileCapabilities type exposes the following members.
| Name | Description | |
|---|---|---|
![]() | MobileCapabilities | Creates an instance of the MobileCapabilities class. This API is obsolete. For information about how to develop ASP.NET mobile applications, see the www.asp.net/mobile Web site. |
| Name | Description | |
|---|---|---|
![]() | ActiveXControls | Gets a value indicating whether the browser supports ActiveX controls. (Inherited from HttpCapabilitiesBase.) |
![]() | Adapters | Infrastructure. Returns the collection of available control adapters. (Inherited from HttpCapabilitiesBase.) |
![]() | AOL | Gets a value indicating whether the client is an America Online (AOL) browser. (Inherited from HttpCapabilitiesBase.) |
![]() | BackgroundSounds | Gets a value indicating whether the browser supports playing background sounds using the <bgsounds> HTML element. (Inherited from HttpCapabilitiesBase.) |
![]() | Beta | Gets a value indicating whether the browser is a beta version. (Inherited from HttpCapabilitiesBase.) |
![]() | Browser | Gets the browser string (if any) that was sent by the browser in the User-Agent request header. (Inherited from HttpCapabilitiesBase.) |
![]() | Browsers | Gets an ArrayList of the browsers in the Capabilities dictionary. (Inherited from HttpCapabilitiesBase.) |
![]() | CanCombineFormsInDeck | Gets a value indicating whether the browser supports decks that contain multiple forms, such as separate cards. (Inherited from HttpCapabilitiesBase.) |
![]() | CanInitiateVoiceCall | Gets a value indicating whether the browser device is capable of initiating a voice call. (Inherited from HttpCapabilitiesBase.) |
![]() | CanRenderAfterInputOrSelectElement | Gets a value indicating whether the browser supports page content following WML <select> or <input> elements. (Inherited from HttpCapabilitiesBase.) |
![]() | CanRenderEmptySelects | Gets a value indicating whether the browser supports empty HTML <select> elements. (Inherited from HttpCapabilitiesBase.) |
![]() | CanRenderInputAndSelectElementsTogether | Gets a value indicating whether the browser supports WML INPUT and SELECT elements together on the same card. (Inherited from HttpCapabilitiesBase.) |
![]() | CanRenderMixedSelects | Gets a value indicating whether the browser supports WML <option> elements that specify both onpick and value attributes. (Inherited from HttpCapabilitiesBase.) |
![]() | CanRenderOneventAndPrevElementsTogether | Gets a value indicating whether the browser supports WML <onevent> and <prev> elements that coexist within the same WML card. (Inherited from HttpCapabilitiesBase.) |
![]() | CanRenderPostBackCards | Gets a value indicating whether the browser supports WML cards for postback. (Inherited from HttpCapabilitiesBase.) |
![]() | CanRenderSetvarZeroWithMultiSelectionList | Gets a value indicating whether the browser supports WML <setvar> elements with a value attribute of 0. (Inherited from HttpCapabilitiesBase.) |
![]() | CanSendMail | Gets a value indicating whether the browser supports sending e-mail by using the HTML <mailto> element for displaying electronic addresses. (Inherited from HttpCapabilitiesBase.) |
![]() | Capabilities | Infrastructure. Used internally to get the defined capabilities of the browser. (Inherited from HttpCapabilitiesBase.) |
![]() | CDF | Gets a value indicating whether the browser supports Channel Definition Format (CDF) for webcasting. (Inherited from HttpCapabilitiesBase.) |
![]() | ClrVersion | Gets the version of the .NET Framework that is installed on the client. (Inherited from HttpCapabilitiesBase.) |
![]() | Cookies | Gets a value indicating whether the browser supports cookies. (Inherited from HttpCapabilitiesBase.) |
![]() | Crawler | Gets a value indicating whether the browser is a search engine Web crawler. (Inherited from HttpCapabilitiesBase.) |
![]() | DefaultSubmitButtonLimit | Returns the maximum number of Submit buttons that are allowed for a form. (Inherited from HttpCapabilitiesBase.) |
![]() | EcmaScriptVersion | Gets the version number of ECMAScript that the browser supports. (Inherited from HttpCapabilitiesBase.) |
![]() | Frames | Gets a value indicating whether the browser supports HTML frames. (Inherited from HttpCapabilitiesBase.) |
![]() | GatewayMajorVersion | Gets the major version number of the wireless gateway used to access the server, if known. (Inherited from HttpCapabilitiesBase.) |
![]() | GatewayMinorVersion | Gets the minor version number of the wireless gateway used to access the server, if known. (Inherited from HttpCapabilitiesBase.) |
![]() | GatewayVersion | Gets the version of the wireless gateway used to access the server, if known. (Inherited from HttpCapabilitiesBase.) |
![]() | HasBackButton | Gets a value indicating whether the browser has a dedicated Back button. (Inherited from HttpCapabilitiesBase.) |
![]() | HidesRightAlignedMultiselectScrollbars | Gets 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.) |
![]() | HtmlTextWriter | Gets or sets the fully qualified class name of the HtmlTextWriter to use. (Inherited from HttpCapabilitiesBase.) |
![]() | Id | Gets the internal identifier of the browser as specified in the browser definition file. (Inherited from HttpCapabilitiesBase.) |
![]() | InputType | Returns the type of input supported by browser. (Inherited from HttpCapabilitiesBase.) |
![]() | IsColor | Gets a value indicating whether the browser has a color display. (Inherited from HttpCapabilitiesBase.) |
![]() | IsMobileDevice | Gets a value indicating whether the browser is a recognized mobile device. (Inherited from HttpCapabilitiesBase.) |
![]() | Item | Gets the value of the specified browser capability. In C#, this property is the indexer for the class. (Inherited from HttpCapabilitiesBase.) |
![]() | JavaApplets | Gets a value indicating whether the browser supports Java. (Inherited from HttpCapabilitiesBase.) |
![]() | JavaScript | Obsolete. Gets a value indicating whether the browser supports JavaScript. (Inherited from HttpCapabilitiesBase.) |
![]() | JScriptVersion | Gets the Jscript version that the browser supports. (Inherited from HttpCapabilitiesBase.) |
![]() | MajorVersion | Gets the major (integer) version number of the browser. (Inherited from HttpCapabilitiesBase.) |
![]() | MaximumHrefLength | Gets the maximum length in characters for the href attribute of an HTML <a> (anchor) element. (Inherited from HttpCapabilitiesBase.) |
![]() | MaximumRenderedPageSize | Gets the maximum length of the page, in bytes, which the browser can display. (Inherited from HttpCapabilitiesBase.) |
![]() | MaximumSoftkeyLabelLength | Returns the maximum length of the text that a soft-key label can display. (Inherited from HttpCapabilitiesBase.) |
![]() | MinorVersion | Gets the minor (that is, decimal) version number of the browser. (Inherited from HttpCapabilitiesBase.) |
![]() | MinorVersionString | Gets the minor (decimal) version number of the browser as a string. (Inherited from HttpCapabilitiesBase.) |
![]() | MobileDeviceManufacturer | Returns the name of the manufacturer of a mobile device, if known. (Inherited from HttpCapabilitiesBase.) |
![]() | MobileDeviceModel | Gets the model name of a mobile device, if known. (Inherited from HttpCapabilitiesBase.) |
![]() | MSDomVersion | Gets the version of Microsoft HTML (MSHTML) Document Object Model (DOM) that the browser supports. (Inherited from HttpCapabilitiesBase.) |
![]() | NumberOfSoftkeys | Returns the number of soft keys on a mobile device. (Inherited from HttpCapabilitiesBase.) |
![]() | Platform | Gets the name of the platform that the client uses, if it is known. (Inherited from HttpCapabilitiesBase.) |
![]() | PreferredImageMime | Returns the MIME type of the type of image content typically preferred by the browser. (Inherited from HttpCapabilitiesBase.) |
![]() | PreferredRenderingMime | Returns the MIME type of the type of content typically preferred by the browser. (Inherited from HttpCapabilitiesBase.) |
![]() | PreferredRenderingType | Gets the general name for the type of content that the browser prefers. (Inherited from HttpCapabilitiesBase.) |
![]() | PreferredRequestEncoding | Gets the request encoding preferred by the browser. (Inherited from HttpCapabilitiesBase.) |
![]() | PreferredResponseEncoding | Gets the response encoding preferred by the browser. (Inherited from HttpCapabilitiesBase.) |
![]() | RendersBreakBeforeWmlSelectAndInput | Gets a value indicating whether the browser renders a line break before <select> or <input> elements. (Inherited from HttpCapabilitiesBase.) |
![]() | RendersBreaksAfterHtmlLists | Gets a value indicating whether the browser renders a line break after list-item elements. (Inherited from HttpCapabilitiesBase.) |
![]() | RendersBreaksAfterWmlAnchor | Gets a value indicating whether the browser renders a line break after a stand-alone HTML <a> (anchor) element. (Inherited from HttpCapabilitiesBase.) |
![]() | RendersBreaksAfterWmlInput | Gets a value indicating whether the browser renders a line break after an HTML <input> element. (Inherited from HttpCapabilitiesBase.) |
![]() | RendersWmlDoAcceptsInline | Gets 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.) |
![]() | RendersWmlSelectsAsMenuCards | Gets a value indicating whether the browser renders WML <select> elements as menu cards, rather than as a combo box. (Inherited from HttpCapabilitiesBase.) |
![]() | RequiredMetaTagNameValue | Infrastructure. Used internally to produce a meta-tag required by some browsers. (Inherited from HttpCapabilitiesBase.) |
![]() | RequiresAttributeColonSubstitution | Gets a value indicating whether the browser requires colons in element attribute values to be substituted with a different character. (Inherited from HttpCapabilitiesBase.) |
![]() | RequiresContentTypeMetaTag | Gets a value indicating whether the browser requires an HTML <meta> element for which the content-type attribute is specified. (Inherited from HttpCapabilitiesBase.) |
![]() | RequiresControlStateInSession | Gets a value indicating whether the browser requires control state to be maintained in sessions. (Inherited from HttpCapabilitiesBase.) |
![]() | RequiresDBCSCharacter | Gets a value indicating whether the browser requires a double-byte character set. (Inherited from HttpCapabilitiesBase.) |
![]() | RequiresHtmlAdaptiveErrorReporting | Gets a value indicating whether the browser requires nonstandard error messages. (Inherited from HttpCapabilitiesBase.) |
![]() | RequiresLeadingPageBreak | Gets 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.) |
![]() | RequiresNoBreakInFormatting | Gets a value indicating whether the browser does not support HTML <br> elements to format line breaks. (Inherited from HttpCapabilitiesBase.) |
![]() | RequiresOutputOptimization | Gets a value indicating whether the browser requires pages to contain a size-optimized form of markup language tags. (Inherited from HttpCapabilitiesBase.) |
![]() | RequiresPhoneNumbersAsPlainText | Gets a value indicating whether the browser supports phone dialing based on plain text, or whether it requires special markup. (Inherited from HttpCapabilitiesBase.) |
![]() | RequiresSpecialViewStateEncoding | Gets a value indicating whether the browser requires VIEWSTATE values to be specially encoded. (Inherited from HttpCapabilitiesBase.) |
![]() | RequiresUniqueFilePathSuffix | Gets a value indicating whether the browser requires unique form-action URLs. (Inherited from HttpCapabilitiesBase.) |
![]() | RequiresUniqueHtmlCheckboxNames | Gets a value indicating whether the browser requires unique name attribute values of multiple HTML <input type="checkbox"> elements. (Inherited from HttpCapabilitiesBase.) |
![]() | RequiresUniqueHtmlInputNames | Gets a value indicating whether the browser requires unique name attribute values of multiple HTML <input> elements. (Inherited from HttpCapabilitiesBase.) |
![]() | RequiresUrlEncodedPostfieldValues | Gets a value indicating whether postback data sent by the browser will be UrlEncoded. (Inherited from HttpCapabilitiesBase.) |
![]() | ScreenBitDepth | Returns the depth of the display, in bits per pixel. (Inherited from HttpCapabilitiesBase.) |
![]() | ScreenCharactersHeight | Returns the approximate height of the display, in character lines. (Inherited from HttpCapabilitiesBase.) |
![]() | ScreenCharactersWidth | Returns the approximate width of the display, in characters. (Inherited from HttpCapabilitiesBase.) |
![]() | ScreenPixelsHeight | Returns the approximate height of the display, in pixels. (Inherited from HttpCapabilitiesBase.) |
![]() | ScreenPixelsWidth | Returns the approximate width of the display, in pixels. (Inherited from HttpCapabilitiesBase.) |
![]() | SupportsAccesskeyAttribute | Gets a value indicating whether the browser supports the ACCESSKEY attribute of HTML <a> (anchor) and <input> elements. (Inherited from HttpCapabilitiesBase.) |
![]() | SupportsBodyColor | Gets a value indicating whether the browser supports the bgcolor attribute of the HTML <body> element. (Inherited from HttpCapabilitiesBase.) |
![]() | SupportsBold | Gets a value indicating whether the browser supports HTML <b> elements to format bold text. (Inherited from HttpCapabilitiesBase.) |
![]() | SupportsCacheControlMetaTag | Gets a value indicating whether the browser supports the cache-control value for the http-equiv attribute of HTML <meta> elements. (Inherited from HttpCapabilitiesBase.) |
![]() | SupportsCallback | Gets a value indicating whether the browser supports callback scripts. (Inherited from HttpCapabilitiesBase.) |
![]() | SupportsCss | Gets a value indicating whether the browser supports Cascading Style Sheets (CSS). (Inherited from HttpCapabilitiesBase.) |
![]() | SupportsDivAlign | Gets a value indicating whether the browser supports the align attribute of HTML <div> elements. (Inherited from HttpCapabilitiesBase.) |
![]() | SupportsDivNoWrap | Gets a value indicating whether the browser supports the nowrap attribute of HTML <div> elements. (Inherited from HttpCapabilitiesBase.) |
![]() | SupportsEmptyStringInCookieValue | Gets a value indicating whether the browser supports empty (a null reference (Nothing in Visual Basic)) strings in cookie values. (Inherited from HttpCapabilitiesBase.) |
![]() | SupportsFontColor | Gets a value indicating whether the browser supports the color attribute of HTML <font> elements. (Inherited from HttpCapabilitiesBase.) |
![]() | SupportsFontName | Gets a value indicating whether the browser supports the name attribute of HTML <font> elements. (Inherited from HttpCapabilitiesBase.) |
![]() | SupportsFontSize | Gets a value indicating whether the browser supports the size attribute of HTML <font> elements. (Inherited from HttpCapabilitiesBase.) |
![]() | SupportsImageSubmit | Gets a value indicating whether the browser supports using a custom image in place of a standard form Submit button. (Inherited from HttpCapabilitiesBase.) |
![]() | SupportsIModeSymbols | Gets a value indicating whether the browser supports i-mode symbols. (Inherited from HttpCapabilitiesBase.) |
![]() | SupportsInputIStyle | Gets a value indicating whether the browser supports the istyle attribute of HTML <input> elements. (Inherited from HttpCapabilitiesBase.) |
![]() | SupportsInputMode | Gets a value indicating whether the browser supports the mode attribute of HTML <input> elements. (Inherited from HttpCapabilitiesBase.) |
![]() | SupportsItalic | Gets a value indicating whether the browser supports HTML <i> elements to format italic text. (Inherited from HttpCapabilitiesBase.) |
![]() | SupportsJPhoneMultiMediaAttributes | Gets a value indicating whether the browser supports J-Phone multimedia attributes. (Inherited from HttpCapabilitiesBase.) |
![]() | SupportsJPhoneSymbols | Gets a value indicating whether the browser supports J-Phone–specific picture symbols. (Inherited from HttpCapabilitiesBase.) |
![]() | SupportsQueryStringInFormAction | Gets a value indicating whether the browser supports a query string in the action attribute value of HTML <form> elements. (Inherited from HttpCapabilitiesBase.) |
![]() | SupportsRedirectWithCookie | Gets a value indicating whether the browser supports cookies on redirection. (Inherited from HttpCapabilitiesBase.) |
![]() | SupportsSelectMultiple | Gets a value indicating whether the browser supports the multiple attribute of HTML <select> elements. (Inherited from HttpCapabilitiesBase.) |
![]() | SupportsUncheck | Gets a value indicating whether the clearing of a checked HTML <input type=checkbox> element is reflected in postback data. (Inherited from HttpCapabilitiesBase.) |
![]() | SupportsXmlHttp | Gets a value indicating whether the browser supports receiving XML over HTTP. (Inherited from HttpCapabilitiesBase.) |
![]() | Tables | Gets a value indicating whether the browser supports HTML <table> elements. (Inherited from HttpCapabilitiesBase.) |
![]() | TagWriter | Infrastructure. Used internally to get the type of the object that is used to write tags for the browser. (Inherited from HttpCapabilitiesBase.) |
![]() | Type | Gets the name and major (integer) version number of the browser. (Inherited from HttpCapabilitiesBase.) |
![]() | UseOptimizedCacheKey | Used internally to get a value indicating whether to use an optimized cache key. (Inherited from HttpCapabilitiesBase.) |
![]() | VBScript | Gets a value indicating whether the browser supports Visual Basic Scripting edition (VBScript). (Inherited from HttpCapabilitiesBase.) |
![]() | Version | Gets the full version number (integer and decimal) of the browser as a string. (Inherited from HttpCapabilitiesBase.) |
![]() | W3CDomVersion | Gets the version of the World Wide Web Consortium (W3C) XML Document Object Model (DOM) that the browser supports. (Inherited from HttpCapabilitiesBase.) |
![]() | Win16 | Gets a value indicating whether the client is a Win16-based computer. (Inherited from HttpCapabilitiesBase.) |
![]() | Win32 | Gets a value indicating whether the client is a Win32-based computer. (Inherited from HttpCapabilitiesBase.) |
| Name | Description | |
|---|---|---|
![]() | AddBrowser | Infrastructure. Used internally to add an entry to the internal collection of browsers for which capabilities are recognized. (Inherited from HttpCapabilitiesBase.) |
![]() | CreateHtmlTextWriter | Creates a new instance of the HtmlTextWriter to be used. (Inherited from HttpCapabilitiesBase.) |
![]() | DisableOptimizedCacheKey | Used internally to disable use of an optimized cache key. (Inherited from HttpCapabilitiesBase.) |
![]() | Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
![]() | Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
![]() | GetClrVersions | Returns all versions of the .NET Framework common language runtime that are installed on the client. (Inherited from HttpCapabilitiesBase.) |
![]() | GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() | HasCapability | Provides a uniform way to evaluate device capabilities. This method is used internally by ASP.NET to implement various device-selection criteria expressed in the syntax of the controls. For example, this method is used to choose among <Choice> Element (.NET Framework Developer's Guide ) elements in a DeviceSpecific/Choice construct. This API is obsolete. For information about how to develop ASP.NET mobile applications, see the www.asp.net/mobile Web site. |
![]() | Init | Infrastructure. Used internally to initialize an internal set of values. (Inherited from HttpCapabilitiesBase.) |
![]() | IsBrowser | Gets a value indicating whether the client browser is the same as the specified browser. (Inherited from HttpCapabilitiesBase.) |
![]() | MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
![]() | ToString | Returns a string that represents the current object. (Inherited from Object.) |
| Name | Description | |
|---|---|---|
![]() ![]() | PreferredRenderingTypeChtml10 | Returns the source identifier to use for compact HTML 1.0. This field is read-only. This API is obsolete. For information about how to develop ASP.NET mobile applications, see the www.asp.net/mobile Web site. |
![]() ![]() | PreferredRenderingTypeHtml32 | Returns the source identifier to use for HTML 3.2. This field is read-only. This API is obsolete. For information about how to develop ASP.NET mobile applications, see the www.asp.net/mobile Web site. |
![]() ![]() | PreferredRenderingTypeWml11 | Returns the source identifier to use for WML 1.1. This field is read-only. This API is obsolete. For information about how to develop ASP.NET mobile applications, see the www.asp.net/mobile Web site. |
![]() ![]() | PreferredRenderingTypeWml12 | Returns the source identifier to use for WML 1.2. This field is read-only. This API is obsolete. For information about how to develop ASP.NET mobile applications, see the www.asp.net/mobile Web site. |
| Name | Description | |
|---|---|---|
![]() ![]() | IFilterResolutionService.CompareFilters | Infrastructure. Used internally to compare filters. (Inherited from HttpCapabilitiesBase.) |
![]() ![]() | IFilterResolutionService.EvaluateFilter | Infrastructure. Used internally to evaluate a filter. (Inherited from HttpCapabilitiesBase.) |
The MobileCapabilities class extends the HttpBrowserCapabilities class. The MobileCapabilities class offers a large number of read-only properties that provide type-safe access to the Browser object's capabilities dictionary.
You can use the Browser property of the HttpRequest object to point to an instance of a MobileCapabilities object, which can then be used to read the capabilities of the requesting browser and device.
During the page load, the MobileCapabilities object obtains the capabilities through the Browser property as previously discussed. The PreferredRenderingMime and the ScreenCharactersWidth properties of the MobileCapabilities object report back to the browser by setting properties on the HttpResponse object and also by programmatically setting the Text property of certain controls on the page.
<%@ Page Inherits="System.Web.UI.MobileControls.MobilePage" Language="c#" %> <script language="c#" runat="server"> public void Page_Load(Object sender, EventArgs e) { System.Web.Mobile.MobileCapabilities currentCapabilities; MobileCapabilities currentCapabilities = (MobileCapabilities)Request.Browser; // Programatically find the mobile capabilities without using // DeviceSpecific Filters. if(currentCapabilities.PreferredRenderingMIME=="text/html") { Label2.Text = "You are using an html supported device."; } else if(currentCapabilities.PreferredRenderingMIME == "text/vnd.wap.wml") { Label2.Text = "You are using a wml supported device."; } Label1.Text = "Screen Width (chars): " + currentCapabilities.ScreenCharactersWidth; } </script> <Mobile:Form runat="server" id=frmTemplate > <mobile:label ID="Label1" runat="server" /> <mobile:label ID="Label2" runat="server" /> </Mobile:Form>
- AspNetHostingPermission
for operating in a hosted environment. Demand value: LinkDemand; Permission value: Minimal.
- AspNetHostingPermission
for operating in a hosted environment. Demand value: InheritanceDemand; Permission value: Minimal.
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
