AppSettingsExpressionEditor Classe

Referência

Definição

Namespace:: System.Web.UI.Design

Assembly:: System.Design.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.

Fornece propriedades e métodos para avaliar e editar uma expressão de configuração de aplicativo em um arquivo de configuração no tempo de design.

public ref class AppSettingsExpressionEditor : System::Web::UI::Design::ExpressionEditor

public class AppSettingsExpressionEditor : System.Web.UI.Design.ExpressionEditor

type AppSettingsExpressionEditor = class
    inherit ExpressionEditor

Public Class AppSettingsExpressionEditor
Inherits ExpressionEditor

Herança: Object

ExpressionEditor
AppSettingsExpressionEditor

Exemplos

O exemplo de código a seguir demonstra como associar a NavigateUrl propriedade de um HyperLink controle a uma expressão de configuração de aplicativo usando o AppSettingsExpressionEditor objeto.

Em um projeto Web Forms, adicione MyHyperLinkSetting à <appSettings> seção do arquivo web.config.

<FileName>web.config</FileName>
<RelevantItems>
    <Reference>System.Web.UI.Design.AppSettingExpressionEditor</Reference>
</RelevantItems>

Em uma página Web Forms, adicione um HyperLink controle.
Para o Hyperlink controle, em Propriedades, clique em Expressões e clique no botão de reticências (...).

A <Hyperlinkname> caixa de diálogo Expressão é exibida.
Em propriedades associáveis, clique em NavigateUrl, na lista de tipos de expressão , clique em AppSettings e, em seguida, em Propriedades de Expressão, na caixa AppSetting , digite MyHyperLinkSetting.

O designer visual usa a AppSettingsExpressionEditor expressão para atribuir a expressão para a NavigateUrl propriedade.

A fonte aspx a seguir mostra um exemplo de um conjunto de valores de propriedade usando uma expressão de configuração de aplicativo.

<!-- Define a hyperlink that maps the NavigateUrl property to the
     MyHyperLinkSetting value in the Web.Config appSettings section. -->
<asp:HyperLink runat="server" ID="HyperLink1" 
     NavigateUrl="<%$ AppSettings:MyHyperLinkSetting %>">
     HyperLink using an AppSetting expression
</asp:HyperLink>

<!-- Define a hyperlink that maps the NavigateUrl property to the
     MyHyperLinkSetting value in the Web.Config appSettings section. -->
<asp:HyperLink runat="server" ID="HyperLink1" 
     NavigateUrl="<%$ AppSettings:MyHyperLinkSetting %>">
     HyperLink using an AppSetting expression
</asp:HyperLink>

<FileName>ControlsUsingExpressions.aspx</FileName>
<RelevantItems>
    <Reference>System.Web.UI.Design.AppSettingExpressionEditor</Reference>
</RelevantItems>

Comentários

A AppSettingsExpressionEditor classe é derivada da ExpressionEditor classe e fornece uma implementação para avaliar e associar uma referência de configuração de aplicativo a uma propriedade de controle em tempo de design. Por exemplo, você pode associar o valor de uma propriedade de controle à expressão AppSettings:mySettingKeyNamede configuração do aplicativo, o que indica que o valor da propriedade de controle é definido usando o mySettingKeyName valor na appSettings seção do arquivo de configuração da Web.

Um host de designer visual, como Visual Studio 2005, usa a AppSettingsExpressionEditor classe para selecionar uma configuração de aplicativo na appSettings seção de configuração e, em seguida, avalia a expressão selecionada para renderização em tempo de design.

Quando você navega até a Expressions propriedade para obter um controle na grade de propriedades de tempo de design, o designer visual exibe uma caixa de diálogo para definir expressões que fornecem o valor de tempo de execução para uma propriedade de controle. Você pode selecionar o tipo de expressão com base em uma lista de prefixos de expressão. Quando você seleciona o prefixo de expressão AppSettings na lista, o host do designer visual usa o objeto associado ExpressionEditorSheet para fornecer a funcionalidade de edição em tempo de design de appSettings expressões e usa métodos para avaliar e converter a cadeia de caracteres AppSettingsExpressionEditor de expressão com base na sintaxe de uma expressão de configuração de aplicativo. O host do designer visual usa o resultado da expressão avaliada para atribuir valores de propriedade de controle que são renderizados na superfície de design.

A ExpressionPrefix propriedade de um AppSettingsExpressionEditor objeto retorna a cadeia de caracteres AppSettings. A AppSettingsExpressionBuilder classe está associada ao prefixo AppSettings de expressão e à AppSettingsExpressionEditor implementação.

O EvaluateExpression método avalia uma cadeia de caracteres de expressão de configuração de aplicativo de entrada. O GetExpressionEditorSheet método retorna a ExpressionEditorSheet implementação usada para inserir e editar expressões de configuração do aplicativo.

Construtores

AppSettingsExpressionEditor()

Inicializa uma nova instância da classe AppSettingsExpressionEditor.

Propriedades

ExpressionPrefix

Obtém o prefixo de expressão que identifica as cadeias de caracteres de expressão com suporte na implementação do editor de expressão.

(Herdado de ExpressionEditor)

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
EvaluateExpression(String, Object, Type, IServiceProvider)	Avalia uma cadeia de caracteres de expressão de configuração de aplicativo e fornece o valor temporal de design para uma propriedade de controle.
GetExpressionEditorSheet(String, IServiceProvider)	Retorna uma folha do editor de expressão para uma expressão de configuração de aplicativo.
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)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Aplica-se a

Partilhar via