SqlConnection Kelas

Definisi

Ruang nama:

System.Data.SqlClient

Rakitan:

System.Data.SqlClient.dll

Paket:

System.Data.SqlClient v4.8.6

Mewakili koneksi ke database SQL Server. Kelas ini tidak dapat diwariskan.

public ref class SqlConnection sealed : System::Data::Common::DbConnection, ICloneable

public sealed class SqlConnection : System.Data.Common.DbConnection, ICloneable

type SqlConnection = class
    inherit DbConnection
    interface ICloneable

Public NotInheritable Class SqlConnection
Inherits DbConnection
Implements ICloneable

Warisan

Object

DbConnection

SqlConnection

Penerapan

ICloneable

Contoh

Contoh berikut membuat SqlCommand dan SqlConnection. SqlConnection dibuka dan ditetapkan sebagai Connection untuk SqlCommand. Contohnya kemudian memanggil ExecuteNonQuery. Untuk mencapai hal ini, ExecuteNonQuery diteruskan SqlConnection dan string kueri yang merupakan pernyataan TRANSACT-SQL INSERT. Koneksi ditutup secara otomatis ketika kode keluar dari blok penggunaan.

private static void CreateCommand(string queryString,
    string connectionString)
{
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        SqlCommand command = new SqlCommand(queryString, connection);
        command.Connection.Open();
        command.ExecuteNonQuery();
    }
}

Public Sub CreateCommand(ByVal queryString As String, _
  ByVal connectionString As String)
    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)
        command.Connection.Open()
        command.ExecuteNonQuery()
    End Using
End Sub

Keterangan

Objek SqlConnection mewakili sesi unik ke sumber data SQL Server. Dengan sistem database klien/server, itu setara dengan koneksi jaringan ke server. SqlConnectiondigunakan bersama dengan SqlDataAdapter dan SqlCommand untuk meningkatkan performa saat menyambungkan ke database Microsoft SQL Server. Untuk semua produk SQL Server pihak ketiga dan sumber data lain yang didukung OLE DB, gunakan OleDbConnection.

Saat Anda membuat instans SqlConnection, semua properti diatur ke nilai awalnya. Untuk daftar nilai-nilai ini, lihat SqlConnection konstruktor.

Lihat ConnectionString untuk daftar kata kunci dalam string koneksi.

SqlConnection Jika keluar dari cakupan, itu tidak akan ditutup. Oleh karena itu, Anda harus secara eksplisit menutup koneksi dengan memanggil Close atau Dispose. Close dan Dispose setara secara fungsional. Jika nilai Pooling pengumpulan koneksi diatur ke true atau yes, koneksi yang mendasar dikembalikan ke kumpulan koneksi. Di sisi lain, jika Pooling diatur ke false atau no, koneksi yang mendasar ke server benar-benar ditutup.

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).

Untuk memastikan bahwa koneksi selalu ditutup, buka koneksi di dalam blok, seperti yang using ditunjukkan dalam fragmen kode berikut. Melakukannya memastikan bahwa koneksi ditutup secara otomatis saat kode keluar dari blok.

Using connection As New SqlConnection(connectionString)
    connection.Open()
    ' Do work here; connection closed on following line.
End Using

using (SqlConnection connection = new SqlConnection(connectionString))
    {
        connection.Open();
        // Do work here; connection closed on following line.
    }

Catatan

Untuk menyebarkan aplikasi berkinerja tinggi, Anda harus menggunakan pengumpulan koneksi. Saat Anda menggunakan Penyedia Data .NET Framework untuk SQL Server, Anda tidak perlu mengaktifkan pengumpulan koneksi karena penyedia mengelola ini secara otomatis, meskipun Anda dapat mengubah beberapa pengaturan. Untuk informasi selengkapnya, lihat Kumpulan Koneksi SQL Server (ADO.NET).

SqlException Jika dihasilkan oleh metode yang mengeksekusi SqlCommand, SqlConnection tetap terbuka ketika tingkat keparahan adalah 19 atau kurang. Ketika tingkat keparahan adalah 20 atau lebih besar, server biasanya menutup SqlConnection. Namun, pengguna dapat membuka kembali koneksi dan melanjutkan.

Aplikasi yang membuat instans SqlConnection objek dapat mengharuskan semua penelepon langsung dan tidak langsung memiliki izin yang memadai ke kode dengan mengatur tuntutan keamanan deklaratif atau imperatif. SqlConnection membuat tuntutan keamanan menggunakan SqlClientPermission objek . Pengguna dapat memverifikasi bahwa kode mereka memiliki izin yang memadai dengan menggunakan SqlClientPermissionAttribute objek . Pengguna dan administrator juga dapat menggunakan Caspol.exe (Alat Kebijakan Keamanan Akses Kode) untuk memodifikasi kebijakan keamanan di tingkat mesin, pengguna, dan perusahaan. Untuk informasi selengkapnya, lihat Keamanan di .NET. Untuk contoh yang menunjukkan cara menggunakan tuntutan keamanan, lihat Keamanan Akses Kode dan ADO.NET.

