OracleConnection Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Data.OracleClient

Zestaw:: System.Data.OracleClient.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Przestroga

OracleConnection has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260

Reprezentuje otwarte połączenie z bazą danych. Klasa ta nie może być dziedziczona.

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

[<System.Obsolete("OracleConnection has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)>]
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: Object

MarshalByRefObject

Component
OracleConnection

Dziedziczenie: Object

MarshalByRefObject

Component

DbConnection
OracleConnection

Atrybuty: ObsoleteAttribute

Implementuje: IDbConnection ICloneable IDisposable

Przykłady

Poniższy przykład tworzy element OracleCommand i .OracleConnection Obiekt OracleConnection jest otwierany i ustawiany jako OracleCommand.Connection właściwość. W tym przykładzie jest wywoływana ExecuteNonQueryfunkcja , a następnie zamyka połączenie. Aby to osiągnąć, ExecuteNonQuery parametr połączenia jest przekazywany i parametry zapytania, które są instrukcją SQL INSERT.

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łej wersji .NET Framework. Aby uzyskać więcej informacji, zobacz Oracle i ADO.NET.

Obiekt OracleConnection reprezentuje unikatowe połączenie z bazą danych Oracle. W przypadku systemu bazy danych klienta/serwera jest on odpowiednikiem połączenia sieciowego z serwerem.

Aplikacja, która tworzy wystąpienie OracleConnection obiektu, może ustawić deklaratywne lub imperatywne wymagania zabezpieczeń, które wymagają, aby wszystkie wywołania bezpośrednie i pośrednie miały odpowiednie uprawnienia do kodu. OracleConnection tworzy wymagania dotyczące zabezpieczeń przy użyciu OraclePermission obiektu . Użytkownicy mogą sprawdzić, czy kod ma odpowiednie uprawnienia przy użyciu OraclePermissionAttribute obiektu. Użytkownicy i administratorzy mogą również użyć narzędzia zasad zabezpieczeń dostępu kodu (Caspol.exe), aby zmodyfikować zasady zabezpieczeń na poziomie komputera, użytkownika i przedsiębiorstwa. Aby uzyskać więcej informacji, zobacz Zabezpieczenia.

Uwaga

W przeciwieństwie do obiektu Connection w innych dostawcach danych .NET Framework (SQL Server, OLE DB i ODBC) OracleConnection nie obsługuje ConnectionTimeout właściwości. Ustawienie limitu czasu połączenia jako właściwości lub parametrów połączenia nie ma wpływu, a zwracana wartość jest zawsze zerowa. OracleConnection nie obsługuje Database również właściwości ani ChangeDatabase metody.

OracleConnection Jeśli obiekt wykracza poza zakres, pozostanie otwarty. W związku z tym należy zawsze zamykać OracleConnection obiekty przez wywołanie Close lub usuwanie albo użycie OracleConnection obiektu w instrukcji Using . W przeciwnym razie odzyskiwanie pamięci może nie zwalniać ich natychmiast. Takie opóźnienia mogą powodować błędy, jeśli maksymalna liczba połączeń zostanie osiągnięta podczas oczekiwania na usunięcie liczby połączeń przez moduł odśmiecania pamięci. Z kolei zamykanie połączeń przez wywołanie Close korzysta z zasobów natywnych wydajniej, zwiększając skalowalność i poprawiając ogólną wydajność aplikacji. Aby upewnić się, że połączenia są zawsze zamknięte, otwórz połączenie wewnątrz Using bloku.

Uwaga

Aby wdrożyć aplikacje o wysokiej wydajności, często trzeba używać puli połączeń. Jednak w przypadku korzystania z dostawcy danych .NET Framework dla oracle nie trzeba włączać puli połączeń, ponieważ dostawca zarządza tym automatycznie.

Konstruktory

OracleConnection()	Przestarzałe. Inicjuje nowe wystąpienie klasy OracleConnection.
OracleConnection(String)	Przestarzałe. Inicjuje OracleConnection nowe wystąpienie klasy z określonymi parametrami połączenia.

Właściwości

CanCreateBatch	Przestarzałe. Pobiera wartość wskazującą, czy to DbConnection wystąpienie obsługuje klasę DbBatch . (Odziedziczone po DbConnection)
CanRaiseEvents	Przestarzałe. Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie. (Odziedziczone po Component)
ConnectionString	Przestarzałe. Pobiera lub ustawia ciąg używany do otwierania bazy danych Oracle.
ConnectionTimeout	Przestarzałe. Pobiera czas oczekiwania na nawiązanie połączenia przed zakończeniem próby i wygenerowaniem błędu.
Container	Przestarzałe. Pobiera element IContainer zawierający element Component. (Odziedziczone po Component)
Database	Przestarzałe. Pobiera nazwę bieżącej bazy danych lub bazy danych do użycia po otwarciu połączenia.
DataSource	Przestarzałe. Pobiera nazwę serwera Oracle, z którym ma być nawiązane połączenie.
DbProviderFactory	Przestarzałe. Pobiera element DbProviderFactory dla tego pliku DbConnection. (Odziedziczone po DbConnection)
DesignMode	Przestarzałe. Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania. (Odziedziczone po Component)
Events	Przestarzałe. Pobiera listę programów obsługi zdarzeń dołączonych do tego Componentelementu . (Odziedziczone po Component)
ServerVersion	Przestarzałe. Pobiera ciąg zawierający wersję serwera, z którym jest połączony klient.
Site	Przestarzałe. Pobiera lub ustawia ISite element .Component (Odziedziczone po Component)
State	Przestarzałe. Pobiera bieżący stan połączenia.

Metody

BeginDbTransaction(IsolationLevel)	Przestarzałe. Po zastąpieniu klasy pochodnej uruchamia transakcję bazy danych. (Odziedziczone po DbConnection)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	Przestarzałe. Asynchronicznie uruchamia transakcję bazy danych. (Odziedziczone po DbConnection)
BeginTransaction()	Przestarzałe. Rozpoczyna transakcję w bazie danych.
BeginTransaction(IsolationLevel)	Przestarzałe. Rozpoczyna transakcję w bazie danych o określonej IsolationLevel wartości.
BeginTransactionAsync(CancellationToken)	Przestarzałe. Asynchronicznie rozpoczyna transakcję bazy danych. (Odziedziczone po DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)	Przestarzałe. Asynchronicznie rozpoczyna transakcję bazy danych. (Odziedziczone po DbConnection)
ChangeDatabase(String)	Przestarzałe. Zmienia bieżącą bazę danych dla otwartego OracleConnectionpliku .
ChangeDatabaseAsync(String, CancellationToken)	Przestarzałe. Asynchronicznie zmienia bieżącą bazę danych dla otwartego połączenia. (Odziedziczone po DbConnection)
ClearAllPools()	Przestarzałe. Opróżnia pulę połączeń.
ClearPool(OracleConnection)	Przestarzałe. Opróżnia pulę połączeń skojarzona z określonym połączeniem.
Close()	Przestarzałe. Zamyka połączenie z bazą danych.
CloseAsync()	Przestarzałe. Asynchronicznie zamyka połączenie z bazą danych. (Odziedziczone po DbConnection)
CreateBatch()	Przestarzałe. Zwraca nowe wystąpienie klasy dostawcy, która implementuje klasę DbBatch . (Odziedziczone po DbConnection)
CreateCommand()	Przestarzałe. Tworzy i zwraca OracleCommand obiekt skojarzony z obiektem OracleConnection.
CreateDbBatch()	Przestarzałe. Po zastąpieniu klasy pochodnej zwraca nowe wystąpienie klasy dostawcy, które implementuje klasę DbBatch . (Odziedziczone po DbConnection)
CreateDbCommand()	Przestarzałe. Po zastąpieniu klasy pochodnej tworzy i zwraca DbCommand obiekt skojarzony z bieżącym połączeniem. (Odziedziczone po DbConnection)
CreateObjRef(Type)	Przestarzałe. Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Przestarzałe. Zwalnia wszelkie zasoby używane przez element Component. (Odziedziczone po Component)
Dispose()	Przestarzałe. Wykonuje zdefiniowane przez aplikację zadania skojarzone ze zwalnianiem lub resetowaniem zasobów niezarządzanych. (Odziedziczone po DbConnection)
Dispose(Boolean)	Przestarzałe. Zwalnia zasoby niezarządzane używane przez element Component i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po Component)
Dispose(Boolean)	Przestarzałe. Zwalnia zasoby niezarządzane używane przez element DbConnection i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po DbConnection)
DisposeAsync()	Przestarzałe. Asynchronicznie dysponuje obiekt połączenia. (Odziedziczone po DbConnection)
EnlistDistributedTransaction(ITransaction)	Przestarzałe. Enlists w określonej transakcji jako transakcji rozproszonej.
EnlistTransaction(Transaction)	Przestarzałe. Enlists w określonej transakcji jako transakcji rozproszonej.
Equals(Object)	Przestarzałe. Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Przestarzałe. Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Przestarzałe. Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetSchema()	Przestarzałe. Zwraca informacje o schemacie dla źródła danych tego OracleConnectionelementu .
GetSchema(String)	Przestarzałe. Zwraca informacje o schemacie dla źródła OracleConnection danych przy użyciu określonego ciągu nazwy schematu.
GetSchema(String, String[])	Przestarzałe. Zwraca informacje o schemacie dla źródła OracleConnection danych przy użyciu określonego ciągu dla nazwy schematu i określonej tablicy ciągów dla wartości ograniczeń.
GetSchemaAsync(CancellationToken)	Przestarzałe. Jest to asynchroniczna wersja programu GetSchema(). Dostawcy powinni zastąpić odpowiednią implementacją. Opcjonalnie `cancellationToken` można je honorować. Domyślna implementacja wywołuje wywołanie synchroniczne GetSchema() i zwraca ukończone zadanie. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazano już anulowany `cancellationToken`element . Wyjątki zgłoszone przez GetSchema() program będą przekazywane za pośrednictwem zwróconej właściwości Wyjątki zadania. (Odziedziczone po DbConnection)
GetSchemaAsync(String, CancellationToken)	Przestarzałe. Jest to asynchroniczna wersja programu GetSchema(String). Dostawcy powinni zastąpić odpowiednią implementacją. Opcjonalnie `cancellationToken` można je honorować. Domyślna implementacja wywołuje wywołanie synchroniczne GetSchema(String) i zwraca ukończone zadanie. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazano już anulowany `cancellationToken`element . Wyjątki zgłoszone przez GetSchema(String) program będą przekazywane za pośrednictwem zwróconej właściwości Wyjątki zadania. (Odziedziczone po DbConnection)
GetSchemaAsync(String, String[], CancellationToken)	Przestarzałe. Jest to asynchroniczna wersja programu GetSchema(String, String[]). Dostawcy powinni zastąpić odpowiednią implementacją. Opcjonalnie `cancellationToken` można je honorować. Domyślna implementacja wywołuje wywołanie synchroniczne GetSchema(String, String[]) i zwraca ukończone zadanie. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazano już anulowany `cancellationToken`element . Wyjątki zgłoszone przez GetSchema(String, String[]) program będą przekazywane za pośrednictwem zwróconej właściwości Wyjątki zadania. (Odziedziczone po DbConnection)
GetService(Type)	Przestarzałe. Zwraca obiekt reprezentujący usługę dostarczaną przez Component obiekt lub przez obiekt Container. (Odziedziczone po Component)
GetType()	Przestarzałe. Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
InitializeLifetimeService()	Przestarzałe. Uzyskuje obiekt usługi okresu istnienia, aby kontrolować zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Przestarzałe. Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Przestarzałe. Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	Przestarzałe. StateChange Zgłasza zdarzenie. (Odziedziczone po DbConnection)
Open()	Przestarzałe. Otwiera połączenie z bazą danych z ustawieniami właściwości określonymi przez ConnectionStringelement .
OpenAsync()	Przestarzałe. Asynchroniczna wersja programu Open(), która otwiera połączenie bazy danych z ustawieniami określonymi przez ConnectionStringelement . Ta metoda wywołuje metodę OpenAsync(CancellationToken) wirtualną z elementem CancellationToken.None. (Odziedziczone po DbConnection)
OpenAsync(CancellationToken)	Przestarzałe. Jest to asynchroniczna wersja programu Open(). Dostawcy powinni zastąpić odpowiednią implementacją. Token anulowania można opcjonalnie honorować. Domyślna implementacja wywołuje wywołanie synchroniczne Open() i zwraca ukończone zadanie. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazano już anulowane anulowanieToken. Wyjątki zgłaszane przez program Open będą przekazywane za pośrednictwem zwróconej właściwości Wyjątku zadania. Nie należy wywoływać innych metod i właściwości `DbConnection` obiektu, dopóki zwrócone zadanie nie zostanie ukończone. (Odziedziczone po DbConnection)
ToString()	Przestarzałe. Zwraca wartość String zawierającą nazwę Componentobiektu , jeśli istnieje. Ta metoda nie powinna być zastępowana. (Odziedziczone po Component)

