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         [Designer ("System.Web.UI.Design.WebControls.LiteralDesigner, " + Consts.AssemblySystem_Design, "System.ComponentModel.Design.IDesigner")]
  42         public class Literal : Control
  43         , ITextControl
  44         {
  45
  46                 public Literal ()
  47                 {
  48                 }
  49
  50                 [DefaultValue (LiteralMode.Transform)]
  51                 [WebSysDescription ("")]
  52                 [WebCategory ("Behavior")]
  53                 public LiteralMode Mode
  54                 {
  55                         get {
  56                                 return ViewState ["Mode"] == null ? LiteralMode.Transform : (LiteralMode) ViewState ["Mode"];
  57                         }
  58                         set {
  59                                 if (((int) value) < 0 || ((int) value) > 2)
  60                                         throw new ArgumentOutOfRangeException ();
  61                                 ViewState ["Mode"] = value;
  62                         }
  63                 }
  64
  65                 [Bindable(true)]
  66                 [DefaultValue("")]
  67                 [WebSysDescription ("")]
  68                 [WebCategory ("Appearance")]
  69                 [Localizable (true)]
  70                 public string Text {
  71                         get {
  72                                 return ViewState.GetString ("Text", String.Empty);
  73                         }
  74                         set {
  75                                 ViewState ["Text"] = value;
  76                         }
  77                 }
  78
  79                 [EditorBrowsable (EditorBrowsableState.Never)]
  80                 public override void Focus ()
  81                 {
  82                         throw new NotSupportedException ();
  83                 }
  84
  85                 protected override ControlCollection CreateControlCollection ()
  86                 {
  87                         return new EmptyControlCollection (this);
  88                 }
  89
  90                 protected override void AddParsedSubObject (object obj)
  91                 {
  92                         LiteralControl literal = obj as LiteralControl;
  93                         if (literal != null) {
  94                                 Text = literal.Text;
  95                                 return;
  96                         }
  97
  98                         throw new HttpException (Locale.GetText (
  99                               "'Literal' cannot have children of type '{0}'",
 100                               obj.GetType ()));
 101                 }
 102
 103                 protected internal
 104                 override void Render (HtmlTextWriter writer)
 105                 {
 106                         if (Mode == LiteralMode.Encode)
 107                                 writer.Write (HttpUtility.HtmlEncode (Text));
 108                         else
 109                         writer.Write (Text);
 110                 }
 111         }
 112 }
 113