Oracle Data Provider for .NET Assemblies

This section contains the following topics:

Oracle Data Provider for .NET, Unmanaged Driver Assemblies
Oracle Data Provider for .NET, Managed Driver Assemblies
Oracle.DataAccess.Client and Oracle.ManagedDataAccess.Client Namespaces
Oracle.DataAccess.Types and Oracle.ManagedDataAccess.Types Namespaces

Oracle Data Provider for .NET, Unmanaged Driver Assemblies

The Oracle.DataAccess.dll assembly provides two namespaces:

The Oracle.DataAccess.Client namespace contains ODP.NET classes and enumerations for the client-side provider.
The Oracle.DataAccess.Types namespace contains the Oracle Data Provider for .NET data types (ODP.NET Types).

To use Code First or Entity Framework 6 or higher with ODP.NET, Unmanaged Driver, add Oracle.DataAccess.EntityFramework.dll as a project assembly reference. It contains the namespace Oracle.DataAccess.EntityFramework.

Oracle Data Provider for .NET, Managed Driver Assemblies

The Oracle.ManagedDataAccess.dll assembly provides two namespaces:

The Oracle.ManagedDataAccess.Client namespace contains ODP.NET classes and enumerations for the client-side provider.
The Oracle.ManagedDataAccess.Types namespace contains the Oracle Data Provider for .NET data types (ODP.NET Types).

ODP.NET, Managed Driver contains additional assemblies. These assemblies are optional to install if not using the specific functionality.

Applications do not need to explicitly add these assemblies to their project. ODP.NET, Managed Driver will access these assemblies by default if installed.

The one exception is Oracle.ManagedDataAccess.EntityFramework.dll. That DLL must be explicitly added to a project for its functionality to be used.

Oracle.ManagedDataAccessDTC.dll - Only required when using distributed transactions. The assembly is fully managed, but has 32-bit and x64 versions depending on the .NET Framework's bitness in which it runs. The assembly makes calls to unmanaged assemblies.
Oracle.ManagedDataAccess.EntityFramework.dll - Only required when using Code First or Entity Framework 6 or higher. It contains the Oracle.ManagedDataAccess.EntityFramework namespace.

Oracle.DataAccess.Client and Oracle.ManagedDataAccess.Client Namespaces

The Oracle.DataAccess.Client and Oracle.ManagedDataAccess.Client namespaces contains implementations of core ADO.NET classes and enumerations for ODP.NET, as well as ODP.NET specific classes.

The following tables list ODP.NET classes, enumerations, and types that are supported by the Oracle.DataAccess.Client and Oracle.ManagedDataAccess.Client namespaces. The tables indicate which of them are not supported by ODP.NET, Managed Driver and/or by .NET stored procedures. All are supported by ODP.NET, Unmanaged Driver.

Oracle.DataAccess.Client and Oracle.ManagedDataAccess.Client

Table 1-1 lists the Oracle.DataAccess.Client and Oracle.ManagedDataAccess.Client classes and delegates.

Table 1-1 Oracle.DataAccess.Client and Oracle.ManagedDataAccess.Client

