Cómo: Agregar controles Literal de servidor Web a una página de formularios Web Forms (Visual Studio)

Actualización: noviembre 2007

Puede agregar un control Literal de servidor Web a la página de formularios Web Forms cuando desee establecer texto mediante programación sin agregar etiquetas HTML adicionales. El control Literal es un medio útil para agregar texto a una página dinámicamente sin necesidad de agregar ningún elemento que no forme parte del texto dinámico. Por ejemplo, puede utilizar el control Literal para mostrar el código HTML que se lee en un archivo o una secuencia.

Nota:

Si desea mostrar texto estático, puede presentarlo mediante HTML; no necesita ningún control Literal. Utilice solamente un control Literal si debe cambiar el contenido dinámicamente en el código del servidor.

Para agregar un control Literal de servidor Web a una página de formularios Web Forms

  1. Desde la ficha Estándar del Cuadro de herramientas, arrastre un control Literal a la página.

  2. Si lo desea, en la categoría Comportamiento de la ventana Propiedades, establezca la propiedad Mode en Transform, PassThrough o Encode. La propiedad Mode especifica el modo en que el control supervisa el marcado que se agrega a él. Para obtener información detallada, vea Información general sobre Literal (Control de servidor Web).

    En el siguiente ejemplo se muestra una página Web sencilla que muestra un titular en tiempo de ejecución. El cuerpo de la página, incluido el control Literal, podría parecerse a éste:

    <body>
  <form >
    <h1><asp:Literal id="Headline" runat=server 
      mode="PassThrough"/></h1>
  </form>
</body>

  3. Agregue código a la página para establecer la propiedad Text del control en tiempo de ejecución.

    En el ejemplo siguiente se muestra cómo se establece el texto del control Literal mediante programación. La página contiene botones de opción que permiten al usuario elegir entre texto codificado y texto paso a través.

    Nota:

    Si establece la propiedad Text en un texto que se ha obtenido de un origen que no es de confianza, establezca la propiedad Mode del control en Encode para que el marcado no genere marcado ejecutable.

    		 
    <%@ Page Language="VB" %>
<script >
Protected Sub Page_Load(ByVal sender As Object, _
    ByVal e As System.EventArgs)
    Literal1.Text = "This <b>text</b> is inserted dynamically."
    If radioEncode.Checked = True Then
        Literal1.Mode = LiteralMode.Encode
    ElseIf radioPassthrough.Checked = True Then
        Literal1.Mode = LiteralMode.PassThrough
    End If
End Sub
</script>

<html>
<head ></head>
<body>
<form id="form1" >
<div>
    <br />
    <asp:RadioButton 
        ID="radioEncode" 

        GroupName="LiteralMode" 
        Checked="True" 
        Text="Encode" 
        AutoPostBack="True" />
    <br />
    <asp:RadioButton 
        ID="radioPassthrough" 

        GroupName="LiteralMode" 
        Text="PassThrough" 
        AutoPostBack="True" />
    <br />
    <br />
    <asp:Literal ID="Literal1" ></asp:Literal>
</div>
</form>
</body>
</html>

    <%@ Page Language="C#" %>
<script >
    protected void Page_Load(object sender, EventArgs e)
    {
        Literal1.Text = "This <b>text</b> is inserted dynamically.";
        if (radioEncode.Checked == true)
        {
            Literal1.Mode = LiteralMode.Encode;
        }
        if(radioPassthrough.Checked == true)
        {
            Literal1.Mode = LiteralMode.PassThrough;
        }
    }
</script>
</script>

<html>
<head ></head>
<body>
    <form id="form1" >
    <div>
        <br />
        <asp:RadioButton 
            ID="radioEncode" 

            GroupName="LiteralMode" 
            Checked="True" 
            Text="Encode" 
            AutoPostBack="True" />
        <br />
        <asp:RadioButton 
            ID="radioPassthrough" 

            GroupName="LiteralMode" 
            Text="PassThrough" 
            AutoPostBack="True" />
        <br />
        <br />
        <asp:Literal ID="Literal1" ></asp:Literal>&nbsp;</div>
    </form>
</body>
</html>

Vea también

Referencia

Información general sobre Literal (Control de servidor Web)

  • Last updated on