Membuat Koneksi

  • Artikel

Untuk menyambungkan ke Microsoft SQL Server, gunakan objek SqlConnection Penyedia Data .NET Framework untuk SQL Server. Untuk menyambungkan ke sumber data OLE DB, gunakan objek OleDbConnection Penyedia Data .NET Framework untuk OLE DB. Untuk menyambungkan ke sumber data ODBC, gunakan objek OdbcConnection Penyedia Data .NET Framework untuk ODBC. Untuk menyambungkan ke sumber data Oracle, gunakan objek OracleConnection Penyedia Data .NET Framework untuk Oracle. Untuk menyimpan dan mengambil string koneksi dengan aman, lihat Melindungi Informasi Koneksi.

Menutup Koneksi

Kami menyarankan agar Anda selalu menutup koneksi ketika Anda selesai menggunakannya, sehingga koneksi dapat dikembalikan ke kumpulan. Blok Using di Visual Basic atau C# secara otomatis membuang koneksi ketika kode keluar dari blok, bahkan dalam kasus pengecualian yang tidak tertangani. Lihat menggunakan pernyataan dan Menggunakan Pernyataan untuk informasi selengkapnya.

Anda juga dapat menggunakan metode Close atau Dispose objek koneksi untuk penyedia yang Anda gunakan. Koneksi yang tidak ditutup secara eksplisit mungkin tidak ditambahkan atau dikembalikan ke kumpulan. Misalnya, koneksi yang telah keluar dari cakupan tetapi belum ditutup secara eksplisit hanya akan dikembalikan ke kumpulan koneksi jika ukuran kumpulan maksimum telah tercapai dan koneksi masih berlaku. Untuk informasi selengkapnya, lihat Pengumpulan Koneksi OLE DB, ODBC, dan Oracle.

Catatan

Jangan memanggil Close atau Dispose pada Koneksi, DataReader, atau objek terkelola lainnya dalam metode Finalize kelas Anda. Di penyelesai, hanya merilis sumber daya yang tidak dikelola yang kelas Anda miliki secara langsung. Jika kelas Anda tidak memiliki sumber daya yang tidak dikelola, jangan sertakan metode Finalize dalam definisi kelas Anda. Untuk informasi selengkapnya, lihat Pengumpulan Sampah.

Catatan

Peristiwa masuk dan keluar tidak akan dinaikkan di server ketika koneksi diambil dari atau dikembalikan ke kumpulan koneksi, karena koneksi tidak benar-benar ditutup ketika dikembalikan ke kumpulan koneksi. Untuk informasi selengkapnya, lihat Kumpulan Koneksi SQL Server (ADO.NET).

Menyambungkan ke SQL Server

Penyedia Data .NET Framework untuk SQL Server mendukung format string koneksi yang mirip dengan format string koneksi OLE DB (ADO). Untuk nama dan nilai format string yang valid, lihat properti ConnectionString objek SqlConnection. Anda juga dapat menggunakan kelas SqlConnectionStringBuilder untuk membuat string koneksi yang valid secara sintaksis pada durasi. Untuk informasi selengkapnya, lihat Pembuat String Koneksi.

Contoh kode berikut menunjukkan cara membuat dan membuka koneksi ke database SQL Server.

' Assumes connectionString is a valid connection string.  
Using connection As New SqlConnection(connectionString)  
    connection.Open()  
    ' Do work here.  
End Using  

// Assumes connectionString is a valid connection string.  
using (SqlConnection connection = new SqlConnection(connectionString))  
{  
    connection.Open();  
    // Do work here.  
}

Keamanan dan ASP.NET Terintegrasi

SQL Server keamanan terintegrasi (juga dikenal sebagai koneksi tepercaya) membantu memberikan perlindungan saat menyambungkan ke SQL Server karena tidak mengekspos ID pengguna dan kata sandi dalam string koneksi dan merupakan metode yang direkomendasikan untuk mengautentikasi koneksi. Keamanan terintegrasi menggunakan identitas keamanan saat ini, atau token, dari proses eksekusi. Untuk aplikasi desktop, ini biasanya merupakan identitas pengguna yang saat ini masuk.

