SqlConnection Sınıf

Tanım

Ad Alanı:

System.Data.SqlClient

Bütünleştirilmiş Kod:

System.Data.dll

SQL Server veritabanına bağlantıyı temsil eder. Bu sınıf devralınamaz.

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

Devralma

Object

MarshalByRefObject

Component

DbConnection

SqlConnection

Uygulamalar

ICloneable

Örnekler

Aşağıdaki örnek bir SqlCommand ve SqlConnectionoluşturur. SqlConnection açılır ve için Connectionolarak SqlCommand ayarlanır. Örnek daha sonra öğesini çağırır ExecuteNonQuery. Bunu başarmak için ExecuteNonQuery bir SqlConnection ve Transact-SQL INSERT deyimi olan bir sorgu dizesi geçirilir. Kod, using bloğundan çıktığında bağlantı otomatik olarak kapatılır.

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

Açıklamalar

SqlConnection nesnesi, SQL Server veri kaynağı için benzersiz bir oturumu temsil eder. İstemci/sunucu veritabanı sistemi ile sunucuya yapılan ağ bağlantısına eşdeğerdir. SqlConnection, Microsoft SQL Server veritabanı bağlanırken performansı artırmak için SqlDataAdapter ve SqlCommand ile birlikte kullanılır. Tüm üçüncü taraf SQL Server ürünleri ve OLE DB tarafından desteklenen diğer veri kaynakları için OleDbConnection kullanın.

örneğini SqlConnectionoluşturduğunuzda, tüm özellikler ilk değerlerine ayarlanır. Bu değerlerin listesi için oluşturucuya SqlConnection bakın.

bağlantı dizesi anahtar sözcüklerin listesi için bkz. ConnectionString.

SqlConnection kapsamı dışına çıkarsa kapatılamaz. Bu nedenle, veya Closeçağırarak Dispose bağlantıyı açıkça kapatmanız gerekir. Close ve Dispose işlevsel olarak eşdeğerdir. Bağlantı havuzu değeri Pooling veya trueolarak ayarlanırsayes, temel alınan bağlantı bağlantı havuzuna geri döndürülür. Öte yandan veya Poolingolarak ayarlanırsa falseno, sunucuya yönelik temel alınan bağlantı aslında kapatılır.

Uyarı

Bağlantı havuzundan bir bağlantı getirildiğinde veya bağlantı havuzuna döndürülürken bağlantı gerçekten kapatılmadığından, sunucuda oturum açma ve oturum kapatma olayları tetiklenmez. Daha fazla bilgi için SQL Server Bağlantı Havuzu (ADO.NET)'ne bakın.

Bağlantıların her zaman kapalı olduğundan emin olmak için aşağıdaki kod parçasında gösterildiği gibi bağlantıyı bir using bloğun içinde açın. Bunun yapılması, kod bloktan çıktığında bağlantının otomatik olarak kapatılmasını sağlar.

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

Uyarı

Yüksek performanslı uygulamalar dağıtmak için bağlantı havuzu kullanmanız gerekir. SQL Server için .NET Framework Veri Sağlayıcısı kullandığınızda, bazı ayarları değiştirebilmenize rağmen sağlayıcı bunu otomatik olarak yönettiğinden bağlantı havuzunu etkinleştirmeniz gerekmez. Daha fazla bilgi için SQL Server Bağlantı Havuzu (ADO.NET)'ne bakın.

bir SqlException yürüten SqlCommandSqlConnection yöntemi tarafından oluşturulursa, önem düzeyi 19 veya daha az olduğunda açık kalır. Önem düzeyi 20 veya daha yüksek olduğunda, sunucu normalde kapatır SqlConnection. Ancak kullanıcı bağlantıyı yeniden açabilir ve devam edebilir.

Nesnesinin bir örneğini SqlConnection oluşturan bir uygulama, bildirim temelli veya kesinlik temelli güvenlik taleplerini ayarlayarak tüm doğrudan ve dolaylı çağıranların kodda yeterli izne sahip olmasını gerektirebilir. SqlConnection nesnesini kullanarak güvenlik talepleri oluşturur SqlClientPermission . Kullanıcılar, nesnesini kullanarak SqlClientPermissionAttribute kodlarının yeterli izinlere sahip olduğunu doğrulayabilir. Kullanıcılar ve yöneticiler makine, kullanıcı ve kuruluş düzeylerinde güvenlik ilkesini değiştirmek için Caspol.exe (Kod Erişimi Güvenlik İlkesi Aracı) da kullanabilir. Daha fazla bilgi için bkz. .NET'te güvenlik. Güvenlik taleplerinin nasıl kullanılacağını gösteren bir örnek için bkz. Kod Erişim Güvenliği ve ADO.NET.

Sunucudan gelen uyarı ve bilgilendirme iletilerini işleme hakkında daha fazla bilgi için bkz. Bağlantı Olayları. SQL Server altyapısı hataları ve hata iletileri hakkında daha fazla bilgi için bkz. Database Engine Olaylar ve Hatalar.

Dikkat

