OracleConnection Klasa

Definicja

Ostrzeżenie

Ten interfejs API jest teraz przestarzały.

Reprezentuje otwarte połączenie z bazą danych.Represents an open connection to a database. Klasa ta nie może być dziedziczona.This class cannot be inherited.

public ref class OracleConnection sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbConnection
public ref class OracleConnection sealed : System::Data::Common::DbConnection, ICloneable
public sealed class OracleConnection : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbConnection
public sealed class OracleConnection : System.Data.Common.DbConnection, ICloneable
[System.Obsolete("OracleConnection has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)]
public sealed class OracleConnection : System.Data.Common.DbConnection, ICloneable
type OracleConnection = class
    inherit Component
    interface ICloneable
    interface IDbConnection
    interface IDisposable
type OracleConnection = class
    inherit DbConnection
    interface ICloneable
Public NotInheritable Class OracleConnection
Inherits Component
Implements ICloneable, IDbConnection, IDisposable
Public NotInheritable Class OracleConnection
Inherits DbConnection
Implements ICloneable
Dziedziczenie
Dziedziczenie
Atrybuty
Implementuje

Przykłady

Poniższy przykład tworzy OracleCommand i OracleConnection.The following example creates an OracleCommand and an OracleConnection. OracleConnection jest otwarty i ustawiany jako właściwość OracleCommand.Connection.The OracleConnection is opened and set as the OracleCommand.Connection property. Przykład następnie wywołuje ExecuteNonQueryi zamyka połączenie.The example then calls ExecuteNonQuery, and closes the connection. Aby to osiągnąć, ExecuteNonQuery jest przekazywać parametry połączenia i ciąg zapytania, który jest instrukcją SQL INSERT.To accomplish this, the ExecuteNonQuery is passed a connection string and a query string that is an SQL INSERT statement.

public void InsertRow(string connectionString)
{
    string queryString =
        "INSERT INTO Dept (DeptNo, Dname, Loc) values (50, 'TECHNOLOGY', 'DENVER')";
    using (OracleConnection connection = new OracleConnection(connectionString))
    {
        OracleCommand command = new OracleCommand(queryString);
        command.Connection = connection;
        try
        {
            connection.Open();
            command.ExecuteNonQuery();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
    }
}
Public Sub InsertRow(ByVal connectionString As String)
    Dim queryString As String = _
      "INSERT INTO Dept (DeptNo, Dname, Loc) values (50, 'TECHNOLOGY', 'DENVER')"

    Using connection As New OracleConnection(connectionString)
        Dim command As New OracleCommand(queryString)
        command.Connection = connection
        Try
            connection.Open()
            command.ExecuteNonQuery()
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
    End Using
End Sub

Uwagi

Ten typ jest przestarzały i zostanie usunięty w przyszłych wersjach .NET Framework.This type is deprecated and will be removed in a future version of the .NET Framework. Aby uzyskać więcej informacji, zobacz artykuł Oracle i ADO.NET.For more information, see Oracle and ADO.NET.

Obiekt OracleConnection reprezentuje unikatowe połączenie z bazą danych programu Oracle.An OracleConnection object represents a unique connection to an Oracle database. W przypadku systemu bazy danych klienta/serwera jest to równoważne z połączeniem sieciowym z serwerem.In the case of a client/server database system, it is equivalent to a network connection to the server.

Aplikacja, która tworzy wystąpienie obiektu OracleConnection, może ustawiać deklaracyjne lub bezwzględne wymagania dotyczące zabezpieczeń, które wymagają, aby wszyscy wywołujący bezpośredni i pośredni mieli odpowiednie uprawnienia do kodu.An application that creates an instance of the OracleConnection object can set declarative or imperative security demands that require all direct and indirect callers to have adequate permission to the code. OracleConnection tworzy wymagania dotyczące zabezpieczeń przy użyciu obiektu OraclePermission.OracleConnection creates security demands by using the OraclePermission object. Użytkownicy mogą sprawdzić, czy ich kod ma odpowiednie uprawnienia przy użyciu obiektu OraclePermissionAttribute.Users can verify that their code has adequate permissions by using the OraclePermissionAttribute object. Użytkownicy i Administratorzy mogą również używać narzędzia zasad zabezpieczeń dostępu kodu (Caspol. exe) do modyfikowania zasad zabezpieczeń na poziomie komputera, użytkownika i przedsiębiorstwa.Users and administrators can also use the Code Access Security Policy Tool (Caspol.exe) to modify security policy at the machine, user, and enterprise levels. Aby uzyskać więcej informacji, zobacz zabezpieczenia.For more information, see Security.

Uwaga

W przeciwieństwie do obiektu połączenia w innych dostawcach danych .NET Framework (SQL Server, OLE DB i ODBC), OracleConnection nie obsługuje właściwości ConnectionTimeout.Unlike the Connection object in the other .NET Framework data providers (SQL Server, OLE DB, and ODBC), OracleConnection does not support a ConnectionTimeout property. Ustawienie limitu czasu połączenia jako właściwości lub w parametrach połączenia nie ma żadnego efektu, a zwracana wartość jest zawsze równa zero.Setting a connection time-out either as a property or in the connection string has no effect, and the value returned is always zero. OracleConnection również nie obsługuje właściwości Database ani metody ChangeDatabase.OracleConnection also does not support a Database property or a ChangeDatabase method.

Jeśli obiekt OracleConnection wykracza poza zakres, pozostaje otwarty.If the OracleConnection object goes out of scope, it remains open. W związku z tym należy zawsze zamykać OracleConnection obiektów, wywołując Close lub Disposelub używając obiektu OracleConnection w instrukcji Using.Therefore, you should always close OracleConnection objects by calling Close or Dispose, or by using the OracleConnection object within a Using statement. W przeciwnym razie wyrzucanie elementów bezużytecznych może nie zostać od razu zwolnione.Otherwise, the garbage collection might not free them immediately. Takie opóźnienia mogą spowodować błędy, jeśli osiągnięto maksymalną liczbę połączeń, gdy liczba połączeń czeka na usunięcie przez moduł wyrzucania elementów bezużytecznych.Such delays can cause errors if the maximum number of connections is reached while a number of connections are waiting to be deleted by the garbage collector. W przeciwieństwie do zamykania połączeń, wywołując Close zużywa zasoby natywne bardziej wydajnie, zwiększając skalowalność i zwiększając ogólną wydajność aplikacji.By contrast, closing the connections by calling Close uses native resources more efficiently, enhancing scalability and improving overall application performance. Aby upewnić się, że połączenia są zawsze zamknięte, otwórz połączenie wewnątrz bloku Using.To ensure that connections are always closed, open the connection inside of a Using block.

Uwaga

Aby wdrożyć aplikacje o wysokiej wydajności, często trzeba użyć puli połączeń.To deploy high-performance applications, you often need to use connection pooling. Jednak w przypadku korzystania z .NET Framework Dostawca danych dla programu Oracle nie ma potrzeby włączania puli połączeń, ponieważ dostawca ten zarządza automatycznie.However, when you use the .NET Framework Data Provider for Oracle, you do not need to enable connection pooling because the provider manages this automatically.

Konstruktory

OracleConnection()

Inicjuje nowe wystąpienie klasy OracleConnection.Initializes a new instance of the OracleConnection.

OracleConnection(String)

Inicjuje nowe wystąpienie klasy OracleConnection z określonymi parametrami połączenia.Initializes a new instance of the OracleConnection class with the specified connection string.

Właściwości

CanRaiseEvents

Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie.Gets a value indicating whether the component can raise an event.

(Odziedziczone po Component)
ConnectionString

Pobiera lub ustawia ciąg używany do otwierania bazy danych Oracle.Gets or sets the string used to open an Oracle database.

ConnectionTimeout

Pobiera czas oczekiwania na nawiązanie połączenia przed zakończeniem próby i wygenerowaniem błędu.Gets the time to wait to establish a connection before terminating the attempt and generating an error.

Container

Pobiera IContainer, który zawiera Component.Gets the IContainer that contains the Component.

(Odziedziczone po Component)
Database

Pobiera nazwę bieżącej bazy danych lub bazę danych, która ma zostać użyta po otwarciu połączenia.Gets the name of the current database or the database to be used after a connection is opened.

DataSource

Pobiera nazwę serwera Oracle, z którym ma zostać nawiązane połączenie.Gets the name of the Oracle server to which to connect.

DbProviderFactory

Pobiera DbProviderFactory dla tego DbConnection.Gets the DbProviderFactory for this DbConnection.

(Odziedziczone po DbConnection)
DesignMode

Pobiera wartość wskazującą, czy Component jest obecnie w trybie projektowania.Gets a value that indicates whether the Component is currently in design mode.

(Odziedziczone po Component)
Events

Pobiera listę programów obsługi zdarzeń, które są dołączone do tego Component.Gets the list of event handlers that are attached to this Component.

(Odziedziczone po Component)
ServerVersion

Pobiera ciąg zawierający wersję serwera, z którym jest połączony klient.Gets a string containing the version of the server to which the client is connected.

Site

Pobiera lub ustawia ISite Component.Gets or sets the ISite of the Component.

(Odziedziczone po Component)
State

Pobiera bieżący stan połączenia.Gets the current state of the connection.

Metody

BeginDbTransaction(IsolationLevel)

Gdy jest zastępowany w klasie pochodnej, uruchamia transakcję bazy danych.When overridden in a derived class, starts a database transaction.

(Odziedziczone po DbConnection)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)

Asynchronicznie uruchamia transakcję bazy danych.Asynchronously starts a database transaction.

(Odziedziczone po DbConnection)
BeginTransaction()

Rozpoczyna transakcję w bazie danych.Begins a transaction at the database.

BeginTransaction(IsolationLevel)

Rozpoczyna transakcję w bazie danych o określonej wartości IsolationLevel.Begins a transaction at the database with the specified IsolationLevel value.

BeginTransactionAsync(CancellationToken)

Asynchronicznie rozpoczyna transakcję bazy danych.Asynchronously begins a database transaction.

(Odziedziczone po DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)

Asynchronicznie rozpoczyna transakcję bazy danych.Asynchronously begins a database transaction.

(Odziedziczone po DbConnection)
ChangeDatabase(String)

Zmienia bieżącą bazę danych otwartej OracleConnection.Changes the current database for an open OracleConnection.

ChangeDatabaseAsync(String, CancellationToken)

Asynchronicznie zmienia bieżącą bazę danych dla otwartego połączenia.Asynchronously changes the current database for an open connection.

(Odziedziczone po DbConnection)
ClearAllPools()

Opróżnia pulę połączeń.Empties the connection pool.

ClearPool(OracleConnection)

Opróżnia pulę połączeń skojarzoną z określonym połączeniem.Empties the connection pool associated with the specified connection.

Close()

Zamyka połączenie z bazą danych.Closes the connection to the database.

CloseAsync()

Asynchronicznie zamyka połączenie z bazą danych.Asynchronously closes the connection to the database.

(Odziedziczone po DbConnection)
CreateCommand()

Tworzy i zwraca obiekt OracleCommand skojarzony z OracleConnection.Creates and returns an OracleCommand object associated with the OracleConnection.

CreateDbCommand()

Gdy jest zastępowany w klasie pochodnej, tworzy i zwraca obiekt DbCommand skojarzony z bieżącym połączeniem.When overridden in a derived class, creates and returns a DbCommand object associated with the current connection.

(Odziedziczone po DbConnection)
CreateObjRef(Type)

Tworzy obiekt, który zawiera wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikacji z obiektem zdalnym.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Odziedziczone po MarshalByRefObject)
Dispose()

Zwalnia wszelkie zasoby używane przez element Component.Releases all resources used by the Component.

(Odziedziczone po Component)
Dispose() (Odziedziczone po DbConnection)
Dispose(Boolean)

Zwalnia zasoby niezarządzane używane przez element Component i opcjonalnie zwalnia zasoby zarządzane.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Odziedziczone po Component)
Dispose(Boolean) (Odziedziczone po DbConnection)
DisposeAsync()