Class or Delegate	Supported in the ODP.NET, Managed Driver	Supported in .NET Stored Procedures	Description
OnChangeEventHandler Delegate	-	No	The `OnChangedEventHandler` event delegate represents the signature of the method that handles the notification.
OracleAQAgent Class	No	-	The `OracleAQAgent` class represents agents that may be senders or recipients of a message.
OracleAQDequeueOptions Class	No	-	An `OracleAQDequeueOptions` object represents the options available when dequeuing a message from an `OracleAQQueue` object.
OracleAQEnqueueOptions Class	No	-	The `OracleAQEnqueueOptions` class represents the options available when enqueuing a message to an `OracleAQQueue`.
OracleAQMessage Class	No	-	An `OracleAQMessage` object represents a message to be enqueued and dequeued.
OracleAQMessageAvailableEventArgs Class	No	-	The `OracleAQMessageAvailableEventArgs` class provides event data for the `OracleAQQueue.MessageAvailable` event.
OracleAQMessageAvailableEventHandler Delegate	No	-	The `OracleAQMessageAvailableEventHandler` delegate represents the signature of the method that handles the `OracleAQQueue.MessageAvailable` event.
OracleAQQueue Class	No	-	An `OracleAQQueue` object represents a queue.
OracleBulkCopy Class	No	-	An `OracleBulkCopy` object efficiently bulk loads or copies data into an Oracle table from another data source.
OracleBulkCopyColumnMapping Class	No	-	The `OracleBulkCopyColumnMapping` class defines the mapping between a column in the data source and a column in the destination database table.
OracleBulkCopyColumnMappingCollection Class	No	-	The `OracleBulkCopyColumnMappingCollection` class represents a collection of `OracleBulkCopyColumnMapping` objects that are used to map columns in the data source to columns in a destination table.
OracleClientFactory Class	-	-	An `OracleClientFactory` object allows applications to instantiate ODP.NET classes in a generic way.
OracleCommand Class	-	-	An `OracleCommand` object represents a SQL command, a stored procedure or function, or a table name.
OracleCommandBuilder Class	-	-	An `OracleCommandBuilder` object provides automatic SQL generation for the `OracleDataAdapter` when the database is updated.
OracleConnection Class	-	-	An `OracleConnection` object represents a connection to Oracle Database.
OracleConnectionStringBuilder Class	-	-	An `OracleConnectionStringBuilder` object allows applications to create or modify connection strings.
OracleDataAdapter Class	-	-	An `OracleDataAdapter` object represents a data provider object that communicates with the `DataSet`.
OracleDatabase Class	No	-	An `OracleDatabase` object represents an Oracle Database instance.
OracleDataReader Class	-	-	An `OracleDataReader` object represents a forward-only, read-only, in-memory result set.
OracleDataSourceEnumerator Class	-	-	An `OracleDataSourceEnumerator` object allows applications to generically obtain a collection of data sources to connect to.
OracleDependency Class	-	No	An `OracleDependency` class represents a dependency between an application and an Oracle database.
OracleError Class	-	-	The `OracleError` object represents an error reported by an Oracle database.
OracleErrorCollection Class	-	-	An `OracleErrorCollection` object represents a collection of `OracleError`s.
OracleException Class	-	-	The `OracleException` object represents an exception that is thrown when Oracle Data Provider for .NET encounters an error.
OracleFailoverEventArgs Class	No	No	The `OracleFailoverEventArgs` class provides event data for the `OracleConnection.Failover` event.
OracleFailoverEventHandler Delegate	No	No	The `OracleFailoverEventHandler` represents the signature of the method that handles the `OracleConnection.Failover` event.
OracleGlobalization Class	-	-	The `OracleGlobalization` class is used to obtain and set the Oracle globalization settings of the session, thread, and local computer (read-only).
OracleHAEventArgs Class	-	-	The `OracleHAEventArgs` class provides event data for the `OracleConnection.HAEvent` event.
OracleHAEventHandler Delegate	-	-	The `OracleHAEventHandler` delegate represents the signature of the method that handles the `OracleConnection.HAEvent` event.
OracleInfoMessageEventArgs Class	-	-	The `OracleInfoMessageEventArgs` object provides event data for the `OracleConnection.InfoMessage` event.
OracleInfoMessageEventHandler Delegate	-	-	The `OracleInfoMessageEventHandler` delegate represents the signature of the method that handles the `OracleConnection.InfoMessage` event.
OracleLogicalTransactionStatus Class	-	-	The `OracleLogicalTransactionStatus` class provides information on the status of a logical transaction. This class has been deprecated in ODP.NET 12.1.0.2. It will be desupported in a future release.
OracleNotificationEventArgs Class	-	-	The `OracleNotificationEventArgs` class provides event data for a notification.
OracleNotificationRequest Class	-	No	An `OracleNotificationRequest` class represents a notification request to be subscribed in the database.
OracleParameter Class	-	-	An `OracleParameter` object represents a parameter for an `OracleCommand.`
OracleParameterCollection Class	-	-	An `OracleParameterCollection` object represents a collection of `OracleParameter`s.
OraclePermission Class	-	-	An `OraclePermission` object enables ODP.NET to enforce imperative security and helps ensure that a user has a security level adequate for accessing data.
OraclePermissionAttribute Class	-	-	An `OraclePermissionAttribute` object enables ODP.NET to enforce declarative security and helps ensure that a user has a security level adequate for accessing data.
OracleRowsCopiedEventHandler Delegate	No	-	The `OracleRowsCopiedEventHandler` delegate represents the method that handles the `OracleRowsCopied` event of an `OracleBulkCopy` object.
OracleRowsCopiedEventArgs Class	No	-	The `OracleRowsCopiedEventArgs` class represents the set of arguments passed as part of event data for the `OracleRowsCopied` event.
OracleRowUpdatedEventArgs Class	-	-	The `OracleRowUpdatedEventArgs` object provides event data for the `OracleDataAdapter.RowUpdated` event.
OracleRowUpdatedEventHandler Delegate	-	-	The `OracleRowUpdatedEventHandler` delegate represents the signature of the method that handles the `OracleDataAdapter.RowUpdated` event.
OracleRowUpdatingEventArgs Class	-	-	The `OracleRowUpdatingEventArgs` object provides event data for the `OracleDataAdapter.RowUpdating` event.
OracleRowUpdatingEventHandler Delegate	-	-	The `OracleRowUpdatingEventHandler` delegate represents the signature of the method that handles the `OracleDataAdapter.RowUpdating` event.
OracleTransaction Class	-	No	An `OracleTransaction` object represents a local transaction.
OracleXmlQueryProperties Class	No	-	An `OracleXmlQueryProperties` object represents the XML properties used by the `OracleCommand` class when the `XmlCommandType` property is `Query`.
OracleXmlSaveProperties Class	No	-	An `OracleXmlSaveProperties` object represents the XML properties used by the `OracleCommand` class when the `XmlCommandType` property is `Insert`, `Update`, or `Delete`.

