ConnectionStringsExpressionBuilder Classe

Definição

Namespace:
System.Web.Compilation
Assembly:
System.Web.dll

Recupera ou gera códigos para recuperar valores da <connectionStrings> seção do arquivo 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 a seguir demonstra como usar declarativamente um controle SqlDataSource para recuperar dados de um computador executando Microsoft SQL Server e exibi-los em um controle 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 o cadeia de conexão a seguir do arquivo 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>

Comentários

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

Um valor cadeia de conexão é recuperado atribuindo uma expressão do formulário

<%$ ConnectionStrings: secureConnectionString %>

para uma propriedade de controle. A parte da expressão antes dos dois-pontos (:) designa o tipo de expressão a ser recuperada e a parte após os dois-pontos significa o nome do cadeia de conexão. A expressão anterior recuperaria o valor a seguir do arquivo 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ágina encontra uma expressão com o prefixo ConnectionStrings, ele cria uma instância da ConnectionStringsExpressionBuilder classe para manipular a expressão.

Se a expressão for encontrada em uma página que será compilada, o objeto ConnectionStringsExpressionBuilder gerará um código que recupera o cadeia de conexão especificado do arquivo Web.config. Se a expressão for encontrada em uma página que não será compilada, o ConnectionStringsExpressionBuilder objeto retornará o valor do arquivo Web.config quando a página for analisada.

Construtores

Nome Description
ConnectionStringsExpressionBuilder()

Inicializa uma nova instância da classe ConnectionStringsExpressionBuilder.

Propriedades

Nome Description
SupportsEvaluate

Retorna um valor que indica se uma expressão pode ser avaliada em uma página que não é compilada.

Métodos

Nome Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

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

Retorna um valor da <connectionStrings> seção do arquivo Web.config.
GetCodeExpression(BoundPropertyEntry, Object, ExpressionBuilderContext)

Retorna uma expressão de código a ser avaliada durante a análise de página.
GetConnectionString(String)

Retorna uma cadeia de conexão da <connectionStrings> seção do arquivo Web.config.
GetConnectionStringProviderName(String)

Retorna o provedor de cadeia de conexão da <connectionStrings> seção do arquivo Web.config.
GetHashCode()

Serve como a função hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

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

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

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também