OracleConnection Класс

Определение

Пространство имен:

System.Data.OracleClient

Сборка:

System.Data.OracleClient.dll

Внимание!

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

Предоставляет открытое подключение к базе данных. Этот класс не наследуется.

public ref class OracleConnection sealed : 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

[<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 DbConnection
Implements ICloneable

Наследование

Object

MarshalByRefObject

Component

DbConnection

OracleConnection

Атрибуты

ObsoleteAttribute

Реализации

ICloneable

Примеры

В следующем примере создаются OracleCommand и OracleConnection. Открывается OracleConnection и задается как OracleCommand.Connection свойство . Затем в примере вызывается ExecuteNonQueryи соединение закрывается. Для этого ExecuteNonQuery передается строка подключения и строка запроса, которая является инструкцией 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

Комментарии

Этот тип является устаревшим и будет удален в следующей версии платформа .NET Framework. Дополнительные сведения см. в разделе Oracle и ADO.NET.

Объект OracleConnection представляет собой уникальное соединение с базой данных Oracle. В случае системы баз данных клиента или сервера это эквивалентно сетевому подключению к серверу.

Приложение, создающее экземпляр OracleConnection объекта , может задавать декларативные или императивные требования безопасности, требующие, чтобы все прямые и косвенные вызывающие объекты имели соответствующее разрешение для кода. OracleConnection создает требования безопасности с помощью OraclePermission объекта . Пользователи могут убедиться, что их код имеет соответствующие разрешения, используя OraclePermissionAttribute объект . Пользователи и администраторы также могут использовать средство политики безопасности доступа к коду (Caspol.exe) для изменения политики безопасности на уровне компьютера, пользователя и предприятия. Дополнительные сведения см. в статье Безопасность.

Примечание

В отличие от объекта Connection в других платформа .NET Framework поставщиков данных (SQL Server, OLE DB и ODBC) OracleConnection не поддерживает ConnectionTimeout свойство . Установка времени ожидания подключения в качестве свойства или в строке подключения не влияет, и возвращаемое значение всегда равно нулю. OracleConnection также не поддерживает Database свойство или ChangeDatabase метод .

OracleConnection Если объект выходит из область, он остается открытым. Поэтому всегда следует закрывать OracleConnection объекты путем вызова Close или Dispose или с помощью OracleConnection объекта в операторе Using . В противном случае сборка мусора может не освободить их немедленно. Такие задержки могут привести к ошибкам, если достигнуто максимальное число подключений, а число подключений ожидает удаления сборщиком мусора. В отличие от этого, закрытие подключений путем вызова Close использует собственные ресурсы более эффективно, повышая масштабируемость и повышая общую производительность приложения. Чтобы убедиться, что подключения всегда закрыты, откройте соединение внутри Using блока.

Примечание

Для развертывания высокопроизводительных приложений часто требуется использовать пулы подключений. Однако при использовании поставщика данных платформа .NET Framework для Oracle не нужно включать пул подключений, так как поставщик управляет этим автоматически.

Конструкторы

OracleConnection()	Устаревшие.. Инициализирует новый экземпляр класса OracleConnection.
OracleConnection(String)	Устаревшие.. Инициализирует новый экземпляр класса OracleConnection с заданной строкой подключения.

Свойства

CanCreateBatch	Устаревшие.. Возвращает значение, определяющее, поддерживает ли экземпляр DbConnection класс DbBatch. (Унаследовано от DbConnection)
CanRaiseEvents	Устаревшие.. Возвращает значение, показывающее, может ли компонент вызывать событие. (Унаследовано от Component)
ConnectionString	Устаревшие.. Возвращает или задает строку, используемую для открытия базы данных Oracle.
ConnectionTimeout	Устаревшие.. Получает время ожидания при установлении подключения, по истечении которого попытка подключения завершается и генерируется ошибка.
Container	Устаревшие.. Возвращает объект IContainer, который содержит коллекцию Component. (Унаследовано от Component)
Database	Устаревшие.. Получает имя текущей базы данных или базы данных, которая будет использоваться после открытия подключения.
DataSource	Устаревшие.. Получает имя сервера Oracle, к которому осуществляется подключение.
DbProviderFactory	Устаревшие.. Получает объект DbProviderFactory для данного элемента DbConnection. (Унаследовано от DbConnection)
DesignMode	Устаревшие.. Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время. (Унаследовано от Component)
Events	Устаревшие.. Возвращает список обработчиков событий, которые прикреплены к этому объекту Component. (Унаследовано от Component)
ServerVersion	Устаревшие.. Получает строку, содержащую номер версии сервера, к которому подключается клиент.
Site	Устаревшие.. Получает или задает ISite объекта Component. (Унаследовано от Component)
State	Устаревшие.. Возвращает текущее состояние подключения.

Методы

BeginDbTransaction(IsolationLevel)	Устаревшие.. При переопределении в производном классе запускает транзакцию в базе данных. (Унаследовано от DbConnection)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	Устаревшие.. Асинхронно запускает транзакцию в базе данных. (Унаследовано от DbConnection)
BeginTransaction()	Устаревшие.. Начинает транзакцию в базе данных.
BeginTransaction(IsolationLevel)	Устаревшие.. Начинает транзакцию в базе данных с заданным значением IsolationLevel.
BeginTransactionAsync(CancellationToken)	Устаревшие.. Асинхронно начинает транзакцию базы данных. (Унаследовано от DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)	Устаревшие.. Асинхронно начинает транзакцию базы данных. (Унаследовано от DbConnection)
ChangeDatabase(String)	Устаревшие.. Осуществляет смену текущей базы данных для открытого соединения OracleConnection.
ChangeDatabaseAsync(String, CancellationToken)	Устаревшие.. Асинхронно изменяет текущую базу данных для открытого подключения. (Унаследовано от DbConnection)
ClearAllPools()	Устаревшие.. Очищает пул подключений.
ClearPool(OracleConnection)	Устаревшие.. Очищает пул подключений, связанный с заданным подключением.
Close()	Устаревшие.. Закрывает соединение с базой данных.
CloseAsync()	Устаревшие.. Асинхронно закрывает подключение к базе данных. (Унаследовано от DbConnection)
CreateBatch()	Устаревшие.. Возвращает новый экземпляра класса поставщика, реализующий класс DbBatch. (Унаследовано от DbConnection)
CreateCommand()	Устаревшие.. Создает и возвращает объект OracleCommand, связанный с объектом OracleConnection.
CreateDbBatch()	Устаревшие.. При переопределении в производном классе возвращает новый экземпляр класса поставщика, который реализует DbBatch класс . (Унаследовано от DbConnection)
CreateDbCommand()	Устаревшие.. При переопределении в производном классе создает и возвращает объект DbCommand, связанный с текущим подключением. (Унаследовано от DbConnection)
CreateObjRef(Type)	Устаревшие.. Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject)
Dispose()	Устаревшие.. Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов. (Унаследовано от DbConnection)
Dispose(Boolean)	Устаревшие.. Освобождает неуправляемые ресурсы, используемые объектом DbConnection, а при необходимости освобождает также управляемые ресурсы. (Унаследовано от DbConnection)
DisposeAsync()	Устаревшие.. Асинхронно размещает объект подключения. (Унаследовано от DbConnection)
EnlistDistributedTransaction(ITransaction)	Устаревшие.. Выполняет присоединение указанной транзакции как распределенной транзакции.
EnlistTransaction(Transaction)	Устаревшие.. Выполняет присоединение указанной транзакции как распределенной транзакции.
Equals(Object)	Устаревшие.. Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Устаревшие.. Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetLifetimeService()	Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра. (Унаследовано от MarshalByRefObject)
GetSchema()	Устаревшие.. Возвращает сведения схемы для источника данных этого объекта OracleConnection.
GetSchema(String)	Устаревшие.. Возвращает сведения о схеме для источника данных этого объекта OracleConnection, используя указанную строку в качестве имени схемы.
GetSchema(String, String[])	Устаревшие.. Возвращает сведения о схеме для источника данных этого объекта OracleConnection, используя указанную строку в качестве имени схемы и указанный массив строк для значений ограничений.
GetSchemaAsync(CancellationToken)	Устаревшие.. Это асинхронная версия метода GetSchema(). Поставщики должны выполнить переопределение с помощью соответствующей реализации. При необходимости можно учитывать cancellationToken. Реализация по умолчанию вызывает синхронный метод GetSchema() и возвращает выполненную задачу. Реализация по умолчанию возвращает отмененную задачу, если ей передается уже отмененный cancellationToken. Исключения, создаваемые GetSchema(), будут связаны через возвращаемое свойство исключения задачи. (Унаследовано от DbConnection)
GetSchemaAsync(String, CancellationToken)	Устаревшие.. Это асинхронная версия метода GetSchema(String). Поставщики должны выполнить переопределение с помощью соответствующей реализации. При необходимости можно учитывать cancellationToken. Реализация по умолчанию вызывает синхронный метод GetSchema(String) и возвращает выполненную задачу. Реализация по умолчанию возвращает отмененную задачу, если ей передается уже отмененный cancellationToken. Исключения, создаваемые GetSchema(String), будут связаны через возвращаемое свойство исключения задачи. (Унаследовано от DbConnection)
GetSchemaAsync(String, String[], CancellationToken)	Устаревшие.. Это асинхронная версия метода GetSchema(String, String[]). Поставщики должны выполнить переопределение с помощью соответствующей реализации. При необходимости можно учитывать cancellationToken. Реализация по умолчанию вызывает синхронный метод GetSchema(String, String[]) и возвращает выполненную задачу. Реализация по умолчанию возвращает отмененную задачу, если ей передается уже отмененный cancellationToken. Исключения, создаваемые GetSchema(String, String[]), будут связаны через возвращаемое свойство исключения задачи. (Унаследовано от DbConnection)
GetService(Type)	Устаревшие.. Возвращает объект, представляющий службу, предоставляемую классом Component или классом Container. (Унаследовано от Component)
GetType()	Устаревшие.. Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
InitializeLifetimeService()	Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
MemberwiseClone()	Устаревшие.. Создает неполную копию текущего объекта Object. (Унаследовано от Object)
MemberwiseClone(Boolean)	Устаревшие.. Создает неполную копию текущего объекта MarshalByRefObject. (Унаследовано от MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	Устаревшие.. Вызывает событие StateChange. (Унаследовано от DbConnection)
Open()	Устаревшие.. Открывает подключение к базе данных с использованием параметров свойств, заданных свойством ConnectionString.
OpenAsync()	Устаревшие.. Асинхронная версия Open(), которая открывает соединение с базой данных с параметрами, указанными ConnectionString. Этот метод вызывает виртуальный метод OpenAsync(CancellationToken) с CancellationToken.None. (Унаследовано от DbConnection)
OpenAsync(CancellationToken)	Устаревшие.. Это асинхронная версия метода Open(). Поставщики должны выполнить переопределение с помощью соответствующей реализации. При необходимости можно учитывать токен отмены. Реализация по умолчанию вызывает синхронный метод Open() и возвращает выполненную задачу. Реализация по умолчанию возвращает отмененную задачу, если ей передается уже отмененный cancellationToken. Исключения, создаваемые Open, будут связаны через возвращаемое свойство исключения задачи. Не вызывайте другие методы и свойства объекта DbConnection до тех пор, пока возвращаемая задача не будет завершена. (Унаследовано от DbConnection)
ToString()	Устаревшие.. Возвращает объект String, содержащий имя Component, если оно есть. Этот метод не следует переопределять. (Унаследовано от Component)

События

Disposed	Устаревшие.. Возникает при удалении компонента путем вызова метода Dispose(). (Унаследовано от Component)
InfoMessage	Устаревшие.. Происходит при отправке Oracle предупреждающего или информационного сообщения.
StateChange	Устаревшие.. Возникает при изменении состояния подключения. (Унаследовано от DbConnection)

Явные реализации интерфейса

ICloneable.Clone()	Устаревшие.. Создает новый объект, являющийся копией текущего экземпляра.
IDbConnection.BeginTransaction()	Устаревшие.. Начинает транзакцию базы данных. (Унаследовано от DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)	Устаревшие.. Начинает транзакцию базы данных с указанным уровнем изоляции. (Унаследовано от DbConnection)
IDbConnection.CreateCommand()	Устаревшие.. Создает и возвращает объект DbCommand, связанный с текущим подключением. (Унаследовано от DbConnection)

См. также раздел

• OracleDataAdapter
• OracleCommand