OdbcConnection Třída

Definice

Obor názvů:

System.Data.Odbc

Sestavení:

System.Data.Odbc.dll

Balíček:

System.Data.Odbc v11.0.0-preview.2.26159.112

Zdroj:

OdbcConnection.cs

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

public ref class OdbcConnection sealed : System::Data::Common::DbConnection, ICloneable

public sealed class OdbcConnection : System.Data.Common.DbConnection, ICloneable

type OdbcConnection = class
    inherit DbConnection
    interface ICloneable

Public NotInheritable Class OdbcConnection
Inherits DbConnection
Implements ICloneable

Dědičnost

Object

DbConnection

OdbcConnection

Implementuje

ICloneable

Příklady

Následující příklad vytvoří a OdbcCommandOdbcConnection. Otevře se OdbcConnection a nastaví jako Connection vlastnost. Příklad pak zavolá ExecuteNonQuerya zavře připojení. K tomu ExecuteNonQuery se předá připojovací řetězec a řetězec dotazu, který je příkazem SQL INSERT.

static private void InsertRow(string connectionString)
{
    string queryString =
        "INSERT INTO Customers (CustomerID, CompanyName) Values('NWIND', 'Northwind Traders')";
    OdbcCommand command = new OdbcCommand(queryString);

    using (OdbcConnection connection = new OdbcConnection(connectionString))
    {
        command.Connection = connection;
        connection.Open();
        command.ExecuteNonQuery();

        // The connection is automatically closed at
        // the end of the Using block.
    }
}

Private Sub InsertRow(ByVal connectionString As String)

    Dim queryString As String = _
        "INSERT INTO Customers (CustomerID, CompanyName) Values('NWIND', 'Northwind Traders')"
    Dim command As New OdbcCommand(queryString)

    Using connection As New OdbcConnection(connectionString)
        command.Connection = connection
        connection.Open()
        command.ExecuteNonQuery()

        ' The connection is automatically closed at
        ' the end of the Using block.
    End Using
End Sub

Poznámky

Objekt OdbcConnection představuje jedinečné připojení ke zdroji dat vytvořenému pomocí připojovacího řetězce nebo názvu zdroje dat ODBC (DSN). V případě databázového systému klienta nebo serveru je ekvivalentem síťového připojení k serveru. V závislosti na funkcích podporovaných nativním ovladačem ODBC nemusí být některé metody nebo vlastnosti objektu OdbcConnection k dispozici.

Objekt OdbcConnection používá nativní prostředky, jako je prostředí ODBC a obslužné rutiny připojení. Před ukončením oboru objektu nebo umístěním připojení do příkazu byste měli vždy explicitně zavřít všechny otevřené OdbcConnection objekty voláním Close nebo odstraněnímOdbcConnection objektu Using . Tím nezanecháte uvolnění těchto nativních prostředků na uvolňování paměti. Nemusí je okamžitě uvolnit. To může nakonec způsobit, že podkladový ovladač dojde k prostředkům nebo dosáhne maximálního limitu. Výsledkem byla přerušovaná selhání. Můžete například zaznamenat Maximum Connections chyby -related, zatímco mnoho připojení čeká na odstranění uvolňováním paměti. Explicitní zavření připojení umožňuje efektivnější využití nativních prostředků, zvýšení škálovatelnosti a zlepšení celkového výkonu aplikace.

Poznámka

Pokud chcete nasadit vysoce výkonné aplikace, musíte často používat sdružování připojení. Pokud však použijete zprostředkovatele dat rozhraní .NET Framework pro rozhraní ODBC, není nutné povolit sdružování připojení, protože zprostředkovatel to spravuje automaticky.

Pokud jedna z Execute metod OdbcCommand třídy způsobí závažnou OdbcException chybu (například úroveň závažnosti SQL Serveru 20 nebo vyšší), OdbcConnection může se zavřít. Uživatel ale může znovu otevřít připojení a pokračovat.

Aplikace, která vytvoří instanci objektu OdbcConnection , může vyžadovat, aby všichni přímá a nepřímí volající měli dostatečná oprávnění k kódu nastavením deklarativních nebo imperativních požadavků na zabezpečení. OdbcConnection vytváří požadavky na zabezpečení pomocí objektu OdbcPermission . Uživatelé můžou pomocí objektu OdbcPermissionAttribute ověřit, že kód má dostatečná oprávnění. Uživatelé a správci můžou také použít nástroj zásad zabezpečení přístupu kódu (Caspol.exe) k úpravě zásad 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 ze zdroje dat naleznete v tématu Události připojení.

Konstruktory

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

Vlastnosti

Name	Description
ConnectionString	Získá nebo nastaví řetězec použitý k otevření zdroje dat.
ConnectionTimeout	Získá nebo nastaví 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á se má použít po otevření připojení.
DataSource	Získá název serveru nebo název souboru zdroje dat.
Driver	Získá název ovladače ODBC zadaného pro aktuální připojení.
ServerVersion	Získá řetězec obsahující verzi serveru, ke kterému je klient připojen.
State	Získá aktuální stav připojení.

Metody

Name	Description
BeginTransaction()	Spustí transakci ve zdroji dat.
BeginTransaction(IsolationLevel)	Spustí transakci ve zdroji dat se zadanou IsolationLevel hodnotou.
ChangeDatabase(String)	Změní aktuální databázi přidruženou k otevřené OdbcConnectiondatabázi .
Close()	Zavře připojení ke zdroji dat.
CreateCommand()	Vytvoří a vrátí OdbcCommand objekt přidružený k objektu OdbcConnection.
GetSchema()	Vrátí informace o schématu pro zdroj dat tohoto OdbcConnectionobjektu .
GetSchema(String, String[])	Vrátí informace o schématu pro zdroj dat tohoto OdbcConnection pomocí zadaného řetězce pro název schématu a zadané pole řetězců pro hodnoty omezení.
GetSchema(String)	Vrátí informace o schématu pro zdroj dat tohoto OdbcConnection pomocí zadaného názvu pro název schématu.
Open()	Otevře připojení ke zdroji dat s nastavením vlastnosti určeného objektem ConnectionString.
ReleaseObjectPool()	Označuje, že obslužný rutina prostředí Správce ovladačů ODBC může být vydána při vydání posledního základního připojení.

Událost

Name	Description
InfoMessage	Nastane, když ovladač ODBC odešle upozornění nebo informační zprávu.

Explicitní implementace rozhraní

Name	Description
ICloneable.Clone()	Popis tohoto člena naleznete v tématu Clone().

Viz také

• Připojení ke zdrojům dat