Oracle.DataAccess.Client and Oracle.ManagedDataAccess.Client Enumerations

Table 1-2 lists the client enumerations.

Table 1-2 Oracle.DataAccess.Client and Oracle.ManagedDataAccess.Client Enumerations

Enumeration	Supported in the ODP.NET, Managed Driver	Supported in .NET Stored Procedures	Description
FailoverEvent Enumeration	No	No	`FailoverEvent` enumerated values are used to specify the state of the failover.
FailoverReturnCode Enumeration	No	No	`FailoverReturnCode` enumerated values are passed back by the application to the ODP.NET provider to request a retry in case of a failover error, or to continue in case of a successful failover.
FailoverType Enumeration	No	No	`FailoverType` enumerated values are used to indicate the type of failover event that was raised.
OracleAQDequeueMode Enumeration	No	-	The `OracleAQDequeueMode` enumeration type specifies the dequeue mode.
OracleAQMessageDeliveryMode Enumeration	No	-	The `OracleAQMessageDeliveryMode` enumeration type specifies the delivery mode of the message.
OracleAQMessageState Enumeration	No	-	The `OracleAQMessageState` enumeration type identifies the state of the message at the time of dequeue.
OracleAQMessageType Enumeration	No	-	The `OracleAQMessageType` enumeration type specifies the message payload type.
OracleAQNavigationMode Enumeration	No	-	The `OracleAQNavigationMode` enumeration type specifies the navigation mode.
OracleAQNotificationGroupingType Enumeration	No	-	The `OracleAQNotificationGroupingType` enumeration type specifies the notification grouping type.
OracleAQNotificationType Enumeration	No	-	The `OracleAQNotificationType` enumeration type specifies the notification type of the received notification.
OracleAQVisibilityMode Enumeration	No	-	The `OracleAQVisibilityMode` enumeration type specifies whether the enqueue or dequeue operation is part of the current transaction.
OracleBulkCopyOptions Enumeration	No	-	The `OracleBulkCopyOptions` enumeration specifies the values that can be combined with an instance of the `OracleBulkCopy` class and used as options to determine its behavior and the behavior of the `WriteToServer` methods for that instance.
OracleCollectionType Enumeration	-	No	`OracleCollectionType` enumerated values specify whether or not the `OracleParameter` object represents a collection, and if so, specifies the collection type.
OracleConnectionType Enumeration	No	-	`OracleConnectionType` enumerated values specify whether a particular connection object is associated with an Oracle database connection, a TimesTen database connection, or no physical connection at all.
OracleDBShutdownMode Enumeration	No	-	`OracleDBShutdownMode` enumerated values specify the database shutdown options.
OracleDBStartupMode Enumeration	No	-	`OracleDBStartupMode` enumerated values specify the database startup options.
OracleDbType Enumeration	-	-	`OracleDbType` enumerated values are used to explicitly specify the `OracleDbType` of an `OracleParameter`.
OracleHAEventSource Enumeration	-	-	The `OracleHAEventSource` enumeration indicates the source of the HA event.
OracleHAEventStatus Enumeration	-	-	The `OracleHAEventStatus` enumeration indicates the status of the HA event source.
OracleIdentityType Enumeration	-	-	The `OracleIdentityType` enumeration specifies how Oracle identity column values are generated.
OracleNotificationInfo Enumeration	-	No	`OracleNotificationInfo` enumerated values specify the database event that causes the notification.
OracleNotificationSource Enumeration	-	No	`OracleNotificationSource` enumerated values specify the different sources that cause notification.
OracleNotificationType Enumeration	-	No	`OracleNotificationType` enumerated values specify the different types that cause the notification.
OracleParameterStatus Enumeration	-	-	The `OracleParameterStatus` enumeration type indicates whether a `NULL` value is fetched from a column, or truncation has occurred during the fetch, or a `NULL` value is to be inserted into a database column.
OracleRowidInfo Enumeration	-	-	The `OracleRowidInfo` enumeration values specify whether `ROWID` information is included as part of the `ChangeNotificationEventArgs` or not
OracleXmlCommandType Enumeration	No	-	The `OracleXmlCommandType` enumeration specifies the values that are allowed for the `OracleXmlCommandType` property of the `OracleCommand` class.

