AppSettingsExpressionEditor 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
提供用于在设计时计算和编辑配置文件中的应用程序设置表达式的属性和方法。
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
- 继承
示例
下面的代码示例演示如何使用AppSettingsExpressionEditor对象将NavigateUrl控件的属性HyperLink绑定到应用程序设置表达式。
在Web Forms项目中,添加到
MyHyperLinkSetting``<appSettings>
web.config文件的节。<FileName>web.config</FileName> <RelevantItems> <Reference>System.Web.UI.Design.AppSettingExpressionEditor</Reference> </RelevantItems>
在Web Forms页上,添加控件HyperLink。
Hyperlink
对于控件,在“属性”中,单击“表达式”,然后单击省略号按钮 (...) 。此时会显示“
<Hyperlinkname>
表达式 ”对话框。在 “可绑定属性”下,单击“表达式 类型”列表中的 NavigateUrl,单击 “AppSettings”,然后在“表达式属性”下,键入 MyHyperLinkSetting。
视觉对象设计器使用 AppSettingsExpressionEditor 为属性分配表达式 NavigateUrl
。
以下 aspx 源演示了使用应用程序设置表达式设置属性值的示例。
<!-- 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>
注解
该 AppSettingsExpressionEditor 类派生自该类, ExpressionEditor 并提供一个实现,用于在设计时评估和关联应用程序设置引用与控件属性。 例如,可以将控件属性的值绑定到应用程序设置表达式,该表达式AppSettings:mySettingKeyName
指示使用 Web 配置文件节中的appSettings
值设置mySettingKeyName
控件属性值。
视觉设计器主机(如 Visual Studio 2005)使用AppSettingsExpressionEditor类从appSettings
配置部分选择应用程序设置,然后计算所选表达式进行设计时呈现。
在设计时属性网格中浏览到 Expressions 控件的属性时,视觉设计器将显示一个对话框来设置为控件属性提供运行时值的表达式。 可以根据表达式前缀列表选择表达式类型。 从列表中选择 AppSettings 表达式前缀时,视觉设计器主机使用关联的ExpressionEditorSheet对象提供表达式的设计时编辑功能,并使用AppSettingsExpressionEditor方法根据应用程序设置表达式的appSettings
语法来计算和转换表达式字符串。 视觉对象设计器主机使用计算的表达式结果来分配在设计图面上呈现的控件属性值。
ExpressionPrefix对象的属性AppSettingsExpressionEditor返回字符串 AppSettings
。 该 AppSettingsExpressionBuilder 类与表达式前缀 AppSettings
和 AppSettingsExpressionEditor 实现相关联。
该方法 EvaluateExpression 计算输入应用程序设置表达式字符串。 该方法 GetExpressionEditorSheet 返回 ExpressionEditorSheet 用于输入和编辑应用程序设置表达式的实现。
构造函数
AppSettingsExpressionEditor() |
初始化 AppSettingsExpressionEditor 类的新实例。 |
属性
ExpressionPrefix |
获取表达式前缀,该前缀标识受表达式编辑器实现支持的表达式字符串。 (继承自 ExpressionEditor) |
方法
Equals(Object) |
确定指定对象是否等于当前对象。 (继承自 Object) |
EvaluateExpression(String, Object, Type, IServiceProvider) |
计算应用程序设置表达式字符串,并为控件属性提供设计时值。 |
GetExpressionEditorSheet(String, IServiceProvider) |
返回应用程序设置表达式的表达式编辑器表。 |
GetHashCode() |
作为默认哈希函数。 (继承自 Object) |
GetType() |
获取当前实例的 Type。 (继承自 Object) |
MemberwiseClone() |
创建当前 Object 的浅表副本。 (继承自 Object) |
ToString() |
返回表示当前对象的字符串。 (继承自 Object) |