Asynchronicznie nakłada obiekt połączenia.Asynchronously diposes the connection object.

(Odziedziczone po DbConnection)
EnlistDistributedTransaction(ITransaction)

Rejestrowanie w określonej transakcji jako transakcja rozproszona.Enlists in the specified transaction as a distributed transaction.

EnlistTransaction(Transaction)

Rejestrowanie w określonej transakcji jako transakcja rozproszona.Enlists in the specified transaction as a distributed transaction.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetLifetimeService()

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
GetSchema()

Zwraca informacje o schemacie dla źródła danych tego OracleConnection.Returns schema information for the data source of this OracleConnection.

GetSchema(String)

Zwraca informacje o schemacie dla źródła danych tego OracleConnection przy użyciu określonego ciągu dla nazwy schematu.Returns schema information for the data source of this OracleConnection using the specified string for the schema name.

GetSchema(String, String[])

Zwraca informacje o schemacie dla źródła danych tego OracleConnection przy użyciu określonego ciągu dla nazwy schematu i określonej tablicy ciągów dla wartości ograniczeń.Returns schema information for the data source of this OracleConnection using the specified string for the schema name and the specified string array for the restriction values.

GetService(Type)

Zwraca obiekt, który reprezentuje usługę dostarczoną przez Component lub Container.Returns an object that represents a service provided by the Component or by its Container.

