Compartir a través de


Literal.Text Propiedad

Definición

Obtiene o establece el título que se muestra en el control Literal.

public:
 property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
public string Text { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.Text : string with get, set
Public Property Text As String

Valor de propiedad

Título que se muestra en el control Literal.

Implementaciones

Atributos

Ejemplos

En el ejemplo siguiente se muestra cómo usar la Text propiedad para cambiar mediante programación el título que se muestra en el Literal control .

Nota

En el ejemplo siguiente se usa el modelo de código de un solo archivo y es posible que no funcione correctamente si se copia directamente en un archivo de código subyacente. Este ejemplo de código debe copiarse en un archivo de texto vacío que tenga una extensión .aspx. Para obtener más información sobre el modelo de código de Formularios Web Forms, vea ASP.NET modelo de código de página de formularios web Forms.


<%@ Page Language="C#" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>Literal Example</title>
<script runat="server">

      void ButtonClick(Object sender, EventArgs e)
      {
         Literal1.Text="Welcome to ASP.NET!!";
      }

   </script>

</head>
<body>
   <form id="form1" runat="server">
      <h3>Literal Example</h3>

      <asp:Literal id="Literal1"
           Text="Hello World!!"
           runat="server"/>

      <br /><br />

      <asp:Button id="Button1"
           Text="Change Literal Text"
           OnClick="ButtonClick"
           runat="server"/>

   </form>
</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>Literal Example</title>
<script runat="server">

      Sub ButtonClick(sender As Object, e As EventArgs)
      
         Literal1.Text="Welcome to ASP.NET!!"
      
      End Sub

   </script>

</head>
<body>
   <form id="form1" runat="server">
      <h3>Literal Example</h3>

      <asp:Literal id="Literal1"
           Text="Hello World!!"
           runat="server"/>

      <br /><br />

      <asp:Button id="Button1"
           Text="Change Literal Text"
           OnClick="ButtonClick"
           runat="server"/>

   </form>
</body>
</html>

Comentarios

Utilice la Text propiedad para especificar o determinar el título que se muestra en el Literal control . Esto le permite cambiar mediante programación el título en tiempo de ejecución.

El título está descodificado en HTML en función de cómo asigne un valor a esta propiedad. Si asigna un valor a través de un atributo del Literal control, el valor se descodifica en HTML antes de mostrarlo. Por ejemplo, <asp:Literal id="DisplayLiteral" Text="A&nbsp;B"/> se representa como "A B" en el explorador. Sin embargo, si establece esta propiedad mediante programación o coloca el texto entre las etiquetas de apertura y cierre del control, el título no está descodificado en HTML. Por ejemplo, <asp:Literal id="DisplayLiteral"> A&nbsp;B </asp:Literal> se representa como "A B".

Precaución

Este control se puede usar para mostrar la entrada del usuario, lo que podría incluir un script de cliente malintencionado. Compruebe cualquier información que se envíe desde un cliente para el script ejecutable, las instrucciones SQL u otro código antes de mostrarla en la aplicación. ASP.NET proporciona una característica de validación de solicitudes de entrada para bloquear scripts y HTML en la entrada del usuario. También se proporcionan controles de servidor de validación para evaluar la entrada del usuario. Para obtener más información, vea Validation Server Control Syntax.

El valor de esta propiedad, cuando se establece, se puede guardar automáticamente en un archivo de recursos mediante una herramienta de diseñador. Para obtener más información, vea LocalizableAttributeGlobalización y localización.

Se aplica a

Consulte también