AppSettingsExpressionBuilder Klasse

Referenz

Definition

Namespace:: System.Web.Compilation

Assembly:: System.Web.dll

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.

Ruft Werte, wie in einem deklarativen Ausdruck angegeben, aus dem <appSettings>-Abschnitt der Datei Web.config ab.

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

Vererbung: Object

ExpressionBuilder
AppSettingsExpressionBuilder

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein Anwendungseinstellungswert auf einer Seite abgerufen wird, die nicht kompiliert wird.

<%@ 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>

Dieser Code ruft den folgenden Ausdruck aus der Web.config-Datei ab.

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

<appSettings>

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

</appSettings>

</configuration>

Hinweise

Die AppSettingsExpressionBuilder -Klasse bietet Zugriff auf Werte im <appSettings> Abschnitt der Web.config-Datei. Der <appSettings> Abschnitt der Web.config-Datei enthält anwendungsspezifische Werte in Schlüssel-Wert-Paaren.

Ein Anwendungswert wird durch Zuweisen eines Ausdrucks des Formulars abgerufen.

<%$ AppSettings: appSettingsKey %>

zu einer Eigenschaft in einer Steuerelementdeklaration. Der Teil des Ausdrucks vor dem Doppelpunkt (:) gibt den Typ des abzurufenden Ausdrucks an, und der Teil nach dem Doppelpunkt kennzeichnet den Schlüssel. Der vorherige Ausdruck würde den folgenden Wert aus der Web.config-Datei abrufen.

<appSettings>

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

</appSettings>

Wenn der Seitenparser auf einen Ausdruck mit dem AppSettings Präfix trifft, wird eine Instanz der -Klasse erstellt, die AppSettingsExpressionBuilder den Ausdruck behandelt.

Wenn der Ausdruck auf einer Seite gefunden wird, die kompiliert wird, generiert das AppSettingsExpressionBuilder Objekt Code, um den angegebenen Wert aus der Web.config-Datei abzurufen. Dieser Code wird während der Ausführung der generierten Seitenklasse ausgeführt. Wenn der Ausdruck auf einer Seite gefunden wird, die nicht kompiliert wird, gibt das AppSettingsExpressionBuilder Objekt den Wert aus der Web.config-Datei zurück, wenn die Seite analysiert und ausgeführt wird.

Konstruktoren

AppSettingsExpressionBuilder()

Initialisiert eine neue Instanz der AppSettingsExpressionBuilder-Klasse.

Eigenschaften

SupportsEvaluate

Gibt einen Wert zurück, der angibt, ob ein Ausdruck in einer nicht kompilierten Seite ausgewertet werden kann.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
EvaluateExpression(Object, BoundPropertyEntry, Object, ExpressionBuilderContext)	Gibt einen Wert aus dem `<appSettings>`-Abschnitt der Datei Web.config zurück.
GetAppSetting(String)	Gibt einen Wert aus dem `<appSettings>`-Abschnitt der Datei Web.config zurück.
GetAppSetting(String, Type, String)	Gibt einen Wert aus dem `<appSettings>`-Abschnitt der Datei Web.config zurück, wobei der Wert in einen Zieltyp konvertiert wird.
GetCodeExpression(BoundPropertyEntry, Object, ExpressionBuilderContext)	Gibt einen Codeausdruck zurück, der verwendet wird, um die Eigenschaftenzuweisung in der generierten Seitenklasse auszuführen.
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)
ParseExpression(String, Type, ExpressionBuilderContext)	Gibt nach dem Überschreiben in einer abgeleiteten Klasse ein Objekt zurück, das den analysierten Ausdruck darstellt. (Geerbt von ExpressionBuilder)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Gilt für:

Freigeben über