SqlConnection Sınıf

Tanım

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 ref class SqlConnection sealed : System::Data::Common::DbConnection
public ref class SqlConnection sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbConnection
public ref class SqlConnection sealed : System::Data::Common::DbConnection, ICloneable, IDisposable
public sealed class SqlConnection : System.Data.Common.DbConnection, ICloneable
public sealed class SqlConnection : System.Data.Common.DbConnection
public sealed class SqlConnection : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbConnection
public sealed class SqlConnection : System.Data.Common.DbConnection, ICloneable, IDisposable
type SqlConnection = class
    inherit DbConnection
    interface ICloneable
type SqlConnection = class
    inherit DbConnection
type SqlConnection = class
    inherit Component
    interface IDbConnection
    interface IDisposable
    interface ICloneable
type SqlConnection = class
    inherit DbConnection
    interface IDbConnection
    interface ICloneable
    interface IDisposable
Public NotInheritable Class SqlConnection
Inherits DbConnection
Implements ICloneable
Public NotInheritable Class SqlConnection
Inherits DbConnection
Public NotInheritable Class SqlConnection
Inherits Component
Implements ICloneable, IDbConnection, IDisposable
Public NotInheritable Class SqlConnection
Inherits DbConnection
Implements ICloneable, IDisposable
Devralma
SqlConnection
Devralma
Devralma
Uygulamalar

Örnekler

Aşağıdaki örnek bir SqlCommand ve SqlConnectionoluşturur. SqlConnection açılır ve için SqlCommandolarak Connection ayarlanır. Örnek daha sonra öğesini çağırır ExecuteNonQuery. Bunu başarmak için, ExecuteNonQuery bir bağlantı dizesi 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

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

ö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 bkzConnectionString.

SqlConnection kapsam dışına çıkarsa kapatılamaz. Bu nedenle, veya Disposeöğesini çağırarak Close 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 yesolarak ayarlanırsatrue, temel alınan bağlantı yeniden bağlantı havuzuna döndürülür. Öte yandan, veya noolarak ayarlanırsa Pooling false, sunucuya yönelik temel alınan bağlantı gerçekten kapatılır.

Not

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

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

Not

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 bkz. SQL Server Bağlantı Havuzu (ADO.NET).

aSqlException, bir 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 büyük 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 SqlClientPermission güvenlik talepleri oluşturur. 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üzeylerindeki 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şimi 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. Veritabanı Altyapısı 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

SqlConnection()

SqlConnection sınıfının yeni bir örneğini başlatır.

SqlConnection(String)

bağlantı dizesi içeren bir dize verildiğinde sınıfının yeni bir örneğini SqlConnection başlatır.

SqlConnection(String, SqlCredential)

bir bağlantı dizesi verilen sınıfının yeni bir örneğini SqlConnection başlatır; kullanıcı kimliği ve parolayı içeren bir SqlCredential nesne kullanmazIntegrated Security = true.

Özellikler

AccessToken

Bağlantı için erişim belirtecini alır veya ayarlar.

CanCreateBatch

Bu DbConnection örneğin sınıfı destekleyip desteklemediğini DbBatch gösteren bir değer alır.

(Devralındığı yer: DbConnection)
CanRaiseEvents

Bileşenin bir 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ı girdileri için yaşam süresini alır veya ayarlar. Varsayılan değer 2 saattir. 0, hiç önbelleğe alma anlamına gelir.

ColumnEncryptionQueryMetadataCacheEnabled

Etkinleştirilmiş Always Encrypted veritabanlarında çalışan parametreli sorgular için sorgu meta verilerini önbelleğe almanın etkin (true) veya etkin (yanlış) olup olmadığını belirten bir değer alır veya ayarlar. Varsayılan değer true şeklindedir.

ColumnEncryptionTrustedMasterKeyPaths

Veritabanı sunucusu için güvenilir 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.

Credentials
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 DbConnectioniçin öğesini DbProviderFactory 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

bir 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 ISite Component.

(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 ayarlandığında true, geçerli bağlantı için istatistiklerin toplanmasını etkinleştirir.

WorkstationId

Veritabanı istemcisini tanımlayan bir dize alır.

Yöntemler

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)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)

Zaman uyumsuz olarak bir veritabanı işlemi başlatır.

(Devralındığı yer: DbConnection)
BeginTransaction()

Bir veritabanı işlemi başlatır.

BeginTransaction(IsolationLevel)

Belirtilen yalıtım düzeyine sahip bir veritabanı işlemi başlatır.

BeginTransaction(IsolationLevel, String)

