OleDbConnection Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Reprezentuje otwarte połączenie ze źródłem danych.
public ref class OleDbConnection sealed : System::Data::Common::DbConnection, ICloneable, IDisposable
public ref class OleDbConnection sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbConnection
public ref class OleDbConnection sealed : System::Data::Common::DbConnection, ICloneable
public sealed class OleDbConnection : System.Data.Common.DbConnection, ICloneable, IDisposable
public sealed class OleDbConnection : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbConnection
public sealed class OleDbConnection : System.Data.Common.DbConnection, ICloneable
type OleDbConnection = class
inherit DbConnection
interface ICloneable
interface IDbConnection
interface IDisposable
type OleDbConnection = class
inherit Component
interface ICloneable
interface IDbConnection
interface IDisposable
type OleDbConnection = class
inherit DbConnection
interface IDbConnection
interface IDisposable
interface ICloneable
Public NotInheritable Class OleDbConnection
Inherits DbConnection
Implements ICloneable, IDisposable
Public NotInheritable Class OleDbConnection
Inherits Component
Implements ICloneable, IDbConnection, IDisposable
Public NotInheritable Class OleDbConnection
Inherits DbConnection
Implements ICloneable
- Dziedziczenie
- Dziedziczenie
- Implementuje
Przykłady
Poniższy przykład tworzy OleDbCommand i OleDbConnection. OleDbConnection jest otwarty i ustawiany jako Connection dla OleDbCommand. Następnie przykład wywołuje ExecuteNonQuery i zamyka połączenie. W tym celu ExecuteNonQuery jest przekazywana parametry połączenia i parametry zapytania, które są instrukcją SQL INSERT.
public void InsertRow(string connectionString, string insertSQL)
{
using (OleDbConnection connection = new OleDbConnection(connectionString))
{
// The insertSQL string contains a SQL statement that
// inserts a new row in the source table.
OleDbCommand command = new OleDbCommand(insertSQL);
// Set the Connection to the new OleDbConnection.
command.Connection = connection;
// Open the connection and execute the insert command.
try
{
connection.Open();
command.ExecuteNonQuery();
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
}
// The connection is automatically closed when the
// code exits the using block.
}
}
Public Sub InsertRow(ByVal connectionString As String, _
ByVal insertSQL As String)
Using connection As New OleDbConnection(connectionString)
' The insertSQL string contains a SQL statement that
' inserts a new row in the source table.
Dim command As New OleDbCommand(insertSQL)
' Set the Connection to the new OleDbConnection.
command.Connection = connection
' Open the connection and execute the insert command.
Try
connection.Open()
command.ExecuteNonQuery()
Catch ex As Exception
Console.WriteLine(ex.Message)
End Try
' The connection is automatically closed when the
' code exits the Using block.
End Using
End Sub
Uwagi
Obiekt OleDbConnection reprezentuje unikatowe połączenie ze źródłem danych. W przypadku systemu bazy danych klienta/serwera jest on odpowiednikiem połączenia sieciowego z serwerem. W zależności od funkcjonalności obsługiwanej przez natywnego dostawcę OLE DB niektóre metody lub właściwości obiektu OleDbConnection mogą być niedostępne.
Podczas tworzenia wystąpienia OleDbConnectionwszystkie właściwości są ustawiane na ich początkowe wartości. Aby uzyskać listę tych wartości, zobacz konstruktor OleDbConnection.
Możesz otworzyć więcej niż jeden element DataReader w jednym OleDbConnection. Jeśli używany dostawca OLE DB nie obsługuje więcej niż jednego elementu DataReader w jednym połączeniu, dostawca niejawnie otwiera dodatkowe połączenie dla każdego z nich.
Jeśli OleDbConnection wykracza poza zakres, nie zostanie zamknięty. W związku z tym należy jawnie zamknąć połączenie, wywołując Close lub Disposelub używając obiektu OleDbConnection w instrukcji Using
.
Nuta
Aby wdrożyć aplikacje o wysokiej wydajności, należy użyć buforowania połączeń. Jeśli używasz dostawcy danych programu .NET Framework dla ole DB, nie musisz włączać buforowania połączeń, ponieważ dostawca zarządza tym automatycznie. Aby uzyskać więcej informacji na temat używania buforowania połączeń z dostawcą danych programu .NET Framework dla ole DB, zobacz OLE DB, ODBC i Oracle Connection Pooling.
Jeśli OleDbException krytycznym (na przykład poziom ważności programu SQL Server o wartości 20 lub większej) jest generowany przez metodę wykonującą OleDbCommand, OleDbConnection może zostać zamknięta. Użytkownik może jednak ponownie otworzyć połączenie i kontynuować.
Aplikacja, która tworzy wystąpienie obiektu OleDbConnection, może wymagać od wszystkich wywołań bezpośrednich i pośrednich wystarczających uprawnień do kodu przez ustawienie żądań deklaratywnych lub imperatywnych zabezpieczeń. OleDbConnection wymaganie zabezpieczeń przy użyciu obiektu OleDbPermission. Użytkownicy mogą sprawdzić, czy ich kod ma wystarczające uprawnienia, używając obiektu OleDbPermissionAttribute. Użytkownicy i administratorzy mogą również używać Caspol.exe (narzędzia zasad zabezpieczeń dostępu kodu) do modyfikowania zasad zabezpieczeń na komputerach, użytkownikach i poziomach przedsiębiorstwa. Aby uzyskać więcej informacji, zobacz Code Access Security and ADO.NET.
Aby uzyskać więcej informacji na temat obsługi komunikatów ostrzegawczych i informacyjnych z serwera danych, zobacz Zdarzenia połączenia.
Nuta
Obiekt OleDbConnection nie obsługuje ustawienia ani pobierania właściwości dynamicznych specyficznych dla dostawcy OLE DB. Obsługiwane są tylko właściwości, które można przekazać w parametrach połączenia dla dostawcy OLE DB.
Konstruktory
OleDbConnection() |
Inicjuje nowe wystąpienie klasy OleDbConnection. |
OleDbConnection(String) |
Inicjuje nowe wystąpienie klasy OleDbConnection z określonymi parametrami połączenia. |
Właściwości
CanCreateBatch |
Pobiera wartość wskazującą, czy to wystąpienie DbConnection obsługuje klasę DbBatch. (Odziedziczone po DbConnection) |
CanRaiseEvents |
Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie. (Odziedziczone po Component) |
ConnectionString |
Pobiera lub ustawia ciąg używany do otwierania bazy danych. |
ConnectionTimeout |
Pobiera czas oczekiwania (w sekundach) podczas próby nawiązania połączenia przed zakończeniem próby i wygenerowaniem błędu. |
Container |
Pobiera IContainer, który zawiera Component. (Odziedziczone po Component) |
Database |
Pobiera nazwę bieżącej bazy danych lub bazy danych do użycia po otwarciu połączenia. |
DataSource |
Pobiera nazwę serwera lub nazwę pliku źródła danych. |
DbProviderFactory |
Pobiera DbProviderFactory dla tego DbConnection. (Odziedziczone po DbConnection) |
DesignMode |
Pobiera wartość wskazującą, czy Component jest obecnie w trybie projektowania. (Odziedziczone po Component) |
Events |
Pobiera listę programów obsługi zdarzeń dołączonych do tej Component. (Odziedziczone po Component) |
Provider |
Pobiera nazwę dostawcy OLE DB określonego w klauzuli "Provider=" parametrów połączenia. |
ServerVersion |
Pobiera ciąg zawierający wersję serwera, z którym jest połączony klient. |
Site |
Pobiera lub ustawia ISiteComponent. (Odziedziczone po Component) |
State |
Pobiera bieżący stan połączenia. |
Metody
BeginDbTransaction(IsolationLevel) |
Po zastąpieniu w klasie pochodnej uruchamia transakcję bazy danych. (Odziedziczone po DbConnection) |
BeginDbTransactionAsync(IsolationLevel, CancellationToken) |
Asynchronicznie uruchamia transakcję bazy danych. (Odziedziczone po DbConnection) |
BeginTransaction() |
Uruchamia transakcję bazy danych z bieżącą wartością IsolationLevel. |
BeginTransaction(IsolationLevel) |
Uruchamia transakcję bazy danych z określonym poziomem izolacji. |
BeginTransactionAsync(CancellationToken) |
Asynchronicznie rozpoczyna transakcję bazy danych. (Odziedziczone po DbConnection) |
BeginTransactionAsync(IsolationLevel, CancellationToken) |
Asynchronicznie rozpoczyna transakcję bazy danych. (Odziedziczone po DbConnection) |
ChangeDatabase(String) |
Zmienia bieżącą bazę danych dla otwartego OleDbConnection. |
ChangeDatabaseAsync(String, CancellationToken) |
Asynchronicznie zmienia bieżącą bazę danych dla otwartego połączenia. (Odziedziczone po DbConnection) |
Close() |
Zamyka połączenie ze źródłem danych. |
CloseAsync() |
Asynchronicznie zamyka połączenie z bazą danych. (Odziedziczone po DbConnection) |
CreateBatch() |
Zwraca nowe wystąpienie klasy dostawcy, która implementuje klasę DbBatch. (Odziedziczone po DbConnection) |
CreateCommand() |
Tworzy i zwraca obiekt OleDbCommand skojarzony z OleDbConnection. |
CreateDbBatch() |
Po zastąpieniu klasy pochodnej zwraca nowe wystąpienie klasy dostawcy, które implementuje klasę DbBatch. (Odziedziczone po DbConnection) |
CreateDbCommand() |
Po zastąpieniu w klasie pochodnej tworzy i zwraca obiekt DbCommand skojarzony z bieżącym połączeniem. (Odziedziczone po DbConnection) |
CreateObjRef(Type) |
Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject) |
Dispose() |
Wykonuje zadania zdefiniowane przez aplikację skojarzone z zwalnianiem, wydawaniem lub resetowaniem niezarządzanych zasobów. (Odziedziczone po DbConnection) |
Dispose() |
Zwalnia wszystkie zasoby używane przez Component. (Odziedziczone po Component) |
Dispose(Boolean) |
Zwalnia niezarządzane zasoby używane przez DbConnection i opcjonalnie zwalnia zarządzane zasoby. (Odziedziczone po DbConnection) |
Dispose(Boolean) |
Zwalnia niezarządzane zasoby używane przez Component i opcjonalnie zwalnia zarządzane zasoby. (Odziedziczone po Component) |
DisposeAsync() |
Asynchronicznie diposuje obiekt połączenia. (Odziedziczone po DbConnection) |
EnlistDistributedTransaction(ITransaction) |
Enlists w określonej transakcji jako transakcji rozproszonej. |
EnlistTransaction(Transaction) |
Enlists w określonej transakcji jako transakcji rozproszonej. |
Equals(Object) |
Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object) |
GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
GetLifetimeService() |
Przestarzałe.
Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject) |
GetOleDbSchemaTable(Guid, Object[]) |
Zwraca informacje o schemacie ze źródła danych wskazanego przez identyfikator GUID, a po jego wprowadzeniu określone ograniczenia. |
GetSchema() |
Zwraca informacje o schemacie dla źródła danych tego OleDbConnection. |
GetSchema(String) |
Zwraca informacje o schemacie dla źródła danych tego OleDbConnection przy użyciu określonego ciągu dla nazwy schematu. |
GetSchema(String, String[]) |
Zwraca informacje o schemacie dla źródła danych tego OleDbConnection przy użyciu określonego ciągu dla nazwy schematu i określonej tablicy ciągów dla wartości ograniczeń. |
GetSchemaAsync(CancellationToken) |
Jest to asynchroniczna wersja GetSchema().
Dostawcy powinni zastąpić odpowiednią implementacją.
|
GetSchemaAsync(String, CancellationToken) |
Jest to asynchroniczna wersja GetSchema(String).
Dostawcy powinni zastąpić odpowiednią implementacją.
|
GetSchemaAsync(String, String[], CancellationToken) |
Jest to asynchroniczna wersja GetSchema(String, String[]).
Dostawcy powinni zastąpić odpowiednią implementacją.
|
GetService(Type) |
Zwraca obiekt reprezentujący usługę dostarczaną przez Component lub Container. (Odziedziczone po Component) |
GetType() |
Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object) |
InitializeLifetimeService() |
Przestarzałe.
Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject) |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object) |
MemberwiseClone(Boolean) |
Tworzy płytkią kopię bieżącego obiektu MarshalByRefObject. (Odziedziczone po MarshalByRefObject) |
OnStateChange(StateChangeEventArgs) |
Zgłasza zdarzenie StateChange. (Odziedziczone po DbConnection) |
Open() |
Otwiera połączenie bazy danych z ustawieniami właściwości określonymi przez ConnectionString. |
OpenAsync() |
Asynchroniczna wersja Open(), która otwiera połączenie bazy danych z ustawieniami określonymi przez ConnectionString. Ta metoda wywołuje metodę wirtualną OpenAsync(CancellationToken) z elementem CancellationToken.None. (Odziedziczone po DbConnection) |
OpenAsync(CancellationToken) |
Jest to asynchroniczna wersja Open(). Dostawcy powinni zastąpić odpowiednią implementacją. Token anulowania można opcjonalnie honorować. Domyślna implementacja wywołuje synchroniczne wywołanie Open() i zwraca ukończone zadanie. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazano już anulowane anulowanieToken. Wyjątki zgłaszane przez program Open będą przekazywane za pośrednictwem zwróconej właściwości Wyjątek zadania. Nie należy wywoływać innych metod i właściwości obiektu |
ReleaseObjectPool() |
Wskazuje, że pula obiektów OleDbConnection może zostać zwolniona po wydaniu ostatniego bazowego połączenia. |
ResetState() |
Aktualizuje właściwość State obiektu OleDbConnection. |
ToString() |
Zwraca String zawierającą nazwę Component, jeśli istnieje. Ta metoda nie powinna być zastępowana. (Odziedziczone po Component) |
Zdarzenia
Disposed |
Występuje, gdy składnik jest usuwany przez wywołanie metody Dispose(). (Odziedziczone po Component) |
InfoMessage |
Występuje, gdy dostawca wysyła ostrzeżenie lub komunikat informacyjny. |
StateChange |
Występuje, gdy stan połączenia ulegnie zmianie. |
StateChange |
Występuje, gdy stan połączenia ulegnie zmianie. (Odziedziczone po DbConnection) |
Jawne implementacje interfejsu
ICloneable.Clone() |
Aby uzyskać opis tego elementu członkowskiego, zobacz Clone(). |
IDbConnection.BeginTransaction() |
Ten interfejs API obsługuje infrastrukturę produktu i nie jest przeznaczony do użycia bezpośrednio z poziomu kodu. Rozpoczyna transakcję bazy danych. |
IDbConnection.BeginTransaction() |
Rozpoczyna transakcję bazy danych. (Odziedziczone po DbConnection) |
IDbConnection.BeginTransaction(IsolationLevel) |
Ten interfejs API obsługuje infrastrukturę produktu i nie jest przeznaczony do użycia bezpośrednio z poziomu kodu. Rozpoczyna transakcję bazy danych z określonym poziomem izolacji. |
IDbConnection.BeginTransaction(IsolationLevel) |
Rozpoczyna transakcję bazy danych z określonym poziomem izolacji. (Odziedziczone po DbConnection) |
IDbConnection.CreateCommand() |
Ten interfejs API obsługuje infrastrukturę produktu i nie jest przeznaczony do użycia bezpośrednio z poziomu kodu. Tworzy i zwraca obiekt polecenia skojarzony z połączeniem. |
IDbConnection.CreateCommand() |
Tworzy i zwraca obiekt DbCommand skojarzony z bieżącym połączeniem. (Odziedziczone po DbConnection) |
Metody rozszerzania
ConfigureAwait(IAsyncDisposable, Boolean) |
Konfiguruje, w jaki sposób będą wykonywane oczekiwania na zadania zwrócone z asynchronicznego jednorazowego użytku. |