OleDbConnection Klasa

Definicja

Przestrzeń nazw:

System.Data.OleDb

Zestaw:

System.Data.OleDb.dll

Pakiet:

System.Data.OleDb v8.0.0

Ź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

DbConnection

OleDbConnection

Implementuje

IDbConnection ICloneable IDisposable

Przykłady

Poniższy przykład tworzy element OleDbCommand i .OleDbConnection Element OleDbConnection jest otwierany i ustawiany jako Connection dla parametru OleDbCommand. Następnie przykład wywołuje ExecuteNonQuery i zamyka połączenie. Aby to osiągnąć, ExecuteNonQuery jest przekazywany parametr 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 systemie 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 OleDbConnection obiektu mogą nie być dostępne.

Podczas tworzenia wystąpienia OleDbConnectionprogramu wszystkie właściwości są ustawione na ich wartości początkowe. Aby uzyskać listę tych wartości, zobacz OleDbConnection konstruktor.

W jednym OleDbConnectionobiekcie można otworzyć więcej niż jeden element DataReader. 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 zakres OleDbConnection wykracza poza zakres, nie jest zamknięty. W związku z tym należy jawnie zamknąć połączenie przez wywołanie Close lub usuwanie albo za pomocą OleDbConnection obiektu w instrukcji Using .

Uwaga

Aby wdrożyć aplikacje o wysokiej wydajności, należy użyć puli połączeń. Jeśli używasz dostawcy danych .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 puli połączeń z dostawcą danych .NET Framework dla OLE DB, zobacz OLE DB, ODBC i Oracle Connection Pooling.

Jeśli wartość fatalna OleDbException (na przykład poziom ważności SQL Server 20 lub większy) jest generowana przez metodę wykonującą metodę OleDbCommand, OleDbConnection może zostać zamknięta. Jednak użytkownik może ponownie otworzyć połączenie i kontynuować.

Aplikacja, która tworzy wystąpienie OleDbConnection obiektu, może wymagać od wszystkich wywołań bezpośrednich i pośrednich, aby mieć wystarczające uprawnienia do kodu, ustawiając deklaratywne lub imperatywne wymagania dotyczące zabezpieczeń. OleDbConnection sprawia, że wymagania dotyczące zabezpieczeń korzystają z OleDbPermission obiektu. Użytkownicy mogą sprawdzić, czy kod ma wystarczające uprawnienia przy użyciu OleDbPermissionAttribute obiektu. Użytkownicy i administratorzy mogą również używać Caspol.exe (narzędzia zasad zabezpieczeń dostępu kodu) do modyfikowania zasad zabezpieczeń na poziomie komputera, użytkownika i przedsiębiorstwa. Aby uzyskać więcej informacji, zobacz Zabezpieczenia dostępu do kodu i ADO.NET.

Aby uzyskać więcej informacji na temat obsługi komunikatów ostrzegawczych i informacyjnych z serwera danych, zobacz Zdarzenia połączenia.

Uwaga

Obiekt OleDbConnection nie obsługuje ustawiania 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 OleDbConnection nowe wystąpienie klasy z określonymi parametrami połączenia.

Właściwości

CanCreateBatch	Pobiera wartość wskazującą, czy to DbConnection wystąpienie obsługuje klasę DbBatch . (Odziedziczone po DbConnection)
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.
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 element DbProviderFactory dla tego pliku DbConnection. (Odziedziczone po DbConnection)
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.
State	Pobiera bieżący stan połączenia.

Metody

