OleDbConnection Třída

Definice

Obor názvů:

System.Data.OleDb

Sestavení:

System.Data.OleDb.dll

Balíček:

System.Data.OleDb v8.0.0

Zdroj:

OleDbConnection.cs

Představuje otevřené připojení ke zdroji dat.

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

Dědičnost

Object

DbConnection

OleDbConnection

Implementuje

IDbConnection ICloneable IDisposable

Příklady

Následující příklad vytvoří a OleDbCommandOleDbConnection. Otevře OleDbConnection se a nastaví se jako Connection pro OleDbCommand. Příklad pak zavolá ExecuteNonQuery a ukončí připojení. Za tímto účelem ExecuteNonQuery se předá připojovací řetězec a řetězec dotazu, který je příkazem 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

Poznámky

Objekt OleDbConnection představuje jedinečné připojení ke zdroji dat. U databázového systému klient/server se jedná o ekvivalent síťového připojení k serveru. V závislosti na funkcích podporovaných nativním zprostředkovatelem OLE DB nemusí být některé metody nebo vlastnosti objektu OleDbConnection k dispozici.

Při vytváření instance objektu OleDbConnectionjsou všechny vlastnosti nastaveny na své počáteční hodnoty. Seznam těchto hodnot naleznete v konstruktoru OleDbConnection .

Na jednom OleDbConnectionmůžete otevřít více než jednu čtečku dat. Pokud zprostředkovatel OLE DB, který používáte, nepodporuje více než jeden DataReader na jednom připojení, zprostředkovatel implicitně otevře další připojení pro každý.

Pokud přejde mimo OleDbConnection rozsah, neuzavře se. Proto je nutné explicitně ukončit připojení voláním Close nebo dispose, nebo použitím objektu OleDbConnection v rámci Using příkazu.

Poznámka

Pokud chcete nasadit vysoce výkonné aplikace, musíte použít sdružování připojení. Při použití zprostředkovatele dat rozhraní .NET Framework pro OLE DB není nutné povolit sdružování připojení, protože zprostředkovatel to spravuje automaticky. Další informace o použití sdružování připojení pomocí zprostředkovatele dat rozhraní .NET Framework pro OLE DB naleznete v tématu OLE DB, ODBC a Sdružování připojení Oracle.

Pokud je závažná OleDbException (například SQL Server úroveň závažnosti 20 nebo vyšší) vygenerována metodou, která spouští OleDbCommand, OleDbConnection může být uzavřena. Uživatel ale může znovu otevřít připojení a pokračovat.

Aplikace, která vytváří instanci objektu OleDbConnection , může vyžadovat, aby všichni přímí a nepřímí volající měli dostatečná oprávnění ke kódu nastavením deklarativních nebo imperativních požadavků na zabezpečení. OleDbConnection vytváří požadavky na zabezpečení pomocí objektu OleDbPermission . Uživatelé můžou ověřit, že jejich kód má dostatečná oprávnění, pomocí objektu OleDbPermissionAttribute . Uživatelé a správci můžou také pomocí nástrojeCaspol.exe (Code Access Security Policy Tool) upravovat zásady zabezpečení na úrovni počítače, uživatele a podniku. Další informace najdete v tématu Zabezpečení přístupu kódu a ADO.NET.

Další informace o zpracování upozornění a informačních zpráv z datového serveru najdete v tématu Události připojení.

Poznámka

Objekt OleDbConnection nepodporuje nastavení nebo načítání dynamických vlastností specifických pro zprostředkovatele OLE DB. Podporují se pouze vlastnosti, které lze předat v připojovacím řetězci pro zprostředkovatele OLE DB.

Konstruktory

OleDbConnection()	Inicializuje novou instanci OleDbConnection třídy .
OleDbConnection(String)	Inicializuje novou instanci OleDbConnection třídy se zadaným připojovacím řetězcem.

Vlastnosti

CanCreateBatch	Získá hodnotu, která označuje, zda tato DbConnection instance podporuje DbBatch třídu . (Zděděno od DbConnection)
ConnectionString	Získá nebo nastaví řetězec použitý k otevření databáze.
ConnectionTimeout	Získá dobu čekání (v sekundách) při pokusu o navázání připojení před ukončením pokusu a generování chyby.
Database	Získá název aktuální databáze nebo databáze, která má být použita po otevření připojení.
DataSource	Získá název serveru nebo název souboru zdroje dat.
DbProviderFactory	Získá pro DbProviderFactory tento DbConnectionobjekt . (Zděděno od DbConnection)
Provider	Získá název zprostředkovatele OLE DB zadaný v "Provider= " klauzule připojovacího řetězce.
ServerVersion	Získá řetězec, který obsahuje verzi serveru, ke kterému je klient připojen.
State	Získá aktuální stav připojení.

Metody

