OleDbConnection Klas

Definitie

Naamruimte:: System.Data.OleDb

Assembly:: System.Data.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Vertegenwoordigt een geopende verbinding met een gegevensbron.

public ref class OleDbConnection sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbConnection

public ref class OleDbConnection sealed : 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, IDisposable

type OleDbConnection = class
    inherit Component
    interface ICloneable
    interface IDbConnection
    interface IDisposable

type OleDbConnection = class
    inherit DbConnection
    interface ICloneable
    interface IDbConnection
    interface IDisposable

Public NotInheritable Class OleDbConnection
Inherits Component
Implements ICloneable, IDbConnection, IDisposable

Public NotInheritable Class OleDbConnection
Inherits DbConnection
Implements ICloneable, IDisposable

Overname: Object

MarshalByRefObject

Component
OleDbConnection

Overname: Object

MarshalByRefObject

Component

DbConnection
OleDbConnection

Implementeringen: IDbConnection ICloneable IDisposable

Voorbeelden

In het volgende voorbeeld wordt een OleDbCommand en een OleDbConnection. De OleDbConnection wordt geopend en ingesteld als de Connection voor de OleDbCommand. In het voorbeeld wordt vervolgens de verbinding aanroepen ExecuteNonQuery en gesloten. Hiervoor wordt ExecuteNonQuery doorgegeven aan een verbindingsreeks en een queryreeks die een SQL INSERT-instructie is.

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

Opmerkingen

Een OleDbConnection object vertegenwoordigt een unieke verbinding met een gegevensbron. Met een client-/serverdatabasesysteem is het gelijk aan een netwerkverbinding met de server. Afhankelijk van de functionaliteit die wordt ondersteund door de systeemeigen OLE DB-provider, zijn sommige methoden of eigenschappen van een OleDbConnection object mogelijk niet beschikbaar.

Wanneer u een exemplaar maakt, OleDbConnectionworden alle eigenschappen ingesteld op de oorspronkelijke waarden. Zie de OleDbConnection constructor voor een lijst met deze waarden.

U kunt meer dan één DataReader openen op één OleDbConnection. Als de OLE DB-provider die u gebruikt niet meer dan één DataReader voor één verbinding ondersteunt, opent de provider impliciet een extra verbinding voor elke verbinding.

Als het OleDbConnection bereik buiten het bereik valt, wordt deze niet gesloten. Daarom moet u de verbinding expliciet sluiten door aan te roepen Close of verwijderen, of door het OleDbConnection object binnen een Using instructie te gebruiken.

Note

Als u toepassingen met hoge prestaties wilt implementeren, moet u verbindingspooling gebruiken. Wanneer u de .NET Framework-Data Provider voor OLE DB gebruikt, hoeft u verbindingspooling niet in te schakelen omdat de provider dit automatisch beheert. Zie OLE DB, ODBC en Oracle Connection Pooling voor meer informatie over het gebruik van verbindingspooling met het .NET Framework Data Provider voor OLE DB.

Als een fatale OleDbException (bijvoorbeeld een ernstniveau van SQL Server van 20 of hoger) wordt gegenereerd door de methode die een OleDbCommand uitvoert, kan de OleDbConnection worden gesloten. De gebruiker kan de verbinding echter opnieuw openen en doorgaan.

Een toepassing die een exemplaar van het OleDbConnection object maakt, kan vereisen dat alle directe en indirecte bellers voldoende machtigingen voor de code hebben door declaratieve of imperatieve beveiligingsvereisten in te stellen. OleDbConnection stelt beveiligingsvereisten op met behulp van het OleDbPermission object. Gebruikers kunnen controleren of hun code voldoende machtigingen heeft met behulp van het OleDbPermissionAttribute object. Gebruikers en beheerders kunnen ook het Caspol.exe (Hulpprogramma voor codetoegangsbeveiligingsbeleid) gebruiken om het beveiligingsbeleid op computer-, gebruikers- en ondernemingsniveau te wijzigen. Zie Code Access Security en ADO.NET voor meer informatie.

Zie Verbindingsevenementen voor meer informatie over het verwerken van waarschuwings- en informatieve berichten van de gegevensserver.

Note

Het OleDbConnection object biedt geen ondersteuning voor het instellen of ophalen van dynamische eigenschappen die specifiek zijn voor een OLE DB-provider. Alleen eigenschappen die kunnen worden doorgegeven in de verbindingsreeks voor de OLE DB-provider, worden ondersteund.

