OleDbConnection Osztály

Definíció

Névtér:

System.Data.OleDb

Szerelvény:

System.Data.OleDb.dll

Csomag:

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

Forrás:

OleDbConnection.cs

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

public ref class OleDbConnection sealed : System::Data::Common::DbConnection, ICloneable, IDisposable

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")]
public sealed class OleDbConnection : System.Data.Common.DbConnection, ICloneable, IDisposable

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")>]
type OleDbConnection = class
    inherit DbConnection
    interface IDbConnection
    interface IDisposable
    interface ICloneable

Public NotInheritable Class OleDbConnection
Inherits DbConnection
Implements ICloneable, IDisposable

Öröklődés

Object

DbConnection

OleDbConnection

Attribútumok

RequiresDynamicCodeAttribute

Megvalósítás

IDbConnection ICloneable IDisposable

Példák

Az alábbi példa létrehoz egy OleDbCommand és egy OleDbConnection. A OleDbConnection rendszer meg van nyitva, és a Connection következő értékre OleDbCommandvan állítva: . A példa ezután meghívja ExecuteNonQuery és bezárja a kapcsolatot. Ennek érdekében a ExecuteNonQuery egy kapcsolati karakterlánc és egy SQL INSERT utasítást tartalmazó lekérdezési sztringet ad át.

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

Megjegyzések

Az OleDbConnection objektumok egy adatforráshoz való egyedi kapcsolatot jelölnek. 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 OLE DB-szolgáltató által támogatott funkcióktól függően előfordulhat, hogy egy OleDbConnection objektum bizonyos metódusai vagy tulajdonságai nem érhetők el.

Amikor létrehoz egy példányt OleDbConnection, az összes tulajdonság a kezdeti értékekre van állítva. Ezeknek az értékeknek a listáját a konstruktorban OleDbConnection találja.

Egyszerre OleDbConnectiontöbb DataReadert is megnyithat. Ha a használt OLE DB-szolgáltató egyetlen kapcsolaton nem támogat több DataReadert, a szolgáltató implicit módon további kapcsolatot nyit meg mindegyikhez.

Ha a OleDbConnection hatókörön kívül esik, az nincs lezárva. Ezért explicit módon be kell zárnia a kapcsolatot hívással Close vagy elidegenítéssel, vagy az OleDbConnection objektum utasításon belüli Using használatával.

Note

A nagy teljesítményű alkalmazások üzembe helyezéséhez kapcsolatkészletezést kell használnia. Az OLE DB-hez készült .NET-keretrendszer Data Provider használatakor nem kell engedélyeznie a kapcsolatkészletezést, mert a szolgáltató ezt automatikusan kezeli. Az OLE DB-hez készült .NET Framework Data Provider kapcsolatkészletezésével kapcsolatos további információkért lásd: OLE DB, ODBC és Oracle-kapcsolatkészletezés.

Ha végzetes OleDbException (például 20 vagy annál nagyobb SQL Server súlyossági szint) jön létre egy OleDbCommand végrehajtó metódus, a OleDbConnection bezárható. 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 OleDbConnection 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. OleDbConnection biztonsági igényeket támaszt az OleDbPermission objektum használatával. A felhasználók az objektum használatával OleDbPermissionAttribute ellenőrizhetik, hogy a kódjuk rendelkezik-e megfelelő engedélyekkel. A felhasználók és a rendszergazdák a Caspol.exe (Code Access biztonsági szabályzat eszköz) használatával 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 adatkiszolgálóró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.

Note

Az OleDbConnection objektum nem támogatja az OLE DB-szolgáltatóra vonatkozó dinamikus tulajdonságok beállítását vagy beolvasását. Csak azok a tulajdonságok támogatottak, amelyek átadhatók az OLE DB szolgáltató kapcsolati sztringjén keresztül.

Konstruktorok

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

Tulajdonságok

Name	Description
ConnectionString	Lekéri vagy beállítja az adatbázis megnyitásához használt sztringet.
ConnectionTimeout	Lekéri 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.
Provider	Lekéri a kapcsolati karakterlánc "Provider=" záradékában megadott OLE DB-szolgáltató 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()	Elindít egy adatbázis-tranzakciót az aktuális IsolationLevel értékkel.
BeginTransaction(IsolationLevel)	Elindít egy adatbázis-tranzakciót a megadott elkülönítési szinttel.
ChangeDatabase(String)	Egy megnyitott OleDbConnectionadatbázis aktuális adatbázisának módosítása.
Close()	Bezárja az adatforráshoz való kapcsolatot.
CreateCommand()	Létrehoz és visszaad egy OleDbCommand objektumot, amely a OleDbConnection.
EnlistTransaction(Transaction)	A megadott tranzakciót elosztott tranzakcióként veszi fel.
GetOleDbSchemaTable(Guid, Object[])	Egy adatforrás sémaadatait adja vissza a GUID által jelzett módon, majd a megadott korlátozások alkalmazása után.
GetSchema()	Ennek az adatforrásnak OleDbConnectiona sémaadatait adja vissza.
GetSchema(String, String[])	Az adatforrás OleDbConnection 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 sztringjének OleDbConnection használatával adja vissza az adatforrás sémaadatait.
Open()	Megnyílik egy adatbázis-kapcsolat a megadott tulajdonságbeállításokkal ConnectionString.
ReleaseObjectPool()	Azt jelzi, hogy az OleDbConnection objektumkészlet felszabadítható az utolsó mögöttes kapcsolat felszabadításakor.
ResetState()	Frissíti az State objektum tulajdonságát OleDbConnection .

esemény

Name	Description
InfoMessage	Ez akkor fordul elő, ha a szolgáltató 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