Paylaşılan bellek yerine TCP'ye zorlayabilirsiniz. Bunu yapmak için tcp: ön ekini bağlantı dizesi sunucu adına ekleyebilir veya localhost kullanabilirsiniz.

Oluşturucular

Name	Description
SqlConnection()	SqlConnection sınıfının yeni bir örneğini başlatır.
SqlConnection(String, SqlCredential)	Kullanmayan SqlConnection bir bağlantı dizesi Integrated Security = true ve kullanıcı kimliği ile parolayı içeren bir nesne verilen sınıfın yeni bir SqlCredential örneğini başlatır.
SqlConnection(String)	Bağlantı dizesini SqlConnection içeren bir dize verildiğinde sınıfının yeni bir örneğini başlatır.

Özellikler

Name	Description
AccessToken	Bağlantı için erişim belirtecini alır veya ayarlar.
CanRaiseEvents	Bileşenin olay oluşturup oluşturamayacağını belirten bir değer alır. (Devralındığı yer: Component)
ClientConnectionId	Girişimin başarılı veya başarısız olmasına bakılmaksızın en son bağlantı girişiminin bağlantı kimliği.
ColumnEncryptionKeyCacheTtl	Always Encrypted özelliği için sütun şifreleme anahtarı önbelleğindeki sütun şifreleme anahtarı girişleri için yaşam süresini alır veya ayarlar. Varsayılan değer 2 saattir. 0, önbelleğe alma olmadığı anlamına gelir.
ColumnEncryptionQueryMetadataCacheEnabled	Always Encrypted etkin veritabanlarında çalıştırılan parametreli sorgular için sorgu meta verileri önbelleğe almanın etkinleştirilip etkinleştirilmediğini (true) veya değil (false) belirten bir değer alır veya ayarlar. Varsayılan değer doğru'dur.
ColumnEncryptionTrustedMasterKeyPaths	Veritabanı sunucusu için güvenilen anahtar yollarının listesini ayarlamanıza olanak tanır. Bir uygulama sorgusu işlenirken sürücü listede olmayan bir anahtar yolu alırsa, sorgu başarısız olur. Bu özellik, güvenliği aşılmış bir SQL Server sahte anahtar yolları sağlayarak anahtar deposu kimlik bilgilerinin sızmasına neden olabilecek güvenlik saldırılarına karşı ek koruma sağlar.
ConnectionString	SQL Server veritabanını açmak için kullanılan dizeyi alır veya ayarlar.
ConnectionTimeout	Denemeyi sonlandırmadan ve hata oluşturmadan önce bağlantı kurmaya çalışırken bekleme süresini (saniye cinsinden) alır.
Container	öğesini IContainer içeren öğesini Componentalır. (Devralındığı yer: Component)
Credential	Bu bağlantının SqlCredential nesnesini alır veya ayarlar.
Database	Bağlantı açıldıktan sonra kullanılacak geçerli veritabanının veya veritabanının adını alır.
DataSource	Bağlanacak SQL Server örneğinin adını alır.
DbProviderFactory	bunun DbProviderFactoryiçin öğesini DbConnection alır. (Devralındığı yer: DbConnection)
DesignMode	öğesinin şu anda tasarım modunda olup olmadığını Component gösteren bir değer alır. (Devralındığı yer: Component)
Events	Bu Componentöğesine eklenen olay işleyicilerinin listesini alır. (Devralındığı yer: Component)
FireInfoMessageEventOnUserErrors	özelliğini alır veya ayarlar FireInfoMessageEventOnUserErrors .
PacketSize	SQL Server örneğiyle iletişim kurmak için kullanılan ağ paketlerinin boyutunu (bayt cinsinden) alır.
ServerVersion	İstemcinin bağlı olduğu SQL Server örneğinin sürümünü içeren bir dize alır.
Site	öğesini alır veya ayarlar ISiteComponent. (Devralındığı yer: Component)
State	Bağlantıda SqlConnection gerçekleştirilen en son ağ işlemi sırasında durumunu gösterir.
StatisticsEnabled	olarak trueayarlandığında, geçerli bağlantı için istatistiklerin toplanmasını etkinleştirir.
WorkstationId	Veritabanı istemcisini tanımlayan bir dize alır.

Yöntemler