Untuk informasi selengkapnya tentang menangani pesan peringatan dan informasi dari server, lihat Peristiwa Koneksi. Untuk informasi selengkapnya tentang kesalahan mesin SQL Server dan pesan kesalahan, lihat Peristiwa dan Kesalahan Mesin Database.

Perhatian

Anda dapat memaksa TCP alih-alih memori bersama. Anda dapat melakukannya dengan mengawali tcp: ke nama server di string koneksi atau Anda dapat menggunakan localhost.

Konstruktor

SqlConnection()	Menginisialisasi instans baru kelas SqlConnection.
SqlConnection(String)	Menginisialisasi instans SqlConnection baru kelas saat diberikan string yang berisi string koneksi.
SqlConnection(String, SqlCredential)	Menginisialisasi instans baru kelas SqlConnection yang diberikan string koneksi, yang tidak menggunakan Integrated Security = true dan SqlCredential objek yang berisi ID pengguna dan kata sandi.

Properti

AccessToken	Mendapatkan atau mengatur token akses untuk koneksi.
CanCreateBatch	Mendapatkan nilai yang menunjukkan apakah instans DbBatch ini DbConnection mendukung kelas . (Diperoleh dari DbConnection)
ClientConnectionId	ID koneksi dari upaya koneksi terbaru, terlepas dari apakah upaya berhasil atau gagal.
ConnectionString	Mendapatkan atau mengatur string yang digunakan untuk membuka database SQL Server.
ConnectionTimeout	Mendapatkan waktu untuk menunggu (dalam detik) saat mencoba membuat koneksi sebelum mengakhiri upaya dan menghasilkan kesalahan.
Credential	Mendapatkan atau menyetel SqlCredential objek untuk sambungan ini.
Database	Mendapatkan nama database saat ini atau database yang akan digunakan setelah koneksi dibuka.
DataSource	Mendapatkan nama instans SQL Server yang akan disambungkan.
DbProviderFactory	DbProviderFactory Mendapatkan untuk iniDbConnection. (Diperoleh dari DbConnection)
FireInfoMessageEventOnUserErrors	Mendapatkan atau mengatur FireInfoMessageEventOnUserErrors properti .
PacketSize	Mendapatkan ukuran (dalam byte) paket jaringan yang digunakan untuk berkomunikasi dengan instans SQL Server.
ServerVersion	Mendapatkan string yang berisi versi instans SQL Server yang terhubung dengan klien.
State	Menunjukkan status SqlConnection selama operasi jaringan terbaru yang dilakukan pada koneksi.
StatisticsEnabled	Ketika diatur ke true, memungkinkan pengumpulan statistik untuk koneksi saat ini.
WorkstationId	Mendapatkan string yang mengidentifikasi klien database.

Metode

