OdbcConnection Osztály

Definíció

Névtér:

System.Data.Odbc

Szerelvény:

System.Data.Odbc.dll

Csomag:

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

Forrás:

OdbcConnection.cs

Egy adatforráshoz való nyílt kapcsolatot jelöl.

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

Öröklődés

Object

DbConnection

OdbcConnection

Megvalósítás

ICloneable

Példák

Az alábbi példa létrehoz egy OdbcCommand és egy OdbcConnection. Ez OdbcConnection meg van nyitva, és tulajdonságként Connection van beállítva. A példa ezután meghívja ExecuteNonQuery, majd bezárja a kapcsolatot. Ehhez a ExecuteNonQuery egy kapcsolati karakterlánc és egy SQL INSERT utasítást tartalmazó lekérdezési sztringet ad át.

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

Megjegyzések

A OdbcConnection objektum egy kapcsolati karakterlánc vagy ODBC-adatforrásnévvel (DSN) létrehozott adatforráshoz való egyedi kapcsolatot jelöl. Egy ügyfél-/kiszolgáló-adatbázisrendszer esetén ez egyenértékű a kiszolgálóval létesített hálózati kapcsolattal. A natív ODBC-illesztőprogram által támogatott funkcióktól függően előfordulhat, hogy egy OdbcConnection objektum bizonyos metódusai vagy tulajdonságai nem érhetők el.

Az OdbcConnection objektum natív erőforrásokat, például ODBC-környezetet és kapcsolatkezelőket használ. A nyitott OdbcConnection objektumokat mindig explicit módon zárja be úgy, hogy meghívja Close vagy megsemmisíti , mielőtt az objektum kiesik a OdbcConnection hatókörből, vagy egy utasításba Using helyezi a kapcsolatot. Ha ezt nem teszi meg, az a natív erőforrások szemétgyűjtésre való felszabadítását teszi lehetővé. Lehet, hogy nem szabadít fel azonnal. Ez pedig azt eredményezheti, hogy a mögöttes illesztőprogram elfogy az erőforrásokból, vagy eléri a maximális korlátot. Ez időszakos hibákat eredményezett. Előfordulhat például, hogy -related hibákat tapasztal Maximum Connections , miközben sok kapcsolat arra vár, hogy a szemétgyűjtő törölje őket. A kapcsolatok explicit lezárása lehetővé teszi a natív erőforrások hatékonyabb használatát, fokozza a méretezhetőséget és javítja az alkalmazások általános teljesítményét.

Note

A nagy teljesítményű alkalmazások üzembe helyezéséhez gyakran használnia kell a kapcsolatkészletezést. Az ODBC-hez készült .NET-keretrendszer Data Provider használatakor azonban nem kell engedélyeznie a kapcsolatkészletezést, mert a szolgáltató ezt automatikusan kezeli.

Ha a Execute osztály egyik OdbcCommand metódusa végzetes OdbcException okoz (például 20 vagy nagyobb SQL Server súlyossági szint), a OdbcConnection bezárulhat. A felhasználó azonban újra megnyithatja a kapcsolatot, és folytathatja azt.

Az objektum egy példányát létrehozó alkalmazás megkövetelheti, hogy a OdbcConnection deklaratív vagy imperatív biztonsági követelmények megadásával minden közvetlen és közvetett hívó rendelkezzen megfelelő engedéllyel a kódhoz. OdbcConnection biztonsági igényeket hoz létre az OdbcPermission objektum használatával. A felhasználók az objektum használatával OdbcPermissionAttribute ellenőrizhetik, hogy a kódjuk rendelkezik-e megfelelő engedélyekkel. A felhasználók és a rendszergazdák a Code Access biztonsági házirend eszközével (Caspol.exe) is módosíthatják a biztonsági szabályzatot a számítógép, a felhasználó és a vállalati szinten. További információ: Code Access Security és ADO.NET.

Az adatforrásból érkező figyelmeztető és tájékoztató üzenetek kezeléséről további információt a Kapcsolati események című témakörben talál.

Konstruktorok

Name	Description
OdbcConnection()	Inicializálja a OdbcConnection osztály új példányát.
OdbcConnection(String)	Inicializálja a OdbcConnection osztály új példányát a megadott kapcsolati karakterlánc.

Tulajdonságok

Name	Description
ConnectionString	Lekéri vagy beállítja az adatforrás megnyitásához használt sztringet.
ConnectionTimeout	Lekéri vagy beállítja a várakozási időt (másodpercben), miközben megpróbál kapcsolatot létesíteni, mielőtt megszakítja a kísérletet, és hibát okozna.
Database	Lekéri az aktuális adatbázis vagy a kapcsolat megnyitása után használni kívánt adatbázis nevét.
DataSource	Lekéri az adatforrás kiszolgálónevét vagy fájlnevét.
Driver	Lekéri az aktuális kapcsolathoz megadott ODBC-illesztő nevét.
ServerVersion	Lekéri a kiszolgáló azon verzióját tartalmazó sztringet, amelyhez az ügyfél csatlakozik.
State	Lekéri a kapcsolat aktuális állapotát.

Metódusok

Name	Description
BeginTransaction()	Tranzakció indítása az adatforrásban.
BeginTransaction(IsolationLevel)	Tranzakció indítása az adatforrásban a megadott IsolationLevel értékkel.
ChangeDatabase(String)	Módosítja a megnyitott OdbcConnectionadatbázishoz társított aktuális adatbázist.
Close()	Bezárja az adatforráshoz való kapcsolatot.
CreateCommand()	Létrehoz és visszaad egy OdbcCommand objektumot, amely a OdbcConnection.
GetSchema()	Ennek az adatforrásnak OdbcConnectiona sémaadatait adja vissza.
GetSchema(String, String[])	Az adatforrás OdbcConnection sémaadatait adja vissza a sémanévhez megadott sztring és a korlátozási értékek megadott sztringtömbjének használatával.
GetSchema(String)	A sémanév megadott nevével adja vissza az adatforrás OdbcConnection sémaadatait.
Open()	Kapcsolatot nyit meg egy adatforráshoz a megadott tulajdonságbeállításokkal ConnectionString.
ReleaseObjectPool()	Azt jelzi, hogy az ODBC Driver Manager környezeti leírója az utolsó mögöttes kapcsolat felszabadításakor szabadulhat fel.

esemény

Name	Description
InfoMessage	Akkor fordul elő, ha az ODBC-illesztő figyelmeztetést vagy tájékoztató üzenetet küld.

Explicit interfész-implementációk

Name	Description
ICloneable.Clone()	Ennek a tagnak a leírását lásd Clone(): .

Lásd még

• Csatlakozás adatforrásokhoz