Oracle.DataAccess.Types and Oracle.ManagedDataAccess.Types Namespace s

The Oracle.DataAccess.Types and Oracle.ManagedDataAccess.Types namespaces provides classes, structures, and exceptions for Oracle native types that can be used with Oracle Data Provider for .NET.

Oracle.DataAccess.Types and Oracle.ManagedDataAccess.Types Structures

Table 1-3 lists the type structures.

Table 1-3 Oracle.DataAccess.Types and Oracle.ManagedDataAccess.Types Structures

Structure	Description
OracleBinary Structure	The `OracleBinary` structure represents a variable-length stream of binary data.
OracleBoolean Structure	The `OracleBoolean` structure represents a logical value that is either `TRUE` or `FALSE`.
OracleDate Structure	The `OracleDate` structure represents the Oracle `DATE` data type.
OracleDecimal Structure	The `OracleDecimal` structure represents an Oracle `NUMBER` in the database or any Oracle numeric value.
OracleIntervalDS Structure	The `OracleIntervalDS` structure represents the Oracle `INTERVAL` `DAY` `TO` `SECOND` data type.
OracleIntervalYM Structure	The `OracleIntervalYM` structure represents the Oracle `INTERVAL` `YEAR` `TO` `MONTH` data type.
OracleString Structure	The `OracleString` structure represents a variable-length stream of characters.
OracleTimeStamp Structure	The `OracleTimeStamp` structure represents the Oracle `TimeStamp` data type.
OracleTimeStampLTZ Structure	The `OracleTimeStampLTZ` structure represents the Oracle `TIMESTAMP` `WITH` `LOCAL` `TIME` `ZONE` data type.
OracleTimeStampTZ Structure	The `OracleTimeStampTZ` structure represents the Oracle `TIMESTAMP` `WITH` `TIME` `ZONE` data type.

Oracle.DataAccess.Types and Oracle.ManagedDataAccess.Types Exceptions

Type Exceptions are thrown only by ODP.NET type structures. Table 1-4 lists the type exceptions.

