AppSettingsExpressionBuilder Clase

  • Referencia

Definición

Espacio de nombres:
System.Web.Compilation
Ensamblado:
System.Web.dll

Recupera valores, según lo especificado en una expresión declarativa, de la sección <appSettings> del archivo Web.config.

public ref class AppSettingsExpressionBuilder : System::Web::Compilation::ExpressionBuilder
public class AppSettingsExpressionBuilder : System.Web.Compilation.ExpressionBuilder
type AppSettingsExpressionBuilder = class
    inherit ExpressionBuilder
Public Class AppSettingsExpressionBuilder
Inherits ExpressionBuilder
Herencia
Object
ExpressionBuilder
AppSettingsExpressionBuilder

Ejemplos

En el ejemplo de código siguiente se muestra cómo recuperar un valor de configuración de aplicación en una página que no está compilada.

<%@ Page Language="C#" CompilationMode="Never" %>

<!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 runat="server">
    <title>Noncompiled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        Welcome to the 
        <asp:Literal ID="Literal1" runat="server" 
        Text="<%$ AppSettings: thisSeason %>" /> Sale!
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB" CompilationMode="Never" %>

<!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 runat="server">
    <title>Noncompiled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        Welcome to the 
        <asp:Literal ID="Literal1" runat="server" 
        Text="<%$ AppSettings: thisSeason %>" /> Sale!
    </div>
    </form>
</body>
</html>

Este código recupera la siguiente expresión del archivo Web.config.

<configuration xmlns="http://schemas.microsoft.com/.NetConfiguration/v2.0">

<appSettings>

<add key="thisSeason" value="Fall"/>

</appSettings>

</configuration>

Comentarios

La AppSettingsExpressionBuilder clase proporciona acceso a los valores de la <appSettings> sección del archivo Web.config. La <appSettings> sección del archivo Web.config contiene valores específicos de la aplicación en pares clave-valor.

Se recupera un valor de aplicación mediante la asignación de una expresión del formulario

<%$ AppSettings: appSettingsKey %>

a una propiedad de una declaración de control. Parte de la expresión antes de los dos puntos (:) designa el tipo de expresión que se va a recuperar y la parte después de los dos puntos significa la clave. La expresión anterior recuperaría el siguiente valor del archivo Web.config.

<appSettings>

<add key="appSettingsKey" value="appSettingsValue"/>

</appSettings>

Cuando el analizador de páginas encuentra una expresión con el AppSettings prefijo , crea una instancia de la AppSettingsExpressionBuilder clase para controlar la expresión.

Si la expresión se encuentra en una página que se compilará, el AppSettingsExpressionBuilder objeto genera código para recuperar el valor especificado del archivo Web.config. Este código se ejecuta durante la ejecución de la clase de página generada. Si la expresión se encuentra en una página que no se compilará, el AppSettingsExpressionBuilder objeto devuelve el valor del archivo Web.config cuando se analiza y se ejecuta la página.

Constructores

AppSettingsExpressionBuilder()

Inicializa una nueva instancia de la clase AppSettingsExpressionBuilder.

Propiedades

SupportsEvaluate

Devuelve un valor que indica si una expresión se puede evaluar en una página no compilada.

Métodos

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
EvaluateExpression(Object, BoundPropertyEntry, Object, ExpressionBuilderContext)

Devuelve un valor de la sección <appSettings> del archivo Web.config.
GetAppSetting(String)

Devuelve un valor de la sección <appSettings> del archivo Web.config.
GetAppSetting(String, Type, String)

Devuelve un valor de la sección <appSettings> del archivo Web.config con el valor convertido en un tipo de destino.
GetCodeExpression(BoundPropertyEntry, Object, ExpressionBuilderContext)

Devuelve una expresión de código utilizada para realizar la asignación de propiedad en la clase de páginas generada.
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
ParseExpression(String, Type, ExpressionBuilderContext)

Cuando se reemplaza en una clase derivada, devuelve un objeto que representa una expresión analizada.

(Heredado de ExpressionBuilder)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Se aplica a

Consulte también