BeginDbTransaction(IsolationLevel)	Po zastąpieniu klasy 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ą IsolationLevel wartością.
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 OleDbConnectionpliku .
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 OleDbCommand obiekt skojarzony z obiektem 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 klasy pochodnej tworzy i zwraca DbCommand obiekt skojarzony z bieżącym połączeniem. (Odziedziczone po DbConnection)
Dispose()	Wykonuje zdefiniowane przez aplikację zadania skojarzone ze zwalnianiem lub resetowaniem zasobów niezarządzanych. (Odziedziczone po DbConnection)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element DbConnection i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po DbConnection)
DisposeAsync()	Asynchronicznie dysponuje obiekt połączenia. (Odziedziczone po DbConnection)
EnlistTransaction(Transaction)	Enlists w określonej transakcji jako transakcji rozproszonej.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetOleDbSchemaTable(Guid, Object[])	Zwraca informacje o schemacie ze źródła danych wskazanego przez identyfikator GUID, a po wprowadzeniu określonych ograniczeń.
GetSchema()	Zwraca informacje o schemacie dla źródła danych tego OleDbConnectionelementu .
GetSchema(String)	Zwraca informacje o schemacie dla źródła OleDbConnection danych przy użyciu określonego ciągu nazwy schematu.
GetSchema(String, String[])	Zwraca informacje o schemacie dla źródła OleDbConnection danych 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 programu GetSchema(). Dostawcy powinni zastąpić odpowiednią implementacją. Opcjonalnie cancellationToken można je honorować. Domyślna implementacja wywołuje wywołanie synchroniczne GetSchema() i zwraca ukończone zadanie. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazano już anulowany cancellationTokenelement . Wyjątki zgłoszone przez GetSchema() program będą przekazywane za pośrednictwem zwróconej właściwości Wyjątki zadania. (Odziedziczone po DbConnection)
GetSchemaAsync(String, CancellationToken)	Jest to asynchroniczna wersja programu GetSchema(String). Dostawcy powinni zastąpić odpowiednią implementacją. Opcjonalnie cancellationToken można je honorować. Domyślna implementacja wywołuje wywołanie synchroniczne GetSchema(String) i zwraca ukończone zadanie. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazano już anulowany cancellationTokenelement . Wyjątki zgłoszone przez GetSchema(String) program będą przekazywane za pośrednictwem zwróconej właściwości Wyjątki zadania. (Odziedziczone po DbConnection)
GetSchemaAsync(String, String[], CancellationToken)	Jest to asynchroniczna wersja programu GetSchema(String, String[]). Dostawcy powinni zastąpić odpowiednią implementacją. Opcjonalnie cancellationToken można je honorować. Domyślna implementacja wywołuje wywołanie synchroniczne GetSchema(String, String[]) i zwraca ukończone zadanie. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazano już anulowany cancellationTokenelement . Wyjątki zgłoszone przez GetSchema(String, String[]) program będą przekazywane za pośrednictwem zwróconej właściwości Wyjątki zadania. (Odziedziczone po DbConnection)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnStateChange(StateChangeEventArgs)	StateChange Zgłasza zdarzenie. (Odziedziczone po DbConnection)
Open()	Otwiera połączenie bazy danych z ustawieniami właściwości określonymi przez ConnectionStringelement .
OpenAsync()	Asynchroniczna wersja programu Open(), która otwiera połączenie bazy danych z ustawieniami określonymi przez ConnectionStringelement . Ta metoda wywołuje metodę OpenAsync(CancellationToken) wirtualną z elementem CancellationToken.None. (Odziedziczone po DbConnection)
OpenAsync(CancellationToken)	Jest to asynchroniczna wersja programu Open(). Dostawcy powinni zastąpić odpowiednią implementacją. Token anulowania można opcjonalnie honorować. Domyślna implementacja wywołuje wywołanie synchroniczne 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ątku zadania. Nie należy wywoływać innych metod i właściwości DbConnection obiektu, dopóki zwrócone zadanie nie zostanie ukończone. (Odziedziczone po DbConnection)
ReleaseObjectPool()	Wskazuje, że pulę OleDbConnection obiektów można zwolnić po wydaniu ostatniego połączenia bazowego.
ResetState()	State Aktualizacje właściwość OleDbConnection obiektu.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zdarzenia

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().

Zobacz też

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