(Odziedziczone po Component)
GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
InitializeLifetimeService()

Uzyskuje obiekt usługi istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy skróconą kopię bieżącego obiektu MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Odziedziczone po MarshalByRefObject)
OnStateChange(StateChangeEventArgs)

Podnosi zdarzenie StateChange.Raises the StateChange event.

(Odziedziczone po DbConnection)
Open()

Otwiera połączenie z bazą danych przy użyciu ustawień właściwości określonych przez ConnectionString.Opens a connection to a database with the property settings specified by the ConnectionString.

OpenAsync()

Asynchroniczna wersja Open(), która otwiera połączenie z bazą danych z ustawieniami określonymi przez ConnectionString.An asynchronous version of Open(), which opens a database connection with the settings specified by the ConnectionString. Ta metoda wywołuje metodę wirtualną OpenAsync(CancellationToken) z CancellationToken. None.This method invokes the virtual method OpenAsync(CancellationToken) with CancellationToken.None.

(Odziedziczone po DbConnection)
OpenAsync(CancellationToken)

Jest to asynchroniczna wersja Open().This is the asynchronous version of Open(). Dostawcy powinny zastępować odpowiednie implementacje.Providers should override with an appropriate implementation. Token anulowania można opcjonalnie przyjąć.The cancellation token can optionally be honored.

