ConnectionStringsExpressionBuilder Classe

  • Référence

Définition

Espace de noms:
System.Web.Compilation
Assembly:
System.Web.dll

Récupère des valeurs à partir de la section <connectionStrings> du fichier Web.config, ou génère du code pour en récupérer.

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
Héritage
Object
ExpressionBuilder
ConnectionStringsExpressionBuilder

Exemples

L’exemple de code suivant montre comment utiliser de manière déclarative un SqlDataSource contrôle pour récupérer des données à partir d’un ordinateur exécutant Microsoft SQL Server et l’afficher dans un GridView contrôle.

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

Le code récupère la chaîne de connexion suivante à partir du fichier Web.config.

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

Remarques

La ConnectionStringsExpressionBuilder classe fournit l’accès aux valeurs dans la <connectionStrings> section du fichier Web.config. La <connectionStrings> section du fichier Web.config contient des valeurs de chaîne de connexion dans des paires nom/valeur.

Une valeur de chaîne de connexion est récupérée en affectant une expression du formulaire

<%$ ConnectionStrings: secureConnectionString %>

à une propriété de contrôle. Partie de l’expression avant le signe deux-points (:) désigne le type d’expression à récupérer, et la partie après le signe deux-points signifie le nom de la chaîne de connexion. L’expression précédente récupère la valeur suivante à partir du fichier Web.config.

<connectionStrings>

<add name="secureConnectionString" connectionString="Data

Source=localhost;Integrated Security=SSPI;Initial

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

</connectionStrings>

Lorsque l’analyseur de page rencontre une expression avec le préfixe ConnectionStrings, elle crée une instance de la ConnectionStringsExpressionBuilder classe pour gérer l’expression.

Si l’expression est rencontrée dans une page qui sera compilée, l’objet génère du ConnectionStringsExpressionBuilder code qui récupère la chaîne de connexion spécifiée à partir du fichier Web.config. Si l’expression est rencontrée dans une page qui ne sera pas compilée, l’objet ConnectionStringsExpressionBuilder retourne la valeur du fichier Web.config lorsque la page est analysée.

Constructeurs

ConnectionStringsExpressionBuilder()

Initialise une nouvelle instance de la classe ConnectionStringsExpressionBuilder.

Propriétés

SupportsEvaluate

Retourne une valeur indiquant si une expression peut être évaluée dans une page qui n'est pas compilée.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
EvaluateExpression(Object, BoundPropertyEntry, Object, ExpressionBuilderContext)

Retourne une valeur à partir de la section <connectionStrings> du fichier Web.config.
GetCodeExpression(BoundPropertyEntry, Object, ExpressionBuilderContext)

Retourne une expression de code à évaluer pendant l'analyse de page.
GetConnectionString(String)

Retourne une chaîne de connexion à partir de la section <connectionStrings> du fichier Web.config.
GetConnectionStringProviderName(String)

Retourne le fournisseur de chaînes de connexion à partir de la section <connectionStrings> du fichier Web.config.
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ParseExpression(String, Type, ExpressionBuilderContext)

Retourne un objet qui représente l'expression analysée.
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

S’applique à

Voir aussi