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 obiekt OleDbCommand i OleDbConnection. Element OleDbConnection jest otwarty i ustawiany jako Connection dla .OleDbCommand Następnie przykład wywołuje ExecuteNonQuery i zamyka połączenie. W tym ExecuteNonQuery celu jest przekazywany parametry połączenia i ciąg zapytania, który jest 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 to odpowiednik połączenia sieciowego z serwerem. W zależności od funkcji obsługiwanych przez natywnego dostawcę OLE DB niektóre metody lub właściwości OleDbConnection obiektu mogą być niedostępne.
Podczas tworzenia wystąpienia OleDbConnectionprogramu wszystkie właściwości są ustawiane 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 element OleDbConnection wykracza poza zakres, nie jest zamknięty. W związku z tym należy jawnie zamknąć połączenie przez wywołanie Close lub dispose albo za pomocą OleDbConnection obiektu w instrukcji Using
.
Uwaga
Aby wdrożyć aplikacje o wysokiej wydajności, należy użyć buforowania 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 buforowania połączeń z dostawcą danych .NET Framework dla OLE DB, zobacz OLE DB, ODBC i Oracle Connection Pooling (Buforowanie połączeń OLE DB, ODBC i Oracle).
Jeśli krytyczny OleDbException (na przykład poziom ważności SQL Server 20 lub większy) jest generowany przez metodę wykonującą OleDbCommandelement , OleDbConnection może zostać zamknięty. Użytkownik może jednak 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 wystarczających uprawnień do kodu przez ustawienie deklaratywnych lub imperatywnych wymagań dotyczących zabezpieczeń. OleDbConnection sprawia, że wymagania dotyczące zabezpieczeń korzystają z OleDbPermission obiektu . Użytkownicy mogą sprawdzić, czy ich kod ma wystarczające uprawnienia przy użyciu OleDbPermissionAttribute obiektu . Użytkownicy i administratorzy mogą również użyć Caspol.exe (narzędzie 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 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 parametry połączenia dla dostawcy OLE DB.
Konstruktory
OleDbConnection() |
Inicjuje nowe wystąpienie klasy OleDbConnection. |
OleDbConnection(String) |
Inicjuje OleDbConnection nowe wystąpienie klasy z określonym parametry połączenia. |
Właściwości
CanCreateBatch |
Pobiera wartość wskazującą, czy to DbConnection wystąpienie 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 element IContainer zawierający element 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 element DbProviderFactory dla tego DbConnectionpliku . (Odziedziczone po DbConnection) |
DesignMode |
Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania. (Odziedziczone po Component) |
Events |
Pobiera listę programów obsługi zdarzeń dołączonych do tego Componentelementu . (Odziedziczone po Component) |
Provider |
Pobiera nazwę dostawcy OLE DB określonego w klauzuli "Provider=" parametry połączenia. |
ServerVersion |
Pobiera ciąg zawierający wersję serwera, z którym jest połączony klient. |
Site |
Pobiera lub ustawia wartość ISite .Component (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ą 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 otwartej OleDbConnectionbazy danych . |
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 przesłonięciu w klasie pochodnej zwraca nowe wystąpienie klasy dostawcy, która implementuje klasę DbBatch . (Odziedziczone po DbConnection) |
CreateDbCommand() |
Po zastąpieniu w klasie pochodnej program tworzy i zwraca DbCommand obiekt 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 zdefiniowane przez aplikację zadania skojarzone ze zwalnianiem lub resetowaniem zasobów niezarządzanych. (Odziedziczone po DbConnection) |
Dispose() |
Zwalnia wszelkie zasoby używane przez element Component. (Odziedziczone po Component) |
Dispose(Boolean) |
Zwalnia zasoby niezarządzane używane przez element DbConnection i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po DbConnection) |
Dispose(Boolean) |
Zwalnia zasoby niezarządzane używane przez element Component i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po Component) |
DisposeAsync() |
Asynchronicznie modyfikuje 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 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) |
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 i po jego 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 dla 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 |
GetSchemaAsync(String, CancellationToken) |
Jest to asynchroniczna wersja programu GetSchema(String).
Dostawcy powinni zastąpić odpowiednią implementacją.
Opcjonalnie |
GetSchemaAsync(String, String[], CancellationToken) |
Jest to asynchroniczna wersja programu GetSchema(String, String[]).
Dostawcy powinni zastąpić odpowiednią implementacją.
Opcjonalnie |
GetService(Type) |
Zwraca obiekt, który reprezentuje usługę dostarczaną przez Component obiekt lub przez element Container. (Odziedziczone po Component) |
GetType() |
Type Pobiera wartość 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 Objectelementu . (Odziedziczone po Object) |
MemberwiseClone(Boolean) |
Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject) |
OnStateChange(StateChangeEventArgs) |
StateChange Zgłasza zdarzenie. (Odziedziczone po DbConnection) |
Open() |
Otwiera połączenie bazy danych z ustawieniami właściwości określonymi przez parametr ConnectionString. |
OpenAsync() |
Wersja asynchroniczna programu Open(), która otwiera połączenie bazy danych z ustawieniami określonymi przez .ConnectionString 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 uhonorować. 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 odwołanieToken. 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 |
ReleaseObjectPool() |
Wskazuje, że pula obiektów może zostać zwolniona po wydaniu OleDbConnection ostatniego podstawowego połączenia. |
ResetState() |
State Aktualizacje właściwość OleDbConnection obiektu. |
ToString() |
Zwraca wartość String zawierającą nazwę Componentobiektu , 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 Dispose() metody . (Odziedziczone po Component) |
InfoMessage |
Występuje, gdy dostawca wysyła ostrzeżenie lub komunikat informacyjny. |
StateChange |
Występuje, gdy zmienia się stan połączenia. |
StateChange |
Występuje, gdy zmienia się stan połączenia. (Odziedziczone po DbConnection) |
Jawne implementacje interfejsu
ICloneable.Clone() |
Aby uzyskać opis tego członka, 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 o określonym poziomie izolacji. |
IDbConnection.BeginTransaction(IsolationLevel) |
Rozpoczyna transakcję bazy danych o określonym poziomie 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 DbCommand obiekt skojarzony z bieżącym połączeniem. (Odziedziczone po DbConnection) |
Metody rozszerzania
ConfigureAwait(IAsyncDisposable, Boolean) |
Konfiguruje sposób oczekiwania na zadania zwracane z jednorazowego użytku asynchronicznego. |
Dotyczy
Zobacz też
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla