MobileCapabilities Class

Definition

Warning

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 Mobile Apps & Sites with ASP.NET.

public ref class MobileCapabilities : System::Web::HttpBrowserCapabilities
[System.Obsolete("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 https://go.microsoft.com/fwlink/?LinkId=157231.")]
public class MobileCapabilities : System.Web.HttpBrowserCapabilities
type MobileCapabilities = class
    inherit HttpBrowserCapabilities
Public Class MobileCapabilities
Inherits HttpBrowserCapabilities
Inheritance
Attributes

Examples

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;  
    // Programmatically 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>  

Remarks

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.

Constructors

MobileCapabilities()

Creates an instance of the MobileCapabilities class. This API is obsolete. For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with ASP.NET.

Fields

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 Mobile Apps & Sites with ASP.NET.

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 Mobile Apps & Sites with ASP.NET.

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 Mobile Apps & Sites with ASP.NET.

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 Mobile Apps & Sites with ASP.NET.

Properties

ActiveXControls

Gets a value indicating whether the client browser supports ActiveX controls.

(Inherited from HttpBrowserCapabilities)
Adapters

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 HttpBrowserCapabilities)
BackgroundSounds

Gets a value indicating whether the client browser supports background sounds.

(Inherited from HttpBrowserCapabilities)
Beta

Gets a value indicating whether the browser is a beta release.

(Inherited from HttpBrowserCapabilities)
Browser

Gets the browser string (if any) that was transmitted in the User-Agent header.

(Inherited from HttpBrowserCapabilities)
Browsers

Gets an ArrayList of the browsers in the Capabilities dictionary.

(Inherited from HttpCapabilitiesBase)
CanCombineFormsInDeck
CanInitiateVoiceCall
CanRenderAfterInputOrSelectElement
CanRenderEmptySelects
CanRenderInputAndSelectElementsTogether
CanRenderMixedSelects
CanRenderOneventAndPrevElementsTogether
CanRenderPostBackCards
CanRenderSetvarZeroWithMultiSelectionList
CanSendMail
Capabilities

Used internally to get the defined capabilities of the browser.

(Inherited from HttpCapabilitiesBase)
CDF

Gets a value indicating whether the client browser supports Channel Definition Format (CDF) for webcasting.

(Inherited from HttpBrowserCapabilities)
ClrVersion

Gets the version number of the .NET common language runtime installed on the client.

(Inherited from HttpBrowserCapabilities)
Cookies

Gets a value indicating whether the client browser supports cookies.

(Inherited from HttpBrowserCapabilities)
Crawler

Gets a value indicating whether the client browser is a Web crawler search engine.

(Inherited from HttpBrowserCapabilities)
DefaultSubmitButtonLimit
EcmaScriptVersion

Gets the version number of ECMA script that the client browser supports.

(Inherited from HttpBrowserCapabilities)
Frames

Gets a value indicating whether the client browser supports HTML frames.

(Inherited from HttpBrowserCapabilities)
GatewayMajorVersion
GatewayMinorVersion
GatewayVersion
HasBackButton
HidesRightAlignedMultiselectScrollbars
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
IsColor
IsMobileDevice
Item[String]

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 client browser supports Java applets.

(Inherited from HttpBrowserCapabilities)
JavaScript

Gets a value indicating whether the client browser supports JavaScript.

(Inherited from HttpBrowserCapabilities)
JScriptVersion

Gets the JScript version that the browser supports.

(Inherited from HttpCapabilitiesBase)
MajorVersion

Gets the major (that is, integer) version number of the client browser.

(Inherited from HttpBrowserCapabilities)
MaximumHrefLength

Gets the maximum length in characters for the href attribute of an HTML <a> (anchor) element.

(Inherited from HttpCapabilitiesBase)
MaximumRenderedPageSize
MaximumSoftkeyLabelLength
MinorVersion

Gets the minor (that is, decimal) version number of the client browser.

(Inherited from HttpBrowserCapabilities)
MinorVersionString

Gets the minor (decimal) version number of the browser as a string.

(Inherited from HttpCapabilitiesBase)
MobileDeviceManufacturer
MobileDeviceModel
MSDomVersion

Gets the version of Microsoft HTML (MSHTML) Document Object Model (DOM) that the client browser supports.

