mcs/class/System.Web/System.Web.UI.WebControls/Literal.cs

   1 //
   2 // System.Web.UI.WebControls.Literal.cs
   3 //
   4 // Authors:
   5 //      Jackson Harper (jackson@ximian.com)
   6 //
   7 // (C) 2005 Novell, Inc (http://www.novell.com)
   8 //
   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:
  16 //
  17 // The above copyright notice and this permission notice shall be
  18 // included in all copies or substantial portions of the Software.
  19 //
  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.
  27 //
  28
  29 using System.ComponentModel;
  30 using System.Security.Permissions;
  31
  32 namespace System.Web.UI.WebControls {
  33
  34         // CAS
  35         [AspNetHostingPermissionAttribute (SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
  36         [AspNetHostingPermissionAttribute (SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
  37         // attributes
  38         [ControlBuilder(typeof(LiteralControlBuilder))]
  39         [DataBindingHandler("System.Web.UI.Design.TextDataBindingHandler, " + Consts.AssemblySystem_Design)]
  40         [DefaultProperty("Text")]
  41 #if NET_2_0
  42         [Designer ("System.Web.UI.Design.WebControls.LiteralDesigner, " + Consts.AssemblySystem_Design, "System.ComponentModel.Design.IDesigner")]
  43 #endif
  44         public class Literal : Control
  45 #if NET_2_0
  46         , ITextControl
  47 #endif
  48         {
  49
  50                 public Literal ()
  51                 {
  52                 }
  53
  54 #if NET_2_0
  55                 [DefaultValue (LiteralMode.Transform)]
  56                 [WebSysDescription ("")]
  57                 [WebCategory ("Behavior")]
  58                 public LiteralMode Mode
  59                 {
  60                         get {
  61                                 return ViewState ["Mode"] == null ? LiteralMode.Transform : (LiteralMode) ViewState ["Mode"];
  62                         }
  63                         set {
  64                                 if (((int) value) < 0 || ((int) value) > 2)
  65                                         throw new ArgumentOutOfRangeException ();
  66                                 ViewState ["Mode"] = value;
  67                         }
  68                 }
  69 #endif
  70
  71                 [Bindable(true)]
  72                 [DefaultValue("")]
  73                 [WebSysDescription ("")]
  74                 [WebCategory ("Appearance")]
  75 #if NET_2_0
  76                 [Localizable (true)]
  77 #endif
  78                 public string Text {
  79                         get {
  80                                 return ViewState.GetString ("Text", String.Empty);
  81                         }
  82                         set {
  83                                 ViewState ["Text"] = value;
  84                         }
  85                 }
  86
  87 #if NET_2_0
  88                 [EditorBrowsable (EditorBrowsableState.Never)]
  89                 public override void Focus ()
  90                 {
  91                         throw new NotSupportedException ();
  92                 }
  93 #endif
  94
  95                 protected override ControlCollection CreateControlCollection ()
  96                 {
  97                         return new EmptyControlCollection (this);
  98                 }
  99
 100                 protected override void AddParsedSubObject (object obj)
 101                 {
 102                         LiteralControl literal = obj as LiteralControl;
 103                         if (literal != null) {
 104                                 Text = literal.Text;
 105                                 return;
 106                         }
 107
 108                         throw new HttpException (Locale.GetText (
 109                               "'Literal' cannot have children of type '{0}'",
 110                               obj.GetType ()));
 111                 }
 112
 113 #if NET_2_0
 114                 protected internal
 115 #else
 116                 protected
 117 #endif
 118                 override void Render (HtmlTextWriter output)
 119                 {
 120 #if NET_2_0
 121                         if (Mode == LiteralMode.Encode)
 122                                 output.Write (HttpUtility.HtmlEncode (Text));
 123                         else
 124 #endif
 125                         output.Write (Text);
 126                 }
 127         }
 128 }
 129