AppSettingsExpressionEditor Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt Eigenschaften und Methoden für das Evaluieren und Bearbeiten eines Ausdrucks für Anwendungseinstellungen in einer Konfigurationsdatei zur Entwurfszeit bereit.
public ref class AppSettingsExpressionEditor : System::Web::UI::Design::ExpressionEditorpublic class AppSettingsExpressionEditor : System.Web.UI.Design.ExpressionEditortype AppSettingsExpressionEditor = class
inherit ExpressionEditorPublic Class AppSettingsExpressionEditor
Inherits ExpressionEditor- Vererbung
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie die NavigateUrl Eigenschaft eines HyperLink Steuerelements mithilfe AppSettingsExpressionEditor des -Objekts an einen Anwendungseinstellungsausdruck gebunden wird.
Fügen Sie in einem Web Forms Projekt dem
<appSettings>Abschnitt der web.config-Datei hinzuMyHyperLinkSetting.<FileName>web.config</FileName> <RelevantItems> <Reference>System.Web.UI.Design.AppSettingExpressionEditor</Reference> </RelevantItems>Fügen Sie auf einer Web Forms Seite ein Steuerelement hinzuHyperLink.
Klicken Sie für das
HyperlinkSteuerelement in Eigenschaften auf Ausdrücke, und klicken Sie dann auf die Schaltfläche mit den Auslassungspunkten (...).Das
<Hyperlinkname>Dialogfeld Ausdruck wird angezeigt.Klicken Sie unter Bindungsfähige Eigenschaften auf NavigateUrl, in der Liste Ausdruckstyp auf AppSettings, und geben Sie dann unter Ausdruckseigenschaften im Feld AppSettingden Namen MyHyperLinkSetting ein.
Der visuelle Designer verwendet den AppSettingsExpressionEditor , um den Ausdruck für die NavigateUrl -Eigenschaft zuzuweisen.
Die folgende ASPX-Quelle zeigt ein Beispiel für einen Eigenschaftenwertsatz mit einem Anwendungseinstellungsausdruck.
<!-- 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>
Hinweise
Die AppSettingsExpressionEditor -Klasse wird von der ExpressionEditor -Klasse abgeleitet und bietet eine Implementierung zum Bewerten und Zuordnen eines Anwendungseinstellungsverweiss zu einer Steuerelementeigenschaft zur Entwurfszeit. Beispielsweise können Sie den Wert einer Steuerelementeigenschaft an den Anwendungseinstellungsausdruck AppSettings:mySettingKeyNamebinden, der angibt, dass der Steuerelementeigenschaftswert mithilfe des mySettingKeyName Werts im Abschnitt der appSettings Webkonfigurationsdatei festgelegt wird.
Ein Visual Designer-Host, z. B. Visual Studio 2005, verwendet die AppSettingsExpressionEditor -Klasse, um eine Anwendungseinstellung aus dem appSettings Konfigurationsabschnitt auszuwählen, und wertet dann den ausgewählten Ausdruck für das Rendering zur Entwurfszeit aus.
Wenn Sie im Raster entwurfszeiteigenschaften zur Expressions Eigenschaft für ein Steuerelement navigieren, zeigt der visuelle Designer ein Dialogfeld an, um Ausdrücke festzulegen, die den Laufzeitwert für eine Steuerelementeigenschaft bereitstellen. Sie können den Ausdruckstyp basierend auf einer Liste von Ausdruckspräfixen auswählen. Wenn Sie das Präfix AppSettings-Ausdruck aus der Liste auswählen, verwendet der Visual Designer-Host das zugeordnete ExpressionEditorSheet Objekt, um Entwurfszeitbearbeitungsfunktionen von appSettings Ausdrücken bereitzustellen, und verwendet AppSettingsExpressionEditor Methoden, um die Ausdruckszeichenfolge basierend auf der Syntax für einen Anwendungseinstellungsausdruck auszuwerten und zu konvertieren. Der Host des visuellen Designers verwendet das ausgewertete Ausdrucksergebnis, um Steuerelementeigenschaftenwerte zuzuweisen, die auf der Entwurfsoberfläche gerendert werden.
Die ExpressionPrefix -Eigenschaft für ein AppSettingsExpressionEditor -Objekt gibt die Zeichenfolge AppSettingszurück. Die AppSettingsExpressionBuilder -Klasse ist dem Ausdruckspräfix AppSettings und der AppSettingsExpressionEditor Implementierung zugeordnet.
Die EvaluateExpression -Methode wertet eine Eingabeanwendungseinstellungsausdruckzeichenfolge aus. Die GetExpressionEditorSheet -Methode gibt die Implementierung zurück, die ExpressionEditorSheet zum Eingeben und Bearbeiten von Anwendungseinstellungsausdrücken verwendet wird.
Konstruktoren
| AppSettingsExpressionEditor() |
Initialisiert eine neue Instanz der AppSettingsExpressionEditor-Klasse. |
Eigenschaften
| ExpressionPrefix |
Ruft das Ausdruckspräfix ab, das die Ausdruckszeichenfolgen kennzeichnet, die von der Implementierung des Ausdrucks-Editors unterstützt werden. (Geerbt von ExpressionEditor) |
Methoden
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| EvaluateExpression(String, Object, Type, IServiceProvider) |
Wertet eine Ausdruckszeichenfolge für Anwendungseinstellungen aus und stellt den Entwurfszeitwert für eine Steuerelementeigenschaft bereit. |
| GetExpressionEditorSheet(String, IServiceProvider) |
Gibt ein Ausdrucks-Editorblatt für eine Anwendungseinstellung zurück. |
| GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