Table 1-4 Oracle.DataAccess.Types and Oracle.ManagedDataAccess.Types Exceptions

Exception	Description
OracleTypeException Class	The `OracleTypeException` object is the base exception class for handling exceptions that occur in the ODP.NET Types classes.
OracleNullValueException Class	The `OracleNullValueException` represents an exception that is thrown when trying to access an ODP.NET Types structure that is `null`.
OracleTruncateException Class	The `OracleTruncateException` class represents an exception that is thrown when truncation in an ODP.NET Types class occurs.

Oracle.DataAccess.Types and Oracle.ManagedDataAccess.Types Classes

Table 1-5 lists the type classes.

Table 1-5 Oracle.DataAccess.Types and Oracle.ManagedDataAccess.Types Classes

Class	Supported in the ODP.NET, Managed Driver	Description
OracleArrayMappingAttribute Class	No	The `OracleArrayMappingAttribute` class is required to mark a custom class field or property with information that ODP.NET uses when a custom type represents an Oracle Collection type.
OracleBFile Class	-	An `OracleBFile` is an object that has a reference to `BFILE` data. It provides methods for performing operations on `BFILE` objects.
OracleBlob Class	-	An `OracleBlob` object is an object that has a reference to `BLOB` data. It provides methods for performing operations on `BLOB` objects.
OracleClob Class	-	An `OracleClob` is an object that has a reference to `CLOB` data. It provides methods for performing operations on `CLOB` objects.
OracleCustomTypeMappingAttribute Class	No	The `OracleCustomTypeMappingAttribute` class is used to mark a custom type factory class or struct with information that is used by ODP.NET when a custom type is used to represent an Oracle UDT.
OracleObjectMappingAttribute Class	No	The `OracleObjectMappingAttribute` class marks custom class fields or properties with information that ODP.NET uses when a custom type represents an Oracle Object type.
OracleRef Class	No	An `OracleRef` instance represents an Oracle `REF`, which references a persistent, standalone, referenceable object that resides in the database. The `OracleRef` object provides methods to insert, update, and delete the Oracle `REF`.
OracleRefCursor Class	-	An `OracleRefCursor` object represents an Oracle `REF` `CURSOR`.
OracleUdt Class	No	The `OracleUdt` class defines static methods that are used when converting between Custom Types and Oracle UDTs and vice-versa.
OracleXmlStream Class	No	An `OracleXmlStream` object represents a sequential read-only stream of XML data stored in an `OracleXmlType` object.
OracleXmlType Class	No	An `OracleXmlType` object represents an Oracle `XmlType` instance.

Oracle.DataAccess.Types and Oracle.ManagedDataAccess.Types Interfaces

Table 1-6 lists the type interfaces.

Table 1-6 Oracle.DataAccess.Types and Oracle.ManagedDataAccess.Types Interfaces

Interface	Supported in the ODP.NET, Managed Driver	Description
IOracleArrayTypeFactory Interface	No	The `IOracleArrayTypeFactory` interface is used by ODP.NET to create arrays that represent Oracle Collections.
IOracleCustomType Interface	No	`IOracleCustomType` is an interface for converting between a Custom Type and an Oracle Object or Collection Type.
IOracleCustomTypeFactory Interface	No	The `IOracleCustomTypeFactory` interface is used by ODP.NET to create custom objects that represent Oracle Objects or Collections.
INullable Interface	-	The `INullable` interface is used to determine whether or not an ODP.NET type has a NULL value.

Oracle.DataAccess.Types and Oracle.ManagedDataAccess.Types Enumerations

Table 1-7 lists the type enumerations.

Table 1-7 Oracle.DataAccess.Types and Oracle.ManagedDataAccess.Types Enumerations

Enumeration	Supported in the ODP.NET, Managed Driver	Description
OracleUdtFetchOption Enumeration	No	`OracleUdtFetchOption` enumeration values specify how to retrieve a copy of the referenceable object.
OracleUdtStatus Enumeration	No	`OracleUdtStatus` enumeration values specify the status of an object attribute or collection element. An object attribute or a collection element can be a valid value or a null value.