OdbcConnection Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Bir veri kaynağına açık bağlantıyı temsil eder.
public ref class OdbcConnection sealed : System::Data::Common::DbConnection, ICloneable
public ref class OdbcConnection sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbConnection
public sealed class OdbcConnection : System.Data.Common.DbConnection, ICloneable
public sealed class OdbcConnection : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbConnection
type OdbcConnection = class
inherit DbConnection
interface ICloneable
type OdbcConnection = class
inherit Component
interface ICloneable
interface IDbConnection
interface IDisposable
Public NotInheritable Class OdbcConnection
Inherits DbConnection
Implements ICloneable
Public NotInheritable Class OdbcConnection
Inherits Component
Implements ICloneable, IDbConnection, IDisposable
- Devralma
- Devralma
- Uygulamalar
Örnekler
Aşağıdaki örnek bir OdbcCommand ve OdbcConnectionoluşturur. OdbcConnection özelliği olarak Connection açılır ve ayarlanır. Örnek daha sonra öğesini çağırır ExecuteNonQueryve bağlantıyı kapatır. Bunu başarmak için, ExecuteNonQuery bir bağlantı dizesi ve SQL INSERT deyimi olan bir sorgu dizesi geçirilir.
static private void InsertRow(string connectionString)
{
string queryString =
"INSERT INTO Customers (CustomerID, CompanyName) Values('NWIND', 'Northwind Traders')";
OdbcCommand command = new OdbcCommand(queryString);
using (OdbcConnection connection = new OdbcConnection(connectionString))
{
command.Connection = connection;
connection.Open();
command.ExecuteNonQuery();
// The connection is automatically closed at
// the end of the Using block.
}
}
Private Sub InsertRow(ByVal connectionString As String)
Dim queryString As String = _
"INSERT INTO Customers (CustomerID, CompanyName) Values('NWIND', 'Northwind Traders')"
Dim command As New OdbcCommand(queryString)
Using connection As New OdbcConnection(connectionString)
command.Connection = connection
connection.Open()
command.ExecuteNonQuery()
' The connection is automatically closed at
' the end of the Using block.
End Using
End Sub
Açıklamalar
Nesne, OdbcConnection bağlantı dizesi veya ODBC veri kaynağı adı (DSN) kullanılarak oluşturulan veri kaynağına yönelik benzersiz bir bağlantıyı temsil eder. İstemci/sunucu veritabanı sistemi ile sunucuya yapılan ağ bağlantısına eşdeğerdir. Yerel ODBC sürücüsü tarafından desteklenen işlevlere bağlı olarak, bir OdbcConnection nesnenin bazı yöntemleri veya özellikleri kullanılamayabilir.
OdbcConnection nesnesi ODBC ortamı ve bağlantı tanıtıcıları gibi yerel kaynakları kullanır. Nesne kapsam dışına çıkmadan önce veya bağlantıyı bir Using
deyimine OdbcConnection yerleştirerek veya çağırarak Close açık nesneleri her zaman açıkça kapatmalısınızOdbcConnection. Bunun yapılmaması, bu yerel kaynakların çöp toplamaya serbest bırakılmamasıdır. Onları hemen kurtaramayabilir. Bu da sonunda temel alınan sürücünün kaynaklarının yetersiz olmasına veya üst sınıra ulaşmasına neden olabilir. Bu, aralıklı hatalarla sonuçlandı. Örneğin, birçok bağlantı çöp toplayıcı tarafından silinmeyi beklerken ilgili hatalarla karşılaşabilirsiniz Maximum Connections
. Bağlantıları açıkça kapatmak, yerel kaynakların daha verimli bir şekilde kullanılmasına olanak tanır, ölçeklenebilirliği artırır ve genel uygulama performansını geliştirir.
Not
Yüksek performanslı uygulamaları dağıtmak için sık sık bağlantı havuzu kullanmanız gerekir. Ancak ODBC için .NET Framework Veri Sağlayıcısı'nı kullandığınızda, sağlayıcı bunu otomatik olarak yönettiğinden bağlantı havuzunu etkinleştirmeniz gerekmez.
Sınıfın Execute
yöntemlerinden OdbcCommand biri önemli OdbcException (örneğin, SQL Server önem derecesi 20 veya üzeri) neden olursa, OdbcConnection kapatılabilir. Ancak kullanıcı bağlantıyı yeniden açabilir ve devam edebilir.
Nesnesinin OdbcConnection 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. OdbcConnection nesnesini kullanarak OdbcPermission güvenlik talepleri oluşturur. Kullanıcılar, nesnesini kullanarak OdbcPermissionAttribute kodlarının yeterli izinlere sahip olduğunu doğrulayabilir. Kullanıcılar ve yöneticiler bilgisayar, kullanıcı ve kuruluş düzeylerinde güvenlik ilkesini değiştirmek için Kod Erişimi Güvenlik İlkesi Aracı'nı (Caspol.exe) da kullanabilir. Daha fazla bilgi için bkz. Kod Erişimi Güvenliği ve ADO.NET.
Veri kaynağından gelen uyarı ve bilgilendirme iletilerini işleme hakkında daha fazla bilgi için bkz. Bağlantı Olayları.
Oluşturucular
OdbcConnection() |
OdbcConnection sınıfının yeni bir örneğini başlatır. |
OdbcConnection(String) |
Belirtilen bağlantı dizesi ile sınıfının yeni bir örneğini OdbcConnection başlatır. |
Özellikler
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) |
ConnectionString |
Veri kaynağı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 veya ayarlar. |
Container |
öğesini IContainer içeren öğesini Componentalır. (Devralındığı yer: Component) |
Database |
Bağlantı açıldıktan sonra kullanılacak geçerli veritabanının veya veritabanının adını alır. |
DataSource |
Veri kaynağının sunucu adını veya dosya 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) |
Driver |
Geçerli bağlantı için belirtilen ODBC sürücüsünün adını alır. |
Events |
Bu Componentöğesine eklenen olay işleyicilerinin listesini alır. (Devralındığı yer: Component) |
ServerVersion |
İstemcinin bağlı olduğu sunucunun sürümünü içeren bir dize alır. |
Site |
öğesini alır veya ayarlar ISiteComponent. (Devralındığı yer: Component) |
State |
Bağlantının geçerli durumunu 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() |
Veri kaynağında bir işlem başlatır. |
BeginTransaction(IsolationLevel) |
Belirtilen IsolationLevel değerle veri kaynağında bir işlem 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 OdbcConnectionbir ile ilişkili 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) |
Close() |
Veri kaynağına bağlantıyı kapatır. |
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 OdbcConnectionilişkilendirilmiş bir OdbcCommand nesnesi 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() |
Geçersiz.
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 OdbcConnectionöğesinin veri kaynağı için şema bilgilerini döndürür. |
GetSchema(String) |
Şema adı için belirtilen adı kullanarak bunun OdbcConnection 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 OdbcConnection veri kaynağı için şema bilgilerini döndürür. |
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.
|
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.
|
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.
|
GetService(Type) |
veya tarafından ComponentContainersağ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() |
Geçersiz.
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 veri kaynağına bağlantı 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) |
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 |
ReleaseObjectPool() |
ODBC Sürücü Yöneticisi ortam tanıtıcısının, temel alınan son bağlantı serbest bırakıldığında serbest bırakılabildiğini gösterir. |
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 |
ODBC sürücüsü bir uyarı veya bilgilendirme iletisi gönderdiğinde 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() |
Bu üyenin açıklaması için bkz Clone(). . |
IDbConnection.BeginTransaction() |
Bu API, ürün altyapısını destekler ve doğrudan kodunuzdan kullanıma yönelik değildir. Veritabanı işlemini başlatır. |
IDbConnection.BeginTransaction() |
Veritabanı işlemini başlatır. (Devralındığı yer: DbConnection) |
IDbConnection.BeginTransaction(IsolationLevel) |
Bu API, ürün altyapısını destekler ve doğrudan kodunuzdan kullanıma yönelik değildir. Belirtilen yalıtım düzeyine sahip 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() |
Bu API, ürün altyapısını destekler ve doğrudan kodunuzdan kullanıma yönelik değildir. Bağlantıyla ilişkili bir komut 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) |
Uzantı Metotları
ConfigureAwait(IAsyncDisposable, Boolean) |
Zaman uyumsuz bir atılabilir öğeden döndürülen görevlerde awaits işleminin nasıl gerçekleştirildiğini yapılandırılır. |
Şunlara uygulanır
Ayrıca bkz.
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin