AppSettingsExpressionBuilder Classe

Referência

Definição

Namespace:: System.Web.Compilation

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Recupera os valores, conforme especificado em uma expressão declarativa, da seção <appSettings> 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 os 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

AppSettingsExpressionBuilder()

Inicializa uma nova instância da classe AppSettingsExpressionBuilder.

Propriedades

SupportsEvaluate

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

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
EvaluateExpression(Object, BoundPropertyEntry, Object, ExpressionBuilderContext)	Retorna um valor da seção `<appSettings>` do arquivo Web.config.
GetAppSetting(String)	Retorna um valor da seção `<appSettings>` do arquivo Web.config.
GetAppSetting(String, Type, String)	Retorna um valor da seção `<appSettings>` do arquivo Web.config com o valor convertido em um tipo de destino.
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 de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ParseExpression(String, Type, ExpressionBuilderContext)	Quando substituído em uma classe derivada, retorna um objeto que representa uma expressão analisada. (Herdado de ExpressionBuilder)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Aplica-se a

Compartilhar via