OleDbConnection Klasa

Definicja

Przestrzeń nazw:

System.Data.OleDb

Zestaw:

System.Data.OleDb.dll

Pakiet:

System.Data.OleDb v9.0.0-preview.7.24405.7

Źródło:

OleDbConnection.cs

Reprezentuje otwarte połączenie ze źródłem danych.

public ref class OleDbConnection sealed : System::Data::Common::DbConnection, ICloneable, IDisposable

public sealed class OleDbConnection : System.Data.Common.DbConnection, ICloneable, IDisposable

type OleDbConnection = class
    inherit DbConnection
    interface ICloneable
    interface IDbConnection
    interface IDisposable

Public NotInheritable Class OleDbConnection
Inherits DbConnection
Implements ICloneable, IDisposable

Dziedziczenie

Object

MarshalByRefObject

Component

DbConnection

OleDbConnection

Implementuje

IDbConnection ICloneable IDisposable

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(Boolean)	Zwalnia niezarządzane zasoby używane przez DbConnection i opcjonalnie zwalnia zarządzane zasoby. (Odziedziczone po DbConnection)
DisposeAsync()	Asynchronicznie diposuje obiekt połączenia. (Odziedziczone po DbConnection)
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ą. cancellationToken można opcjonalnie honorować. Domyślna implementacja wywołuje synchroniczne wywołanie GetSchema() i zwraca ukończone zadanie. Domyślna implementacja zwróci anulowane zadanie, jeśli zostało już anulowane cancellationToken. Wyjątki zgłaszane przez GetSchema() będą przekazywane za pośrednictwem zwróconej właściwości Wyjątek zadania. (Odziedziczone po DbConnection)
GetSchemaAsync(String, CancellationToken)	Jest to asynchroniczna wersja GetSchema(String). Dostawcy powinni zastąpić odpowiednią implementacją. cancellationToken można opcjonalnie honorować. Domyślna implementacja wywołuje synchroniczne wywołanie GetSchema(String) i zwraca ukończone zadanie. Domyślna implementacja zwróci anulowane zadanie, jeśli zostało już anulowane cancellationToken. Wyjątki zgłaszane przez GetSchema(String) będą przekazywane za pośrednictwem zwróconej właściwości Wyjątek zadania. (Odziedziczone po DbConnection)
GetSchemaAsync(String, String[], CancellationToken)	Jest to asynchroniczna wersja GetSchema(String, String[]). Dostawcy powinni zastąpić odpowiednią implementacją. cancellationToken można opcjonalnie honorować. Domyślna implementacja wywołuje synchroniczne wywołanie GetSchema(String, String[]) i zwraca ukończone zadanie. Domyślna implementacja zwróci anulowane zadanie, jeśli zostało już anulowane cancellationToken. Wyjątki zgłaszane przez GetSchema(String, String[]) będą przekazywane za pośrednictwem zwróconej właściwości Wyjątek zadania. (Odziedziczone po DbConnection)
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 DbConnection, dopóki zwrócone zadanie nie zostanie ukończone. (Odziedziczone po DbConnection)
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. (Odziedziczone po DbConnection)

Jawne implementacje interfejsu

ICloneable.Clone()	Aby uzyskać opis tego elementu członkowskiego, zobacz Clone().
IDbConnection.BeginTransaction()	Rozpoczyna transakcję bazy danych. (Odziedziczone po DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)	Rozpoczyna transakcję bazy danych z określonym poziomem izolacji. (Odziedziczone po DbConnection)
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.

Zobacz też

• nawiązywanie połączenia ze źródłami danych