Belirtilen yalıtım düzeyi ve işlem adıyla bir veritabanı işlemi başlatır.

BeginTransaction(String)

Belirtilen işlem adıyla bir veritabanı işlemi başlatır.

BeginTransactionAsync(CancellationToken)

Zaman uyumsuz olarak bir veritabanı işlemi başlatır.

(Devralındığı yer: DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)

Zaman uyumsuz olarak bir veritabanı işlemi başlatır.

(Devralındığı yer: DbConnection)
ChangeDatabase(String)

Açık SqlConnectionbir için geçerli veritabanını değiştirir.

ChangeDatabaseAsync(String, CancellationToken)

Açık bağlantı için geçerli veritabanını zaman uyumsuz olarak değiştirir.

(Devralındığı yer: DbConnection)
ChangePassword(String, SqlCredential, SecureString)

Nesnede SqlCredential belirtilen kullanıcının SQL Server parolasını değiştirir.

ChangePassword(String, String)

bağlantı dizesi belirtilen kullanıcının SQL Server parolasını sağlanan 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, tüm açık bağlantıları kapatmak için tercih edilen yöntemdir.

CloseAsync()

Veritabanı bağlantısını zaman uyumsuz olarak kapatır.

(Devralındığı yer: DbConnection)
CreateBatch()

Sağlayıcı sınıfının sınıfını uygulayan yeni bir örneğini DbBatch döndürür.

(Devralındığı yer: DbConnection)
CreateCommand()

ile SqlConnectionilişkilendirilmiş bir SqlCommand nesne oluşturur ve döndürür.

CreateDbBatch()

Türetilmiş bir sınıfta geçersiz kılındığında, sağlayıcı sınıfının sınıfını uygulayan yeni bir örneğini DbBatch döndürür.

(Devralındığı yer: DbConnection)
CreateDbCommand()

Türetilmiş bir sınıfta geçersiz kılındığında, geçerli bağlantıyla ilişkili 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)
Dispose()

Uygulama tarafından tanımlanan, yönetilmeyen kaynakları serbest bırakma, salma veya sıfırlama ile ilişkili görevleri gerçekleştirir.

(Devralındığı yer: DbConnection)
Dispose()

Component tarafından kullanılan tüm kaynakları serbest bırakır.

(Devralındığı yer: Component)
Dispose(Boolean)

DbConnection tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır.

(Devralındığı yer: DbConnection)
Dispose(Boolean)

Component tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır.

(Devralındığı yer: Component)
DisposeAsync()

Zaman uyumsuz olarak bağlantı nesnesine daldırıyor.

(Devralındığı yer: DbConnection)
EnlistDistributedTransaction(ITransaction)

Belirtilen işlemdeki listeler dağıtılmış bir işlem olarak.

EnlistTransaction(Transaction)

Belirtilen işlemdeki listeler dağıtılmış bir işlem olarak.

EnlistTransaction(Transaction)

Belirtilen işlemdeki listeler.

(Devralındığı yer: DbConnection)
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()
Kullanımdan kalktı.

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 SqlConnectionöğesinin veri kaynağı için şema bilgilerini döndürür. Şema hakkında daha fazla bilgi için bkz. şema koleksiyonlarını SQL Server.

GetSchema()

Bu DbConnectionöğesinin veri kaynağı için şema bilgilerini döndürür.

(Devralındığı yer: DbConnection)
GetSchema(String)

Şema adı için belirtilen dizeyi kullanarak bunun SqlConnection veri kaynağı için şema bilgilerini döndürür.

GetSchema(String)

Şema adı için belirtilen dizeyi kullanarak bunun DbConnection veri kaynağı için şema bilgilerini döndürür.

(Devralındığı yer: DbConnection)
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, String[])

Şema adı için belirtilen dizeyi ve kısıtlama değerleri için belirtilen dize dizisini kullanarak bunun DbConnection veri kaynağı için şema bilgilerini döndürür.

(Devralındığı yer: DbConnection)
GetSchemaAsync(CancellationToken)

Bu, zaman uyumsuz bir sürümüdür GetSchema(). Sağlayıcılar uygun bir uygulamayla geçersiz kılmalıdır. cancellationToken isteğe bağlı olarak kabul edilebilir. Varsayılan uygulama zaman uyumlu GetSchema() çağrıyı çağırır ve tamamlanmış bir görev döndürür. Varsayılan uygulama, zaten iptal edilmiş bir geçirildiyse iptal edilmiş cancellationTokenbir görev döndürür. tarafından GetSchema() oluşan özel durumlar, döndürülen Görev Özel Durumu özelliği aracılığıyla iletilecektir.