Zdarzenia

Disposed	Przestarzałe. Występuje, gdy składnik jest usuwany przez wywołanie Dispose() metody . (Odziedziczone po Component)
InfoMessage	Przestarzałe. Występuje, gdy oracle wysyła ostrzeżenie lub komunikat informacyjny.
StateChange	Przestarzałe. Występuje, gdy stan połączenia ulegnie zmianie.
StateChange	Przestarzałe. Występuje, gdy stan połączenia ulegnie zmianie. (Odziedziczone po DbConnection)

Jawne implementacje interfejsu

ICloneable.Clone()	Przestarzałe. Tworzy nowy obiekt, który jest kopią bieżącego wystąpienia.
IDbConnection.BeginTransaction()	Przestarzałe. Rozpoczyna transakcję bazy danych.
IDbConnection.BeginTransaction()	Przestarzałe. Rozpoczyna transakcję bazy danych. (Odziedziczone po DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)	Przestarzałe. Rozpoczyna transakcję bazy danych o określonej IsolationLevel wartości.
IDbConnection.BeginTransaction(IsolationLevel)	Przestarzałe. Rozpoczyna transakcję bazy danych z określonym poziomem izolacji. (Odziedziczone po DbConnection)
IDbConnection.ChangeDatabase(String)	Przestarzałe. Zmienia bieżącą bazę danych dla otwartego obiektu Połączenia.
IDbConnection.CreateCommand()	Przestarzałe. Tworzy i zwraca obiekt polecenia skojarzony z połączeniem.
IDbConnection.CreateCommand()	Przestarzałe. Tworzy i zwraca DbCommand obiekt skojarzony z bieżącym połączeniem. (Odziedziczone po DbConnection)

Dotyczy