Name	Description
BeginDbTransaction(IsolationLevel)	Türetilmiş bir sınıfta geçersiz kılındığında bir veritabanı işlemi başlatır. (Devralındığı yer: DbConnection)
BeginTransaction()	Bir veritabanı işlemi başlatır.
BeginTransaction(IsolationLevel, String)	Belirtilen yalıtım düzeyine ve işlem adına sahip bir veritabanı işlemi başlatır.
BeginTransaction(IsolationLevel)	Belirtilen yalıtım düzeyine sahip bir veritabanı işlemi başlatır.
BeginTransaction(String)	Belirtilen işlem adıyla bir veritabanı işlemi başlatır.
ChangeDatabase(String)	Açık SqlConnectionbir için geçerli veritabanını değiştirir.
ChangePassword(String, SqlCredential, SecureString)	SqlCredential nesnesinde belirtilen kullanıcının SQL Server parolasını değiştirir.
ChangePassword(String, String)	Bağlantı dizesinde belirtilen kullanıcının SQL Server parolasını belirtilen yeni parolayla değiştirir.
ClearAllPools()	Bağlantı havuzunu boşaltın.
ClearPool(SqlConnection)	Belirtilen bağlantıyla ilişkili bağlantı havuzunu boşaltın.
Close()	Veritabanı bağlantısını kapatır. Bu, herhangi bir açık bağlantıyı kapatmak için tercih edilen yöntemdir.
CreateCommand()	ile SqlCommandilişkilendirilmiş bir SqlConnection nesne oluşturur ve döndürür.
CreateDbCommand()	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli bağlantıyla ilişkilendirilmiş bir DbCommand nesne oluşturur ve döndürür. (Devralındığı yer: DbConnection)
CreateObjRef(Type)	Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject)
EnlistDistributedTransaction(ITransaction)	Belirtilen işlemde dağıtılmış işlem olarak listeler.
EnlistTransaction(Transaction)	Belirtilen işlemde dağıtılmış işlem olarak listeler.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetLifetimeService()	Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject)
GetSchema()	Bu SqlConnectionveri kaynağı için şema bilgilerini döndürür. Düzen hakkında daha fazla bilgi için bkz. SQL Server Şema Koleksiyonları.
GetSchema(String, String[])	Şema adı için belirtilen dizeyi ve kısıtlama değerleri için belirtilen dize dizisini kullanarak bunun SqlConnection veri kaynağı için şema bilgilerini döndürür.
GetSchema(String)	Şema adı için belirtilen dizeyi kullanarak bunun SqlConnection veri kaynağı için şema bilgilerini döndürür.
GetService(Type)	veya Componenttarafından Container sağlanan bir hizmeti temsil eden bir nesnesi döndürür. (Devralındığı yer: Component)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
InitializeLifetimeService()	Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	Olayı tetikler StateChange . (Devralındığı yer: DbConnection)
Open()	tarafından ConnectionStringbelirtilen özellik ayarlarıyla bir veritabanı bağlantısı açar.
OpenAsync()	tarafından belirtilen Open()ayarlarla bir veritabanı bağlantısı açan zaman uyumsuz sürümüConnectionString. Bu yöntem CancellationToken.None ile sanal yöntemi OpenAsync(CancellationToken) çağırır. (Devralındığı yer: DbConnection)
OpenAsync(CancellationToken)	tarafından belirtilen Open()özellik ayarlarıyla bir veritabanı bağlantısı açan zaman uyumsuz sürümüConnectionString. İptal belirteci, bağlantı zaman aşımı tamamlanmadan önce işlemin terk edilmesi isteğinde bulunmak için kullanılabilir. Özel durumlar döndürülen Görev aracılığıyla yayılır. Bağlantı zaman aşımı süresi başarıyla bağlanmadan sona ererse, döndürülen Görev bir Özel Durum ile hatalı olarak işaretlenir. Uygulama, hem havuza alınan hem de havuza alınmayan bağlantılar için çağıran iş parçacığını engellemeden bir Görev döndürür.
RegisterColumnEncryptionKeyStoreProviders(IDictionary<String,SqlColumnEncryptionKeyStoreProvider>)	Sütun şifreleme anahtar deposu sağlayıcılarını kaydeder.
ResetStatistics()	İstatistik toplama etkinse, tüm değerler sıfıra sıfırlanır.
RetrieveStatistics()	Yöntemin çağrıldığı noktada istatistiklerden oluşan bir ad değer çifti koleksiyonu döndürür.
ToString()	Varsa, adını Stringiçeren bir Component döndürür. Bu yöntem geçersiz kılınmamalıdır. (Devralındığı yer: Component)

Ekinlikler

Name	Description
Disposed	Bileşen yöntemine Dispose() yapılan bir çağrıyla atıldığında gerçekleşir. (Devralındığı yer: Component)
InfoMessage	SQL Server bir uyarı veya bilgilendirme iletisi döndürdüğünde gerçekleşir.
StateChange	Bağlantının durumu değiştiğinde gerçekleşir. (Devralındığı yer: DbConnection)

Belirtik Arabirim Kullanımları

Name	Description
ICloneable.Clone()	Geçerli örneğin kopyası olan yeni bir nesne oluşturur.
IDbConnection.BeginTransaction()	Veritabanı işlemini başlatır. (Devralındığı yer: DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)	Belirtilen yalıtım düzeyine sahip bir veritabanı işlemi başlatır. (Devralındığı yer: DbConnection)
IDbConnection.CreateCommand()	Geçerli bağlantıyla ilişkili bir DbCommand nesne oluşturur ve döndürür. (Devralındığı yer: DbConnection)

Ayrıca bkz.

• ADO.NET'da Bir Veri Kaynağına Bağlanma
• SQL Server ve ADO.NET
• ADO.NET’e Genel Bakış