Constructors

Name	Description
OleDbConnection()	Initialiseert een nieuw exemplaar van de OleDbConnection klasse.
OleDbConnection(String)	Initialiseert een nieuw exemplaar van de klasse OleDbConnection met de opgegeven verbindingsreeks.

Eigenschappen

Name	Description
CanRaiseEvents	Hiermee wordt een waarde opgehaald die aangeeft of het onderdeel een gebeurtenis kan genereren. (Overgenomen van Component)
ConnectionString	Hiermee haalt u de tekenreeks op die wordt gebruikt om een database te openen of stelt u deze in.
ConnectionTimeout	Hiermee krijgt u de tijd die moet worden gewacht (in seconden) tijdens het tot stand brengen van een verbinding voordat u de poging beëindigt en een fout genereert.
Container	Hiermee haalt u het IContainer bestand op dat de Component. (Overgenomen van Component)
Database	Hiermee haalt u de naam op van de huidige database of de database die moet worden gebruikt nadat een verbinding is geopend.
DataSource	Hiermee haalt u de servernaam of bestandsnaam van de gegevensbron op.
DbProviderFactory	Krijgt het DbProviderFactory voor dit DbConnection. (Overgenomen van DbConnection)
DesignMode	Hiermee wordt een waarde opgehaald die aangeeft of de Component momenteel in de ontwerpmodus is. (Overgenomen van Component)
Events	Hiermee haalt u de lijst met gebeurtenis-handlers op die aan dit Componentbestand zijn gekoppeld. (Overgenomen van Component)
Provider	Hiermee haalt u de naam op van de OLE DB-provider die is opgegeven in de component Provider= van de verbindingsreeks.
ServerVersion	Hiermee haalt u een tekenreeks op die de versie van de server bevat waarmee de client is verbonden.
Site	Haalt of stelt de ISite van de Component. (Overgenomen van Component)
State	Hiermee haalt u de huidige status van de verbinding op.

Methoden

