AppSettingsExpressionBuilder Classe

Definição

Namespace:
System.Web.Compilation
Assembly:
System.Web.dll

Recupera valores, conforme especificado em uma expressão declarativa, da <appSettings> seção do arquivo 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
Herança
Object
ExpressionBuilder
AppSettingsExpressionBuilder

Exemplos

O exemplo de código a seguir demonstra como recuperar um valor de configurações de aplicativo em uma página que não é 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>

Esse código recupera a expressão a seguir do arquivo Web.config.

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

<appSettings>

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

</appSettings>

</configuration>

Comentários

A AppSettingsExpressionBuilder classe fornece acesso a valores na <appSettings> seção do arquivo Web.config. A <appSettings> seção do arquivo Web.config contém valores específicos do aplicativo em pares chave/valor.

Um valor de aplicativo é recuperado atribuindo uma expressão do formulário

<%$ AppSettings: appSettingsKey %>

para uma propriedade em uma declaração de controle. A parte da expressão antes dos dois-pontos (:) designa o tipo de expressão a ser recuperada e a parte após o dois-pontos significa a chave. A expressão anterior recuperaria o valor a seguir do arquivo Web.config.

<appSettings>

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

</appSettings>

Quando o analisador de página encontra uma expressão com o AppSettings prefixo, ele cria uma instância da AppSettingsExpressionBuilder classe para manipular a expressão.

Se a expressão for encontrada em uma página que será compilada, o AppSettingsExpressionBuilder objeto gerará código para recuperar o valor especificado do arquivo Web.config. Esse código é executado durante a execução da classe de página gerada. Se a expressão for encontrada em uma página que não será compilada, o AppSettingsExpressionBuilder objeto retornará o valor do arquivo Web.config quando a página for analisada e executada.

Construtores

Nome Description
AppSettingsExpressionBuilder()

Inicializa uma nova instância da classe AppSettingsExpressionBuilder.

Propriedades

Nome Description
SupportsEvaluate

Retorna um valor que indica se uma expressão pode ser avaliada em uma página que não é compilada.

Métodos

Nome Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

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

Retorna um valor da <appSettings> seção do arquivo Web.config.
GetAppSetting(String, Type, String)

Retorna um valor da <appSettings> seção do arquivo Web.config com o valor convertido em um tipo de destino.
GetAppSetting(String)

Retorna um valor da <appSettings> seção do arquivo Web.config.
GetCodeExpression(BoundPropertyEntry, Object, ExpressionBuilderContext)

Retorna uma expressão de código usada para executar a atribuição de propriedade na classe de página gerada.
GetHashCode()

Serve como a função hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

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

Quando substituído em uma classe derivada, retorna um objeto que representa a expressão analisada.

(Herdado de ExpressionBuilder)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também