ConnectionStringsExpressionBuilder 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 Code ab oder generiert ihn, um Werte aus dem <connectionStrings>-Abschnitt der Datei „Web.config“ abzurufen.

public ref class ConnectionStringsExpressionBuilder : System::Web::Compilation::ExpressionBuilder

public class ConnectionStringsExpressionBuilder : System.Web.Compilation.ExpressionBuilder

type ConnectionStringsExpressionBuilder = class
    inherit ExpressionBuilder

Public Class ConnectionStringsExpressionBuilder
Inherits ExpressionBuilder

Vererbung: Object

ExpressionBuilder
ConnectionStringsExpressionBuilder

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie ein SqlDataSource Steuerelement deklarativ verwenden, um Daten von einem Computer mit Microsoft SQL Server abzurufen und in einem GridView Steuerelement anzuzeigen.

<%@ Page Language="C#" %>

<!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>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

<%@ Page Language="VB" %>

<!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>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

Der Code ruft die folgende Verbindungszeichenfolge aus der Web.config-Datei ab.

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

<connectionStrings>

<add name="MyNorthwind" connectionString="Data

Source=localhost;Integrated Security=SSPI;Initial

Catalog=Northwind;" providerName="System.Data.SqlClient" />

</connectionStrings>

</configuration>

Hinweise

Die ConnectionStringsExpressionBuilder -Klasse bietet Zugriff auf Werte im <connectionStrings> Abschnitt der Web.config-Datei. Der <connectionStrings> Abschnitt der Web.config-Datei enthält Verbindungszeichenfolgenwerte in Name/Wert-Paaren.

Ein Verbindungszeichenfolgenwert wird durch Zuweisen eines Ausdrucks des Formulars abgerufen.

<%$ ConnectionStrings: secureConnectionString %>

zu einer Steuerelementeigenschaft. Der Teil des Ausdrucks vor dem Doppelpunkt (:) gibt den Typ des abzurufenden Ausdrucks an, und der Teil nach dem Doppelpunkt gibt den Namen der Verbindungszeichenfolge an. Der vorherige Ausdruck würde den folgenden Wert aus der Web.config-Datei abrufen.

<connectionStrings>

<add name="secureConnectionString" connectionString="Data

Source=localhost;Integrated Security=SSPI;Initial

Catalog=Northwind;" providerName="System.Data.SqlClient" />

</connectionStrings>

Wenn der Seitenparser auf einen Ausdruck mit dem Präfix ConnectionStringsstößt, erstellt er eine Instanz der ConnectionStringsExpressionBuilder -Klasse, um den Ausdruck zu behandeln.

Wenn der Ausdruck auf einer seite gefunden wird, die kompiliert wird, generiert das ConnectionStringsExpressionBuilder -Objekt Code, der die angegebene Verbindungszeichenfolge aus der Web.config-Datei abruft. Wenn der Ausdruck auf einer Seite gefunden wird, die nicht kompiliert wird, gibt das ConnectionStringsExpressionBuilder Objekt den Wert aus der Web.config-Datei zurück, wenn die Seite analysiert wird.

Konstruktoren

ConnectionStringsExpressionBuilder()

Initialisiert eine neue Instanz der ConnectionStringsExpressionBuilder-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 <`connectionStrings`>-Abschnitt der Datei „Web.config“ zurück.
GetCodeExpression(BoundPropertyEntry, Object, ExpressionBuilderContext)	Gibt einen während der Seitenanalyse auszuwertenden Codeausdruck zurück.
GetConnectionString(String)	Gibt eine Verbindungszeichenfolge aus dem <`connectionStrings`>-Abschnitt der Datei „Web.config“ zurück.
GetConnectionStringProviderName(String)	Gibt den Anbieter der Verbindungszeichenfolge aus dem <`connectionStrings`>-Abschnitt der Datei „Web.config“ 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)
ParseExpression(String, Type, ExpressionBuilderContext)	Gibt ein Objekt zurück, das den analysierten Ausdruck darstellt.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Gilt für:

Freigeben über