SqlDataSource.ConnectionString Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.dll

Obtém ou define a cadeia de ligação específica do fornecedor ADO.NET que o controlo SqlDataSource usa para se ligar a uma base de dados subjacente.

public:
 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };
public virtual string ConnectionString { get; set; }
member this.ConnectionString : string with get, set
Public Overridable Property ConnectionString As String

Valor de Propriedade

String

Uma cadeia específica do fornecedor de dados do .NET Framework que o SqlDataSource usa para se ligar à base de dados SQL que representa. O padrão é uma cadeia vazia ("").

Exemplos

O exemplo de código seguinte demonstra como definir a propriedade ConnectionString para se ligar a uma base de dados SQL Server e mostrar os resultados da propriedade SelectCommand 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>

Observações

O controlo SqlDataSource pode ser usado com vários fornecedores de ADO.NET e a sintaxe do cadeia de ligação usado para se ligar a uma fonte de dados subjacente é específica do fornecedor.

Quando configuras um controlo SqlDataSource, defines a propriedade ProviderName para o tipo de base de dados (o padrão é System.Data.SqlClient), e defines a propriedade ConnectionString para um cadeia de ligação que inclui a informação necessária para se ligar à base de dados. O conteúdo de uma cadeia de ligação varia consoante o tipo de base de dados a que o controlo de fontes de dados está a aceder. Por exemplo, o controlo SqlDataSource requer um nome de servidor, nome de base de dados (catálogo) e informações sobre como autenticar o utilizador ao ligar a um SQL Server. Para informações sobre o conteúdo das cadeias de ligação, veja a propriedade da SqlConnection classe, ConnectionString propriedade da OracleConnection classe, ConnectionString propriedade da OleDbConnection classe ou propriedade ConnectionString da OdbcConnection classe.ConnectionString

Se alterar a ConnectionString propriedade, o DataSourceChanged evento é elevado, fazendo com que quaisquer controlos ligados ao SqlDataSource controlo se reassociem.

Importante

Para informações sobre como armazenar um cadeia de ligação, veja How To: Secure Connection Strings ao usar controlos de fonte de dados.

Aplica-se a

Ver também