ConnectionStringsExpressionBuilder Classe

Definição

Espaço de Nomes:
System.Web.Compilation
Assemblagem:
System.Web.dll

Recupera, ou gera código para recuperar, valores da <connectionStrings> secção do ficheiro Web.config.

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
Herança
Object
ExpressionBuilder
ConnectionStringsExpressionBuilder

Exemplos

O exemplo de código seguinte demonstra como usar declarativamente um controlo SqlDataSource para recuperar dados de um computador a correr Microsoft SQL Server e exibi-los num controlo GridView.

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

O código recupera os seguintes cadeia de ligação do ficheiro 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>

Observações

A ConnectionStringsExpressionBuilder classe fornece acesso a valores na <connectionStrings> secção do ficheiro Web.config. A secção <connectionStrings> do ficheiro Web.config contém cadeia de ligação valores em pares nome/valor.

Um valor de cadeia de ligação é recuperado atribuindo uma expressão da forma

<%$ ConnectionStrings: secureConnectionString %>

para uma propriedade de controlo. A parte da expressão antes do dois-pontos (:) designa o tipo de expressão a recuperar, e a parte após o dois-pontos indica o nome do cadeia de ligação. A expressão anterior recuperava o valor seguinte do ficheiro Web.config.

<connectionStrings>

<add name="secureConnectionString" connectionString="Data

Source=localhost;Integrated Security=SSPI;Initial

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

</connectionStrings>

Quando o analisador de páginas encontra uma expressão com o prefixo ConnectionStrings, cria uma instância da ConnectionStringsExpressionBuilder classe para tratar a expressão.

Se a expressão for encontrada numa página que será compilada, o objeto ConnectionStringsExpressionBuilder gera código que recupera a cadeia de ligação especificada do ficheiro Web.config. Se a expressão for encontrada numa página que não será compilada, o ConnectionStringsExpressionBuilder objeto devolve o valor do ficheiro Web.config quando a página é analisada.

Construtores

Name Description
ConnectionStringsExpressionBuilder()

Inicializa uma nova instância da ConnectionStringsExpressionBuilder classe.

Propriedades

Name Description
SupportsEvaluate

Devolve um valor que indica se uma expressão pode ser avaliada numa página que não está compilada.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
EvaluateExpression(Object, BoundPropertyEntry, Object, ExpressionBuilderContext)

Devolve um valor da <connectionStrings> secção do ficheiro Web.config.
GetCodeExpression(BoundPropertyEntry, Object, ExpressionBuilderContext)

Devolve uma expressão de código para avaliar durante a análise de páginas.
GetConnectionString(String)

Retorna uma cadeia de ligação da secção <connectionStrings> do ficheiro Web.config.
GetConnectionStringProviderName(String)

Devolve o fornecedor cadeia de ligação da secção <connectionStrings> do ficheiro Web.config.
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ParseExpression(String, Type, ExpressionBuilderContext)

Devolve um objeto que representa a expressão analisada.
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também