Bagikan melalui

SqlDataSource.ConnectionString Properti

Definisi

Ruang nama:
System.Web.UI.WebControls
Rakitan:
System.Web.dll

Mendapatkan atau mengatur string koneksi khusus penyedia ADO.NET yang digunakan kontrol SqlDataSource untuk menyambungkan ke database yang mendasar.

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

Nilai Properti

String

String khusus penyedia data .NET Framework yang digunakan SqlDataSource untuk menyambungkan ke database SQL yang diwakilinya. Defaultnya adalah string kosong ("").

Contoh

Contoh kode berikut menunjukkan cara mengatur properti ConnectionString untuk menyambungkan ke database SQL Server dan menampilkan hasil properti SelectCommand dalam kontrol 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>

Keterangan

Kontrol SqlDataSource dapat digunakan dengan berbagai penyedia ADO.NET dan sintaks string koneksi yang digunakan untuk menyambungkan ke sumber data yang mendasar khusus untuk penyedia.

Saat mengonfigurasi kontrol SqlDataSource, Anda mengatur properti ProviderName ke jenis database (defaultnya adalah System.Data.SqlClient), dan Anda mengatur properti ConnectionString ke string koneksi yang menyertakan informasi yang diperlukan untuk menyambungkan ke database. Konten string koneksi berbeda tergantung pada jenis database apa yang diakses kontrol sumber data. Misalnya, kontrol SqlDataSource memerlukan nama server, nama database (katalog), dan informasi tentang cara mengautentikasi pengguna saat menyambungkan ke SQL Server. Untuk informasi tentang konten string koneksi, lihat properti ConnectionString untuk kelas SqlConnection, properti ConnectionString untuk kelas OracleConnection, properti ConnectionString untuk kelas OleDbConnection, atau properti ConnectionString untuk kelas OdbcConnection.

Jika Anda mengubah properti ConnectionString, peristiwa DataSourceChanged dinaikkan, menyebabkan kontrol apa pun yang terikat ke kontrol SqlDataSource untuk digabungkan kembali.

Penting

Untuk informasi tentang menyimpan string koneksi, lihat Cara: String Koneksi Aman saat Menggunakan Kontrol Sumber Data.

Berlaku untuk

Lihat juga

  • ProviderName
  • Kontrol Server Web Sumber Data
  • Gambaran Umum Kontrol Server Web SqlDataSource
  • Gambaran Umum Siklus Hidup Halaman ASP.NET