AppSettingsExpressionBuilder Clase

Definición

Recupera valores, según lo especificado en una expresión declarativa, de la sección <appSettings> del archivo Web.config.Retrieves values, as specified in a declarative expression, from the <appSettings> section of the Web.config file.

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
AppSettingsExpressionBuilder

Ejemplos

En el ejemplo de código siguiente se muestra cómo recuperar un valor de configuración de la aplicación en una página que no está compilada.The following code example demonstrates how to retrieve an application settings value in a page that is not compiled.

<%@ 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.This code retrieves the following expression from the Web.config file.

<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 de Web.config.The AppSettingsExpressionBuilder class provides access to values in the <appSettings> section of the Web.config file. La <appSettings> sección del archivo de Web.config contiene valores específicos de la aplicación en pares clave-valor.The <appSettings> section of the Web.config file contains application-specific values in key/value pairs.

Para recuperar un valor de aplicación, se asigna una expresión con el formato.An application value is retrieved by assigning an expression of the form

<%$ AppSettings: appSettingsKey %>

a una propiedad en una declaración de control.to a property in a control declaration. Parte de la expresión delante de los dos puntos (:) designa el tipo de expresión que se va a recuperar y la parte que va detrás del signo de dos puntos indica la clave.The part of the expression before the colon (:) designates the type of expression to be retrieved, and the part after the colon signifies the key. La expresión anterior recuperaría el siguiente valor del archivo Web.config.The preceding expression would retrieve the following value from the Web.config file.

<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.When the page parser encounters an expression with the AppSettings prefix, it creates an instance of the AppSettingsExpressionBuilder class to handle the expression.

Si la expresión se encuentra en una página que se va a compilar, el AppSettingsExpressionBuilder objeto genera código para recuperar el valor especificado del archivo de Web.config.If the expression is encountered in a page that will be compiled, the AppSettingsExpressionBuilder object generates code to retrieve the specified value from the Web.config file. Este código se ejecuta durante la ejecución de la clase de página generada.This code is executed during the execution of the generated page class. Si la expresión se encuentra en una página que no se va a compilar, el AppSettingsExpressionBuilder objeto devuelve el valor del archivo Web.config cuando la página se analiza y se ejecuta.If the expression is encountered in a page that will not be compiled, the AppSettingsExpressionBuilder object returns the value from the Web.config file when the page is parsed and executed.

Constructores

AppSettingsExpressionBuilder()

Inicializa una nueva instancia de la clase AppSettingsExpressionBuilder.Initializes a new instance of the AppSettingsExpressionBuilder class.

Propiedades

SupportsEvaluate

Devuelve un valor que indica si una expresión se puede evaluar en una página no compilada.Returns a value indicating whether an expression can be evaluated in a page that is not compiled.

Métodos

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

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

Devuelve un valor de la sección <appSettings> del archivo Web.config.Returns a value from the <appSettings> section of the Web.config file.

GetAppSetting(String)

Devuelve un valor de la sección <appSettings> del archivo Web.config.Returns a value from the <appSettings> section of the Web.config file.

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.Returns a value from the <appSettings> section of the Web.config file with the value converted to a target type.

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.Returns a code expression that is used to perform the property assignment in the generated page class.

GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

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

Cuando se reemplaza en una clase derivada, devuelve un objeto que representa una expresión analizada.When overridden in a derived class, returns an object that represents the parsed expression.

(Heredado de ExpressionBuilder)
ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Se aplica a

Consulte también