共用方式為

SqlDataSource.ConnectionString 屬性

  • 參考

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

取得或設定 ADO.NET 提供者特定的連接字串，SqlDataSource 控件用來連接到基礎資料庫。

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

屬性值

String

.NET Framework 數據提供者特定字串，SqlDataSource 用來連接到它所代表的 SQL 資料庫。 默認值為空字串 （“” ）。

範例

下列程式代碼範例示範如何將 ConnectionString 屬性設定為連接到 SQL Server 資料庫，並在 GridView 控件中顯示 SelectCommand 屬性的結果。

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

備註

SqlDataSource 控件可以搭配各種 ADO.NET 提供者使用，以及用來連接到基礎數據源的連接字串語法是提供者特有的。

當您設定 SqlDataSource 控件時，會將 ProviderName 屬性設定為資料庫類型（預設值為 System.Data.SqlClient），並將 ConnectionString 屬性設定為連接字串，其中包含連線到資料庫所需的資訊。 連接字串的內容會根據數據源控件所存取的資料庫類型而有所不同。 例如，SqlDataSource 控件需要伺服器名稱、資料庫 （catalog） 名稱和連線到 SQL Server 時如何驗證使用者的相關信息。 如需連接字串內容的詳細資訊，請參閱 SqlConnection 類別的 ConnectionString 屬性、OracleConnection 類別的 ConnectionString 屬性、OleDbConnection 類別的 ConnectionString 屬性，或 OdbcConnection 類別的 ConnectionString 屬性。

如果您變更 ConnectionString 屬性，就會引發 DataSourceChanged 事件，導致系結至 SqlDataSource 控件的任何控件重新系結。

重要

如需儲存連接字串的相關信息，請參閱使用資料源控件時 如何：保護連接字串。

適用於

另請參閱