Implementacja domyślna wywołuje synchroniczne wywołanie Open() i zwraca ukończone zadanie.The default implementation invokes the synchronous Open() call and returns a completed task. Domyślna implementacja zwróci anulowane zadanie, jeśli zostało zakończone już anulowane cancellationToken.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Wyjątki zgłoszone przez otwarcie będą przekazywane za pośrednictwem Właściwości zwróconego wyjątku zadania.Exceptions thrown by Open will be communicated via the returned Task Exception property.

Nie wywołuj innych metod i właściwości obiektu DbConnection, dopóki nie zakończy się zwrócone zadanie.Do not invoke other methods and properties of the DbConnection object until the returned Task is complete.

(Odziedziczone po DbConnection)
ToString()

Zwraca String zawierający nazwę Component, jeśli istnieje.Returns a String containing the name of the Component, if any. Ta metoda nie powinna być przesłaniana.This method should not be overridden.

(Odziedziczone po Component)

Zdarzenia

Disposed

Występuje, gdy składnik zostanie usunięty przez wywołanie metody Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Odziedziczone po Component)
InfoMessage

Występuje, gdy Oracle wysyła komunikat ostrzegawczy lub informacyjny.Occurs when Oracle sends a warning or an informational message.

StateChange

Występuje, gdy zmienia się stan połączenia.Occurs when the state of the connection changes.

StateChange

Występuje, gdy zmienia się stan połączenia.Occurs when the state of the connection changes.

(Odziedziczone po DbConnection)

Jawne implementacje interfejsu

ICloneable.Clone()

Tworzy nowy obiekt, który jest kopią bieżącego wystąpienia.Creates a new object that is a copy of the current instance.

IDbConnection.BeginTransaction()

Rozpoczyna transakcję bazy danych.Begins a database transaction.

IDbConnection.BeginTransaction()

Rozpoczyna transakcję bazy danych.Begins a database transaction.

(Odziedziczone po DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)

Rozpoczyna transakcję bazy danych o określonej wartości IsolationLevel.Begins a database transaction with the specified IsolationLevel value.

IDbConnection.BeginTransaction(IsolationLevel)

Rozpoczyna transakcję bazy danych o określonym poziomie izolacji.Begins a database transaction with the specified isolation level.

(Odziedziczone po DbConnection)
IDbConnection.ChangeDatabase(String)

Zmienia bieżącą bazę danych dla otwartego obiektu połączenia.Changes the current database for an open Connection object.

IDbConnection.CreateCommand()

Tworzy i zwraca obiekt polecenia, który jest skojarzony z połączeniem.Creates and returns a Command object that is associated with the connection.

IDbConnection.CreateCommand()

Tworzy i zwraca obiekt DbCommand, który jest skojarzony z bieżącym połączeniem.Creates and returns a DbCommand object that is associated with the current connection.

(Odziedziczone po DbConnection)

Dotyczy

Zobacz też