Mobile Fields to ASP.NET Controls Map

Applies to: SharePoint Foundation 2010

The following tables provide information about how Microsoft SharePoint Foundation field types that are used in mobile forms are mapped to Microsoft ASP.NET mobile controls.

Read-Only Controls in Mobile Display Forms

SharePoint Foundation Field Type	ASP.NET Mobile Control	Comment
Single line of text	Label	Same as ASP.NET control except for rendering of ellipses.
Multiple lines of text	TextView	Renders plain text of rich HTML text field type.
Choice	Label	Same as ASP.NET control except for rendering of ellipses.
Number	Label	Uses SharePoint Foundation field type controls for format conversion.
Currency	Label	Uses SharePoint Foundation field type controls for format conversion.
Date and time	Label	Uses code in SharePoint Foundation field type controls for local date/time conversion.
Lookup	Label	Does not support presence or linking to user information.
Yes/no	Label	Same as ASP.NET control except for rendering of ellipses.
Hyperlink or picture	Link	Same as ASP.NET control except for rendering of ellipses.
Calculated	Label	Same as ASP.NET control except for rendering of ellipses.
Attachment	Link	The number of attachments to display is limited. Up to three attachments are displayed, which is set by a rendering limit. See Ellipses and Rendering Limits.
Recurrence field	Label	Same as ASP.NET control except for rendering of ellipses.
Person or Group	Label	Does not support presence or linking to user information.

Read/Write Controls in New or Edit Forms

Note

Any control that exceeds a rendering limit becomes read-only even if it is nominally read/write. For more information, see Ellipses and Rendering Limits.

SharePoint Foundation Field Type	ASP.NET Mobile Control	Comment
Single line of text	TextBox	Displays read-only Label control the same as in a Display form if the data to edit exceeds a maximum character limit.
Multiple lines of text	TextBox	Displays read-only Label control the same as in a Display form if the data to edit exceeds a maximum character limit. If the markup language of the current browser is not Wireless Markup Language (WML), the TextBox control is used. The TextBox control does not support rich HTML text formatting, and so in the Edit form, if the field type is rich HTML text, the field is rendered as a read-only control. However, in the New form, the TextBox control is used even when the field is in rich HTML text format.
Choice	SelectionList	Supports drop-down list boxes only, and allows multiple selections. In the New form, if the number of choice options exceeds a maximum number, the first n options (n = maximum number) are displayed. In the Edit form, a read-only Label control is displayed.
Number	TextBox
Currency	TextBox
Date and time	TextBox	Displays description text. Does not support the calendar date picker. The current locale in SharePoint Foundation determines the date and time input format. The following types of calendars are supported: Gregorian, Japanese Emperor Era, Korean Tangun Era, Hijri, Buddhist, Hebrew Lunar, Gregorian Middle East French, Gregorian Arabic, Gregorian Transliterated English, Gregorian Transliterated French, and Saka Era.
Lookup	SelectionList	The maximum limit behavior is the same as for the Choice field type.
Yes/no	SelectionList	Same as ASP.NET control except for rendering of ellipses.
Hyperlink or picture	TextBox	If the display name of the hyperlink or picture exceeds a maximum character limit, the remaining characters are truncated and an ellipsis (...) is appended. The URL itself is not truncated. For the limit, see Ellipses and Rendering Limits.
Name	TextBox	Read-only in Edit form. Does not support the New form for document libraries.
Person or Group	SelectionList	The cutoff maximum limit behavior is the same as for the Choice field type. When multiple selection is not enabled, a Button, which navigates user to the people picker form, is rendered right next to the SelectionList.

See Also

Concepts

Overview of Mobile Pages and the Redirection System