SqlConnection Sınıf

Tanım

Ad Alanı:

Microsoft.Data.SqlClient

Bütünleştirilmiş Kod:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

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

DbConnection

SqlConnection

Uygulamalar

ICloneable

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

using System;
using System.Data;
using Microsoft.Data.SqlClient;

namespace SqlCommandCS
{
    class Program
    {
        static void Main()
        {
            string str = "Data Source=(local);Initial Catalog=Northwind;"
                + "Integrated Security=SSPI";
            string qs = "SELECT OrderID, CustomerID FROM dbo.Orders;";
            CreateCommand(qs, str);
        }
        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();
            }
        }
    }
}

Açıklamalar

Nesne, SqlConnection 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. 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 Poolingfalse, 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ı'nı kullandığınızda, bazı ayarları değiştirebilmenize rağmen sağlayıcı bunu otomatik olarak yönettiğinden bağlantı havuzu oluşturmayı 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 SqlConnection bir örneğini oluşturan bir uygulama, bildirim temelli veya kesinlik temelli güvenlik talepleri ayarlayarak tüm doğrudan ve dolaylı çağıranların koda yeterli iznine 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ş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. 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.
AccessTokenCallback	Bağlantı için erişim belirteci geri çağırmasını alır veya ayarlar.
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.
CommandTimeout	Komut yürütme girişimini sonlandırmadan ve hata oluşturmadan önce varsayılan bekleme süresini (saniye cinsinden) alır. Varsayılan değer 30 saniyedir.
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 alır.
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.
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.
RetryLogicProvider	Bu komuta bağlı nesneyi belirten SqlRetryLogicBaseProvider bir değer alır veya ayarlar.
ServerProcessId	Etkin bağlantının sunucu işlem kimliğini (SPID) alır.
ServerVersion	İstemcinin bağlı olduğu SQL Server örneğinin sürümünü içeren bir dize alır.
State	Bağlantı üzerinde 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

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.
ChangeDatabase(String)	Açık SqlConnectionbir için geçerli veritabanını değiştirir.
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.
CreateCommand()	ile SqlConnectionilişkilendirilmiş bir SqlCommand nesne oluşturur ve döndürür.
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(String)	Şema adı için belirtilen dizeyi 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 SqlConnection veri kaynağı için şema bilgilerini döndürür.
Open()	tarafından ConnectionStringbelirtilen özellik ayarlarıyla bir veritabanı bağlantısı açar.
Open(SqlConnectionOverrides)	tarafından ConnectionStringbelirtilen özellik ayarlarıyla bir veritabanı bağlantısı açar.
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 iptal 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. Bu işlev uygulamada yalnızca bir kez çağrılmalıdır. Bu, uygulamanın ayarlandıktan sonra özel sağlayıcı listesini değiştirememesi için sözlüğün sığ bir şekilde kopyalanmasını yapar. Windows Sertifika Deposu, CNG Deposu ve CSP için kullanılabilen yerleşik sütun ana anahtar deposu sağlayıcıları önceden kaydedilmiştir.
RegisterColumnEncryptionKeyStoreProvidersOnConnection(IDictionary<String,SqlColumnEncryptionKeyStoreProvider>)	Örnekteki şifreleme anahtarı deposu sağlayıcılarını SqlConnection kaydeder. Bu işlev çağrıldıysa, statik RegisterColumnEncryptionKeyStoreProviders(IDictionary<String,SqlColumnEncryptionKeyStoreProvider>) yöntemler kullanılarak kaydedilen tüm sağlayıcılar yoksayılır. Bu işlev birden çok kez çağrılabilir. Bu, uygulamanın ayarlandıktan sonra özel sağlayıcı listesini değiştirememesi için sözlüğün sığ bir şekilde kopyalanmasını yapar.
ResetStatistics()	İstatistik toplama etkinse, tüm değerler sıfırlanır.
RetrieveInternalInfo()	Yöntemin çağrıldığı noktada iç özelliklerden oluşan bir ad değer çifti koleksiyonu döndürür.
RetrieveStatistics()	Yöntemin çağrıldığı noktada istatistiklerden oluşan bir ad değer çifti koleksiyonu döndürür.

Ekinlikler

InfoMessage

SQL Server bir uyarı veya bilgilendirme iletisi döndürdüğünde gerçekleşir.

Belirtik Arabirim Kullanımları

ICloneable.Clone()

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