BeginDbTransaction(IsolationLevel)	Při přepsání v odvozené třídě spustí transakci databáze. (Zděděno od DbConnection)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	Asynchronně spustí transakci databáze. (Zděděno od DbConnection)
BeginTransaction()	Spustí transakci databáze s aktuální IsolationLevel hodnotou.
BeginTransaction(IsolationLevel)	Spustí databázovou transakci se zadanou úrovní izolace.
BeginTransactionAsync(CancellationToken)	Asynchronně zahájí transakci databáze. (Zděděno od DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)	Asynchronně zahájí transakci databáze. (Zděděno od DbConnection)
ChangeDatabase(String)	Změní aktuální databázi otevřeného objektu OleDbConnection.
ChangeDatabaseAsync(String, CancellationToken)	Asynchronně změní aktuální databázi pro otevřené připojení. (Zděděno od DbConnection)
Close()	Ukončí připojení ke zdroji dat.
CloseAsync()	Asynchronně ukončí připojení k databázi. (Zděděno od DbConnection)
CreateBatch()	Vrátí novou instanci třídy zprostředkovatele, která implementuje DbBatch třídu . (Zděděno od DbConnection)
CreateCommand()	Vytvoří a vrátí OleDbCommand objekt přidružený k objektu OleDbConnection.
CreateDbBatch()	Při přepsání v odvozené třídě vrátí novou instanci třídy zprostředkovatele, která implementuje DbBatch třídu . (Zděděno od DbConnection)
CreateDbCommand()	Při přepsání v odvozené třídě vytvoří a vrátí DbCommand objekt přidružený k aktuálnímu připojení. (Zděděno od DbConnection)
Dispose()	Provede aplikací definované úlohy spojené s uvolněním nebo resetováním nespravovaných prostředků. (Zděděno od DbConnection)
Dispose(Boolean)	Uvolní nespravované prostředky používané nástrojem DbConnection a volitelně uvolní spravované prostředky. (Zděděno od DbConnection)
DisposeAsync()	Asynchronně rozloží objekt připojení. (Zděděno od DbConnection)
EnlistTransaction(Transaction)	Zadává v zadané transakci jako distribuovanou transakci.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetOleDbSchemaTable(Guid, Object[])	Vrátí informace o schématu ze zdroje dat podle identifikátoru GUID a po použití zadaných omezení.
GetSchema()	Vrátí informace o schématu pro zdroj dat tohoto OleDbConnection.
GetSchema(String)	Vrátí informace o schématu pro zdroj dat tohoto OleDbConnection typu pomocí zadaného řetězce pro název schématu.
GetSchema(String, String[])	Vrátí informace o schématu pro zdroj dat tohoto OleDbConnection typu pomocí zadaného řetězce pro název schématu a zadaného pole řetězců pro hodnoty omezení.
GetSchemaAsync(CancellationToken)	Toto je asynchronní verze nástroje GetSchema(). Poskytovatelé by měli přepsat příslušnou implementací. Volitelně cancellationToken může být respektována. Výchozí implementace vyvolá synchronní GetSchema() volání a vrátí dokončenou úlohu. Výchozí implementace vrátí zrušenou úlohu, pokud byla předána již zrušená cancellationTokenúloha . Výjimky vyvolané nástrojem GetSchema() budou oznámeny prostřednictvím vrácené vlastnosti Task Exception (Výjimka úkolu). (Zděděno od DbConnection)
GetSchemaAsync(String, CancellationToken)	Toto je asynchronní verze nástroje GetSchema(String). Poskytovatelé by měli přepsat příslušnou implementací. Volitelně cancellationToken může být respektována. Výchozí implementace vyvolá synchronní GetSchema(String) volání a vrátí dokončenou úlohu. Výchozí implementace vrátí zrušenou úlohu, pokud byla předána již zrušená cancellationTokenúloha . Výjimky vyvolané nástrojem GetSchema(String) budou oznámeny prostřednictvím vrácené vlastnosti Task Exception (Výjimka úkolu). (Zděděno od DbConnection)
GetSchemaAsync(String, String[], CancellationToken)	Toto je asynchronní verze nástroje GetSchema(String, String[]). Poskytovatelé by měli přepsat příslušnou implementací. Volitelně cancellationToken může být respektována. Výchozí implementace vyvolá synchronní GetSchema(String, String[]) volání a vrátí dokončenou úlohu. Výchozí implementace vrátí zrušenou úlohu, pokud byla předána již zrušená cancellationTokenúloha . Výjimky vyvolané nástrojem GetSchema(String, String[]) budou oznámeny prostřednictvím vrácené vlastnosti Task Exception (Výjimka úkolu). (Zděděno od DbConnection)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
OnStateChange(StateChangeEventArgs)	StateChange Vyvolá událost. (Zděděno od DbConnection)
Open()	Otevře připojení k databázi s nastavením vlastnosti určeným parametrem ConnectionString.
OpenAsync()	Asynchronní verze nástroje Open(), která otevře připojení k databázi s nastavením určeným parametrem ConnectionString. Tato metoda vyvolá virtuální metodu OpenAsync(CancellationToken) pomocí CancellationToken.None. (Zděděno od DbConnection)
OpenAsync(CancellationToken)	Toto je asynchronní verze nástroje Open(). Poskytovatelé by měli přepsat příslušnou implementací. Token zrušení je možné volitelně respektovat. Výchozí implementace vyvolá synchronní Open() volání a vrátí dokončenou úlohu. Výchozí implementace vrátí zrušenou úlohu, pokud je předán již zrušený cancellationToken. Výjimky vyvolané otevřením budou oznámeny prostřednictvím vrácené vlastnosti Task Exception (Výjimka úlohy). Nevyvolávej jiné metody a vlastnosti objektu DbConnection , dokud vrácená úloha není dokončena. (Zděděno od DbConnection)
ReleaseObjectPool()	Označuje, že OleDbConnection fond objektů může být uvolněn při uvolnění posledního základního připojení.
ResetState()	State Aktualizace vlastnost objektuOleDbConnection.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Událost

InfoMessage	Vyvolá se, když poskytovatel odešle upozornění nebo informační zprávu.
StateChange	Vyvolá se při změně stavu připojení. (Zděděno od DbConnection)

Explicitní implementace rozhraní

ICloneable.Clone()

Popis tohoto člena najdete v tématu Clone().

Viz také

• Připojení ke zdrojům dat