2 // System.Web.UI.WebControls.Literal.cs
5 // Jackson Harper (jackson@ximian.com)
7 // (C) 2005 Novell, Inc (http://www.novell.com)
9 // Permission is hereby granted, free of charge, to any person obtaining
10 // a copy of this software and associated documentation files (the
11 // "Software"), to deal in the Software without restriction, including
12 // without limitation the rights to use, copy, modify, merge, publish,
13 // distribute, sublicense, and/or sell copies of the Software, and to
14 // permit persons to whom the Software is furnished to do so, subject to
15 // the following conditions:
17 // The above copyright notice and this permission notice shall be
18 // included in all copies or substantial portions of the Software.
20 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
21 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
22 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
23 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
24 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
25 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
26 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
29 using System.ComponentModel;
30 using System.Security.Permissions;
32 namespace System.Web.UI.WebControls {
35 [AspNetHostingPermissionAttribute (SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
36 [AspNetHostingPermissionAttribute (SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
38 [ControlBuilder(typeof(LiteralControlBuilder))]
39 [DataBindingHandler("System.Web.UI.Design.TextDataBindingHandler, " + Consts.AssemblySystem_Design)]
40 [DefaultProperty("Text")]
42 [Designer ("System.Web.UI.Design.WebControls.LiteralDesigner, " + Consts.AssemblySystem_Design, "System.ComponentModel.Design.IDesigner")]
44 public class Literal : Control
55 [DefaultValue (LiteralMode.Transform)]
56 [WebSysDescription ("")]
57 [WebCategory ("Behavior")]
58 public LiteralMode Mode
61 return ViewState ["Mode"] == null ? LiteralMode.Transform : (LiteralMode) ViewState ["Mode"];
64 if (((int) value) < 0 || ((int) value) > 2)
65 throw new ArgumentOutOfRangeException ();
66 ViewState ["Mode"] = value;
73 [WebSysDescription ("")]
74 [WebCategory ("Appearance")]
80 return ViewState.GetString ("Text", String.Empty);
83 ViewState ["Text"] = value;
88 [EditorBrowsable (EditorBrowsableState.Never)]
89 public override void Focus ()
91 throw new NotSupportedException ();
95 protected override ControlCollection CreateControlCollection ()
97 return new EmptyControlCollection (this);
100 protected override void AddParsedSubObject (object obj)
102 LiteralControl literal = obj as LiteralControl;
103 if (literal != null) {
108 throw new HttpException (Locale.GetText (
109 "'Literal' cannot have children of type '{0}'",
118 override void Render (HtmlTextWriter output)
121 if (Mode == LiteralMode.Encode)
122 output.Write (HttpUtility.HtmlEncode (Text));