(Devralındığı yer: DbConnection)
GetSchemaAsync(String, CancellationToken)

Bu, zaman uyumsuz sürümüdür GetSchema(String). Sağlayıcılar uygun bir uygulamayla geçersiz kılmalıdır. cancellationToken isteğe bağlı olarak kabul edilebilir. Varsayılan uygulama zaman uyumlu GetSchema(String) çağrıyı çağırır ve tamamlanmış bir görev döndürür. Varsayılan uygulama, zaten iptal edilmiş bir geçirildiyse iptal edilmiş cancellationTokenbir görev döndürür. tarafından GetSchema(String) oluşan özel durumlar, döndürülen Görev Özel Durumu özelliği aracılığıyla iletilecektir.

(Devralındığı yer: DbConnection)
GetSchemaAsync(String, String[], CancellationToken)

Bu, zaman uyumsuz sürümüdür GetSchema(String, String[]). Sağlayıcılar uygun bir uygulamayla geçersiz kılmalıdır. cancellationToken isteğe bağlı olarak kabul edilebilir. Varsayılan uygulama zaman uyumlu GetSchema(String, String[]) çağrıyı çağırır ve tamamlanmış bir görev döndürür. Varsayılan uygulama, zaten iptal edilmiş bir geçirildiyse iptal edilmiş cancellationTokenbir görev döndürür. tarafından GetSchema(String, String[]) oluşan özel durumlar, döndürülen Görev Özel Durumu özelliği aracılığıyla iletilecektir.

(Devralındığı yer: DbConnection)
GetService(Type)

veya tarafından Component Containersağlanan bir hizmeti temsil eden bir nesnesi döndürür.

(Devralındığı yer: Component)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
InitializeLifetimeService()
Kullanımdan kalktı.

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 Objectöğesinin sığ 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 ConnectionStringayarlarla bir veritabanı bağlantısı açan zaman uyumsuz sürümüOpen(). Bu yöntem CancellationToken.None ile sanal yöntemi OpenAsync(CancellationToken) çağırır.

(Devralındığı yer: DbConnection)
OpenAsync(CancellationToken)

tarafından belirtilen ConnectionStringözellik ayarlarıyla bir veritabanı bağlantısı açan zaman uyumsuz sürümüOpen(). İ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.

OpenAsync(CancellationToken)

Bu, zaman uyumsuz sürümüdür Open(). Sağlayıcılar uygun bir uygulamayla geçersiz kılmalıdır. İptal belirteci isteğe bağlı olarak kabul edilebilir.

Varsayılan uygulama zaman uyumlu Open() çağrıyı çağırır ve tamamlanmış bir görev döndürür. Varsayılan uygulama, iptal edilmiş bir cancellationToken geçirilirse iptal edilmiş bir görev döndürür. Open tarafından oluşan özel durumlar, döndürülen Görev Özel Durumu özelliği aracılığıyla iletilecektir.

Döndürülen Görev tamamlanana kadar nesnenin DbConnection diğer yöntemlerini ve özelliklerini çağırmayın.

(Devralındığı yer: DbConnection)
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ğeri çifti koleksiyonu döndürür.

ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)
ToString()

Varsa, adını Componentiçeren bir String döndürür. Bu yöntem geçersiz kılınmamalıdır.

(Devralındığı yer: Component)

Ekinlikler

Disposed

Bileşen yöntemine Dispose() yapılan bir çağrı tarafından 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.

StateChange

Bağlantının durumu değiştiğinde gerçekleşir.

(Devralındığı yer: DbConnection)

Belirtik Arabirim Kullanımları

ICloneable.Clone()

Geçerli örneğin kopyası olan yeni bir nesne oluşturur.

IDbConnection.BeginTransaction()

Bir veritabanı işlemi başlatır.

IDbConnection.BeginTransaction()

Veritabanı işlemini başlatır.

(Devralındığı yer: DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)

Belirtilen IsolationLevel değerle bir veritabanı işlemi başlatır.

IDbConnection.BeginTransaction(IsolationLevel)

Belirtilen yalıtım düzeyine sahip bir veritabanı işlemi başlatır.

(Devralındığı yer: DbConnection)
IDbConnection.CreateCommand()

Bağlantıyla ilişkili bir Command nesnesi oluşturur ve döndürür.

IDbConnection.CreateCommand()

Geçerli bağlantıyla ilişkili bir DbCommand nesne oluşturur ve döndürür.

(Devralındığı yer: DbConnection)

Şunlara uygulanır

Ayrıca bkz.