Identitas keamanan untuk aplikasi ASP.NET dapat diatur ke salah satu dari beberapa opsi yang berbeda. Untuk lebih memahami identitas keamanan yang digunakan aplikasi ASP.NET saat menyambungkan ke SQL Server, lihat ASP.NET Peniruan, Autentikasi ASP.NET, dan Cara: Mengakses SQL Server Menggunakan Keamanan Terintegrasi Windows.

Menyambungkan ke Sumber Data OLE DB

Penyedia Data .NET Framework untuk OLE DB menyediakan konektivitas ke sumber data yang diekspos menggunakan OLE DB (melalui SQLOLEDB, Penyedia OLE DB untuk SQL Server), menggunakan objek OleDbConnection.

Untuk Penyedia Data .NET Framework untuk OLE DB, format string koneksi identik dengan format string koneksi yang digunakan dalam ADO, dengan pengecualian berikut:

  • Kata kunci Penyedia diperlukan.

  • Kata kunci URL, Penyedia Jarak Jauh, dan Server Jarak Jauh tidak didukung.

Untuk informasi selengkapnya tentang string koneksi OLE DB, lihat topik ConnectionString. Anda juga dapat menggunakan OleDbConnectionStringBuilder untuk membuat string koneksi pada durasi.

Catatan

Objek OleDbConnection tidak mendukung pengaturan atau pengambilan properti dinamis khusus untuk penyedia OLE DB. Hanya properti yang dapat diteruskan dalam string koneksi untuk penyedia OLE DB yang didukung.

Contoh kode berikut menunjukkan cara membuat dan membuka koneksi ke sumber data OLE DB.

' Assumes connectionString is a valid connection string.  
Using connection As New OleDbConnection(connectionString)  
    connection.Open()  
    ' Do work here.  
End Using  

// Assumes connectionString is a valid connection string.  
using (OleDbConnection connection =
  new OleDbConnection(connectionString))  
{  
    connection.Open();  
    // Do work here.  
}

Dimungkinkan untuk menyediakan informasi koneksi untuk OleDbConnection dalam file Universal Data Link (UDL); namun Anda harus menghindari melakukannya. File UDL tidak dienkripsi, dan memaparkan informasi string koneksi dalam teks yang jelas. Karena file UDL adalah sumber daya berbasis file eksternal ke aplikasi Anda, file tersebut tidak dapat diamankan menggunakan .NET Framework.

Menyambungkan ke Sumber Data ODBC

Penyedia Data .NET Framework untuk ODBC menyediakan konektivitas ke sumber data yang diekspos menggunakan ODBC menggunakan objek OdbcConnection.

Untuk Penyedia Data .NET Framework untuk ODBC, format string koneksi dirancang agar sesuai dengan format string koneksi ODBC sedekat mungkin. Anda juga dapat menyediakan nama sumber data ODBC (DSN). Untuk detail selengkapnya tentang OdbcConnection, lihat OdbcConnection.

Contoh kode berikut menunjukkan cara membuat dan membuka koneksi ke sumber data ODBC.

' Assumes connectionString is a valid connection string.  
Using connection As New OdbcConnection(connectionString)  
    connection.Open()  
    ' Do work here.  
End Using  

// Assumes connectionString is a valid connection string.  
using (OdbcConnection connection =
  new OdbcConnection(connectionString))  
{  
    connection.Open();  
    // Do work here.  
}

Menyambungkan ke Sumber Data Oracle

Penyedia Data .NET Framework untuk Oracle menyediakan konektivitas ke sumber data Oracle menggunakan objek OracleConnection.

Untuk Penyedia Data .NET Framework untuk Oracle, format string koneksi dirancang agar sesuai dengan format string koneksi Penyedia OLE DB untuk Oracle (MSDAORA) sedekat mungkin. Untuk detail selengkapnya tentang OracleConnection, lihat OracleConnection.

Contoh kode berikut menunjukkan cara membuat dan membuka koneksi ke sumber data Oracle.

' Assumes connectionString is a valid connection string.  
Using connection As New OracleConnection(connectionString)  
    connection.Open()  
    ' Do work here.  
End Using  

// Assumes connectionString is a valid connection string.  
using (OracleConnection connection =
  new OracleConnection(connectionString))  
{  
    connection.Open();  
    // Do work here.  
}  
OracleConnection nwindConn = new OracleConnection("Data Source=MyOracleServer;Integrated Security=yes;");  
nwindConn.Open();

Lihat juga