OracleConnection Класс

Определение

Внимание!

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

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

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
Наследование
Наследование
Атрибуты
Реализации

Примеры

В следующем примере создаются 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()
Является устаревшей.

Освобождает все ресурсы, занятые модулем Component.

(Унаследовано от Component)
Dispose()
Является устаревшей.

Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов.

(Унаследовано от DbConnection)
Dispose(Boolean)
Является устаревшей.

Освобождает неуправляемые ресурсы, используемые объектом Component, а при необходимости освобождает также управляемые ресурсы.

(Унаследовано от Component)
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
Является устаревшей.

Возникает при изменении состояния подключения.

StateChange
Является устаревшей.

Возникает при изменении состояния подключения.

(Унаследовано от DbConnection)

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

ICloneable.Clone()
Является устаревшей.

Создает новый объект, являющийся копией текущего экземпляра.

IDbConnection.BeginTransaction()
Является устаревшей.

Начинает транзакцию базы данных.

IDbConnection.BeginTransaction()
Является устаревшей.

Начинает транзакцию базы данных.

(Унаследовано от DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)
Является устаревшей.

Начинает транзакцию базы данных с указанным значением IsolationLevel.

IDbConnection.BeginTransaction(IsolationLevel)
Является устаревшей.

Начинает транзакцию базы данных с указанным уровнем изоляции.

(Унаследовано от DbConnection)
IDbConnection.ChangeDatabase(String)
Является устаревшей.

Изменяет текущую базу данных для открытого объекта Connection.

IDbConnection.CreateCommand()
Является устаревшей.

Создает и возвращает объект Command, связанный с подключением.

IDbConnection.CreateCommand()
Является устаревшей.

Создает и возвращает объект DbCommand, связанный с текущим подключением.

(Унаследовано от DbConnection)

Применяется к

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