(Inherited from HttpBrowserCapabilities)
NumberOfSoftkeys
Platform

Gets the name of the platform that the client uses.

(Inherited from HttpBrowserCapabilities)
PreferredImageMime
PreferredRenderingMime
PreferredRenderingType
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
RendersBreaksAfterHtmlLists
RendersBreaksAfterWmlAnchor
RendersBreaksAfterWmlInput
RendersWmlDoAcceptsInline
RendersWmlSelectsAsMenuCards
RequiredMetaTagNameValue
RequiresAttributeColonSubstitution
RequiresContentTypeMetaTag
RequiresControlStateInSession

Gets a value indicating whether the browser requires control state to be maintained in sessions.

(Inherited from HttpCapabilitiesBase)
RequiresDBCSCharacter
RequiresHtmlAdaptiveErrorReporting
RequiresLeadingPageBreak
RequiresNoBreakInFormatting
RequiresOutputOptimization
RequiresPhoneNumbersAsPlainText
RequiresSpecialViewStateEncoding
RequiresUniqueFilePathSuffix
RequiresUniqueHtmlCheckboxNames
RequiresUniqueHtmlInputNames
RequiresUrlEncodedPostfieldValues
ScreenBitDepth
ScreenCharactersHeight
ScreenCharactersWidth
ScreenPixelsHeight
ScreenPixelsWidth
SupportsAccesskeyAttribute
SupportsBodyColor
SupportsBold
SupportsCacheControlMetaTag
SupportsCallback

Gets a value indicating whether the browser supports callback scripts.

(Inherited from HttpCapabilitiesBase)
SupportsCss
SupportsDivAlign
SupportsDivNoWrap
SupportsEmptyStringInCookieValue
SupportsFontColor
SupportsFontName
SupportsFontSize
SupportsImageSubmit
SupportsIModeSymbols
SupportsInputIStyle
SupportsInputMode
SupportsItalic
SupportsJPhoneMultiMediaAttributes
SupportsJPhoneSymbols
SupportsQueryStringInFormAction
SupportsRedirectWithCookie
SupportsSelectMultiple
SupportsUncheck
SupportsXmlHttp

Gets a value indicating whether the browser supports receiving XML over HTTP.

(Inherited from HttpCapabilitiesBase)
Tables

Gets a value indicating whether the client browser supports HTML tables.

(Inherited from HttpBrowserCapabilities)
TagWriter

Used internally to get the type of the object that is used to write tags for the browser.

(Inherited from HttpBrowserCapabilities)
Type

Gets the name and major (that is, integer) version number of the client browser.

(Inherited from HttpBrowserCapabilities)
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 client browser supports VBScript.

(Inherited from HttpBrowserCapabilities)
Version

Gets the full version number (integer and decimal) of the browser as a string.

(Inherited from HttpBrowserCapabilities)
W3CDomVersion

Gets the version of the World Wide Web Consortium (W3C) XML Document Object Model (DOM) that the client browser supports.

(Inherited from HttpBrowserCapabilities)
Win16

Gets a value indicating whether the client is a Win16-based computer.

(Inherited from HttpBrowserCapabilities)
Win32

Gets a value indicating whether the client is a Win32-based computer.

(Inherited from HttpBrowserCapabilities)

Methods

AddBrowser(String)

Used internally to add an entry to the internal collection of browsers for which capabilities are recognized.

(Inherited from HttpCapabilitiesBase)
CreateHtmlTextWriter(TextWriter)

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)
GetClrVersions()

Returns all versions of the .NET common language runtime (CLR) installed on the client.

(Inherited from HttpBrowserCapabilities)
GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetType()

Gets the Type of the current instance.

(Inherited from Object)
HasCapability(String, String)

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 Mobile Apps & Sites with ASP.NET.

Init()

Used internally to initialize an internal set of values.

(Inherited from HttpCapabilitiesBase)
IsBrowser(String)

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)

Explicit Interface Implementations

IFilterResolutionService.CompareFilters(String, String)

Used internally to compare filters.

(Inherited from HttpCapabilitiesBase)
IFilterResolutionService.EvaluateFilter(String)

Used internally to evaluate a filter.

(Inherited from HttpCapabilitiesBase)

Security

AspNetHostingPermission
for operating in a hosted environment. Demand value: InheritanceDemand; Permission value: Minimal.

Applies to

See also