BeginDbTransaction(IsolationLevel)	Saat ditimpa di kelas turunan, memulai transaksi database. (Diperoleh dari DbConnection)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	Secara asinkron memulai transaksi database. (Diperoleh dari DbConnection)
BeginTransaction()	Memulai transaksi database.
BeginTransaction(IsolationLevel)	Memulai transaksi database dengan tingkat isolasi yang ditentukan.
BeginTransaction(IsolationLevel, String)	Memulai transaksi database dengan tingkat isolasi dan nama transaksi yang ditentukan.
BeginTransaction(String)	Memulai transaksi database dengan nama transaksi yang ditentukan.
BeginTransactionAsync(CancellationToken)	Secara asinkron memulai transaksi database. (Diperoleh dari DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)	Secara asinkron memulai transaksi database. (Diperoleh dari DbConnection)
ChangeDatabase(String)	Mengubah database saat ini untuk yang terbuka SqlConnection.
ChangeDatabaseAsync(String, CancellationToken)	Secara asinkron mengubah database saat ini untuk koneksi terbuka. (Diperoleh dari DbConnection)
ChangePassword(String, SqlCredential, SecureString)	Mengubah kata sandi SQL Server untuk pengguna yang ditunjukkan dalam SqlCredential objek .
ChangePassword(String, String)	Mengubah kata sandi SQL Server untuk pengguna yang ditunjukkan dalam string koneksi ke kata sandi baru yang disediakan.
ClearAllPools()	Mengolah kumpulan koneksi.
ClearPool(SqlConnection)	Mengolah kumpulan koneksi yang terkait dengan koneksi yang ditentukan.
Close()	Menutup koneksi ke database. Ini adalah metode yang disukai untuk menutup koneksi terbuka apa pun.
CloseAsync()	Secara asinkron menutup koneksi ke database. (Diperoleh dari DbConnection)
CreateBatch()	Mengembalikan instans baru kelas penyedia yang mengimplementasikan DbBatch kelas . (Diperoleh dari DbConnection)
CreateCommand()	Membuat dan mengembalikan objek yang SqlCommand terkait dengan SqlConnection.
CreateDbBatch()	Saat ditimpa di kelas turunan, mengembalikan instans baru kelas penyedia yang mengimplementasikan DbBatch kelas . (Diperoleh dari DbConnection)
CreateDbCommand()	Saat ditimpa di kelas turunan, membuat dan mengembalikan objek yang DbCommand terkait dengan koneksi saat ini. (Diperoleh dari DbConnection)
Dispose()	Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, merilis, atau mengatur ulang sumber daya yang tidak dikelola. (Diperoleh dari DbConnection)
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang digunakan oleh DbConnection dan secara opsional merilis sumber daya terkelola. (Diperoleh dari DbConnection)
DisposeAsync()	Secara asinkron membuang objek koneksi. (Diperoleh dari DbConnection)
EnlistTransaction(Transaction)	Mendaftarkan dalam transaksi yang ditentukan sebagai transaksi terdistribusi.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetSchema()	Mengembalikan informasi skema untuk sumber data ini SqlConnection. Untuk informasi selengkapnya tentang skema, lihat SQL Server Koleksi Skema.
GetSchema(String)	Mengembalikan informasi skema untuk sumber data ini SqlConnection menggunakan string yang ditentukan untuk nama skema.
GetSchema(String, String[])	Mengembalikan informasi skema untuk sumber data ini SqlConnection menggunakan string yang ditentukan untuk nama skema dan array string yang ditentukan untuk nilai pembatasan.
GetSchemaAsync(CancellationToken)	Ini adalah versi asinkron dari GetSchema(). Penyedia harus mengambil alih dengan implementasi yang sesuai. cancellationToken secara opsional dapat dihormati. Implementasi default memanggil panggilan sinkron GetSchema() dan mengembalikan tugas yang selesai. Implementasi default akan mengembalikan tugas yang dibatalkan jika lulus yang sudah dibatalkan cancellationToken. Pengecualian yang dilemparkan GetSchema() akan dikomunikasikan melalui properti Pengecualian Tugas yang dikembalikan. (Diperoleh dari DbConnection)
GetSchemaAsync(String, CancellationToken)	Ini adalah versi asinkron dari GetSchema(String). Penyedia harus mengambil alih dengan implementasi yang sesuai. cancellationToken secara opsional dapat dihormati. Implementasi default memanggil panggilan sinkron GetSchema(String) dan mengembalikan tugas yang selesai. Implementasi default akan mengembalikan tugas yang dibatalkan jika lulus yang sudah dibatalkan cancellationToken. Pengecualian yang dilemparkan GetSchema(String) akan dikomunikasikan melalui properti Pengecualian Tugas yang dikembalikan. (Diperoleh dari DbConnection)
GetSchemaAsync(String, String[], CancellationToken)	Ini adalah versi asinkron dari GetSchema(String, String[]). Penyedia harus mengambil alih dengan implementasi yang sesuai. cancellationToken secara opsional dapat dihormati. Implementasi default memanggil panggilan sinkron GetSchema(String, String[]) dan mengembalikan tugas yang selesai. Implementasi default akan mengembalikan tugas yang dibatalkan jika lulus yang sudah dibatalkan cancellationToken. Pengecualian yang dilemparkan GetSchema(String, String[]) akan dikomunikasikan melalui properti Pengecualian Tugas yang dikembalikan. (Diperoleh dari DbConnection)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
OnStateChange(StateChangeEventArgs)	Memunculkan kejadian StateChange. (Diperoleh dari DbConnection)
Open()	Membuka koneksi database dengan pengaturan properti yang ditentukan oleh ConnectionString.
OpenAsync()	Versi asinkron dari Open(), yang membuka koneksi database dengan pengaturan yang ditentukan oleh ConnectionString. Metode ini memanggil metode OpenAsync(CancellationToken) virtual dengan CancellationToken.None. (Diperoleh dari DbConnection)
OpenAsync(CancellationToken)	Versi asinkron dari Open(), yang membuka koneksi database dengan pengaturan properti yang ditentukan oleh ConnectionString. Token pembatalan dapat digunakan untuk meminta agar operasi ditinggalkan sebelum batas waktu koneksi berlalu. Pengecualian akan disebarluaskan melalui Tugas yang dikembalikan. Jika waktu habis koneksi berlalu tanpa berhasil menyambungkan, Tugas yang dikembalikan akan ditandai sebagai rusak dengan Pengecualian. Implementasi mengembalikan Tugas tanpa memblokir utas panggilan untuk koneksi yang dikumpulkan dan tidak terkumpul.
ResetStatistics()	Jika pengumpulan statistik diaktifkan, semua nilai diatur ulang ke nol.
RetrieveStatistics()	Mengembalikan kumpulan pasangan nilai nama statistik pada titik waktu metode dipanggil.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Acara

InfoMessage	Terjadi ketika SQL Server mengembalikan pesan peringatan atau informasi.
StateChange	Terjadi ketika status koneksi berubah. (Diperoleh dari DbConnection)

Implementasi Antarmuka Eksplisit

ICloneable.Clone()

Membuat objek baru yang merupakan salinan instans saat ini.

Lihat juga

• Menyambungkan ke Sumber Data di ADO.NET
• SQL Server dan ADO.NET
• Ringkasan ADO.NET