Compartir a través de


Información general sobre el control de servidor Web Localize

Actualización: noviembre 2007

Se puede agregar un control de servidor Web Localize a una página Web ASP.NET cuando se desea mostrar texto localizado en un área específica de la página.

Comparar el control Localize con el control Literal

El control Localize es idéntico al control de servidor Web Literal y similar al control de servidor Web Label. El control Label permite aplicar un estilo al texto que se muestra, mientras que el control Localize no lo permite. Puede controlar mediante programación el texto que se muestra en el control Localize si establece la propiedad Text, que se hereda del control Literal.

Codificar el contenido en el control Literal

El control Localize admite la propiedad Mode, que especifica cómo administra el control el marcado que se agrega. Puede establecer la propiedad Mode en los siguientes valores:

  • Transform. Cualquier marcado que agregue al control se transforma para alojar el protocolo del explorador que realizó la solicitud. Esta configuración es útil si está representando contenido en dispositivos móviles que utilizan un protocolo distinto de HTML.

  • PassThrough. Cualquier marcado que agregue al control se representa tal cual en el explorador.

  • Encode. Cualquier marcado que agregue al control se codifica mediante el método HtmlEncode, que convierte la codificación HTML en su representación de texto. Por ejemplo, una etiqueta <b> se representa como &lt;b&gt;. La codificación es útil cuando desea que el explorador muestre el marcado en lugar de interpretarlo. También resulta útil por motivos de seguridad, para impedir que se ejecute ningún marcado malintencionado en el explorador, y su uso es recomendable si se muestran cadenas de un origen que no sea de confianza. Para obtener más información, vea Cómo: Proteger una aplicación Web frente a ataques mediante secuencias de comandos aplicando codificación HTML a las cadenas.

Adaptar texto mediante cadenas de recurso

Se pueden crear cadenas adaptadas para mostrarlas en la propiedad Text del control Localize utilizando una expresión explícita o implícita como valor de la propiedad. Las expresiones se evalúan mediante cadenas que se declaran en archivos de recursos (.resx).

Cree los archivos .resx en las carpetas denominadas App_GlobalResources y App_LocalResources, que están ubicadas en la raíz de la aplicación. Si necesita adaptar cadenas para varios idiomas, puede crear archivos .resx adicionales con información de la configuración regional incluida en el nombre de archivo. Por ejemplo, la versión en francés del archivo de recursos se denominaría ExampleLocalizedStrings.fr.resx.

Para obtener más información sobre las expresiones, vea Información general sobre expresiones ASP.NET. Para obtener información sobre los archivos de recursos, vea Recursos de aplicaciones de ASP.NET. Para obtener un ejemplo de código que utiliza expresiones regulares en el control Localize, vea Sintaxis declarativa del control de servidor Web Localize.

Vea también

Conceptos

Recursos de aplicaciones de ASP.NET

Información general sobre expresiones ASP.NET

Referencia

Sintaxis declarativa del control de servidor Web Localize

Localize

Otros recursos

Seguridad de aplicaciones ASP.NET en entornos alojados en host