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::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

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

MarshalByRefObject

Component
OracleConnection

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

MarshalByRefObject

Component

DbConnection
OracleConnection

Атрибуты: ObsoleteAttribute

Реализации: IDbConnection ICloneable IDisposable

Примеры

В следующем примере создаются 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

Объект 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)

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

Поделиться через