Name	Description
BeginDbTransaction(IsolationLevel)	Wanneer deze wordt overschreven in een afgeleide klasse, start u een databasetransactie. (Overgenomen van DbConnection)
BeginTransaction()	Hiermee start u een databasetransactie met de huidige IsolationLevel waarde.
BeginTransaction(IsolationLevel)	Hiermee start u een databasetransactie met het opgegeven isolatieniveau.
ChangeDatabase(String)	Hiermee wijzigt u de huidige database voor een geopende OleDbConnectiondatabase.
Close()	Hiermee sluit u de verbinding met de gegevensbron.
CreateCommand()	Hiermee maakt en retourneert u een OleDbCommand object dat is gekoppeld aan de OleDbConnection.
CreateDbCommand()	Wanneer deze wordt overschreven in een afgeleide klasse, maakt en retourneert u een DbCommand object dat is gekoppeld aan de huidige verbinding. (Overgenomen van DbConnection)
CreateObjRef(Type)	Hiermee maakt u een object dat alle relevante informatie bevat die nodig is om een proxy te genereren die wordt gebruikt om te communiceren met een extern object. (Overgenomen van MarshalByRefObject)
Dispose()	Alle resources die worden gebruikt door de Component. (Overgenomen van Component)
Dispose(Boolean)	Publiceert de niet-beheerde resources die worden gebruikt door de Component beheerde resources en brengt eventueel de beheerde resources vrij. (Overgenomen van Component)
EnlistDistributedTransaction(ITransaction)	Hiermee schakelt u de opgegeven transactie in als een gedistribueerde transactie.
EnlistTransaction(Transaction)	Hiermee schakelt u de opgegeven transactie in als een gedistribueerde transactie.
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetLifetimeService()	Hiermee haalt u het huidige levensduurserviceobject op waarmee het levensduurbeleid voor dit exemplaar wordt beheerd. (Overgenomen van MarshalByRefObject)
GetOleDbSchemaTable(Guid, Object[])	Retourneert schemagegevens uit een gegevensbron zoals aangegeven door een GUID en nadat deze de opgegeven beperkingen heeft toegepast.
GetSchema()	Retourneert schema-informatie voor de gegevensbron van deze OleDbConnection.
GetSchema(String, String[])	Retourneert schemagegevens voor de gegevensbron hiervan met behulp van OleDbConnection de opgegeven tekenreeks voor de schemanaam en de opgegeven tekenreeksmatrix voor de beperkingswaarden.
GetSchema(String)	Retourneert schemagegevens voor de gegevensbron hiervan met behulp van OleDbConnection de opgegeven tekenreeks voor de schemanaam.
GetService(Type)	Hiermee wordt een object geretourneerd dat een service vertegenwoordigt die wordt geleverd door of door de Component service Container. (Overgenomen van Component)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
InitializeLifetimeService()	Hiermee haalt u een levensduurserviceobject op om het levensduurbeleid voor dit exemplaar te beheren. (Overgenomen van MarshalByRefObject)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
MemberwiseClone(Boolean)	Hiermee maakt u een ondiepe kopie van het huidige MarshalByRefObject object. (Overgenomen van MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	Hiermee wordt de StateChange gebeurtenis gegenereerd. (Overgenomen van DbConnection)
Open()	Hiermee opent u een databaseverbinding met de eigenschapsinstellingen die zijn opgegeven door de ConnectionString.
OpenAsync()	Een asynchrone versie van Open(), waarmee een databaseverbinding wordt geopend met de instellingen die zijn opgegeven door de ConnectionString. Met deze methode wordt de virtuele methode OpenAsync(CancellationToken) aangeroepen met CancellationToken.None. (Overgenomen van DbConnection)
OpenAsync(CancellationToken)	Dit is de asynchrone versie van Open(). Providers moeten overschrijven met een geschikte implementatie. Het annuleringstoken kan eventueel worden gehonoreerd. De standaardimplementatie roept de synchrone aanroep aan Open() en retourneert een voltooide taak. De standaardimplementatie retourneert een geannuleerde taak als er al een geannuleerde cancellationToken is doorgegeven. Uitzonderingen die door Openen worden gegenereerd, worden gecommuniceerd via de geretourneerde eigenschap Taakuitzondering. Roep geen andere methoden en eigenschappen van het `DbConnection` object aan totdat de geretourneerde taak is voltooid. (Overgenomen van DbConnection)
ReleaseObjectPool()	Geeft aan dat de OleDbConnection objectgroep kan worden vrijgegeven wanneer de laatste onderliggende verbinding wordt vrijgegeven.
ResetState()	Hiermee wordt de State eigenschap van het OleDbConnection object bijgewerkt.
ToString()	Retourneert een String met de naam van de Component, indien van toepassing. Deze methode mag niet worden overschreven. (Overgenomen van Component)

gebeurtenis

Name	Description
Disposed	Treedt op wanneer het onderdeel wordt verwijderd door een aanroep naar de Dispose() methode. (Overgenomen van Component)
InfoMessage	Treedt op wanneer de provider een waarschuwing of een informatief bericht verzendt.
StateChange	Treedt op wanneer de status van de verbinding verandert.
StateChange	Treedt op wanneer de status van de verbinding verandert. (Overgenomen van DbConnection)

Expliciete interface-implementaties

Name	Description
ICloneable.Clone()	Zie voor een beschrijving van dit lid Clone().
IDbConnection.BeginTransaction()	Deze API ondersteunt de productinfrastructuur en is niet bedoeld om rechtstreeks vanuit de code te gebruiken. Begint een databasetransactie.
IDbConnection.BeginTransaction()	Begint een databasetransactie. (Overgenomen van DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)	Deze API ondersteunt de productinfrastructuur en is niet bedoeld om rechtstreeks vanuit de code te gebruiken. Hiermee begint u een databasetransactie met het opgegeven isolatieniveau.
IDbConnection.BeginTransaction(IsolationLevel)	Hiermee begint u een databasetransactie met het opgegeven isolatieniveau. (Overgenomen van DbConnection)
IDbConnection.CreateCommand()	Deze API ondersteunt de productinfrastructuur en is niet bedoeld om rechtstreeks vanuit de code te gebruiken. Hiermee maakt en retourneert u een opdrachtobject dat is gekoppeld aan de verbinding.
IDbConnection.CreateCommand()	Hiermee maakt en retourneert u een DbCommand object dat is gekoppeld aan de huidige verbinding. (Overgenomen van DbConnection)

Van toepassing op

Zie ook

Verbinding maken met gegevensbronnen

Feedback

Is deze pagina nuttig?