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

OracleLob.CopyTo Метод

  • Ссылка

Определение

Пространство имен:
System.Data.OracleClient
Сборка:
System.Data.OracleClient.dll

Копирует из данного объекта OracleLob в объект назначения — OracleLob.

Перегрузки

CopyTo(OracleLob)

Копирует из данного объекта OracleLob в объект назначения — OracleLob.
CopyTo(OracleLob, Int64)

Копирование из данного объекта OracleLob в объект назначения — OracleLob с указанным объемом данных.
CopyTo(Int64, OracleLob, Int64, Int64)

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

CopyTo(OracleLob)

Копирует из данного объекта OracleLob в объект назначения — OracleLob.

public:
 long CopyTo(System::Data::OracleClient::OracleLob ^ destination);
public long CopyTo (System.Data.OracleClient.OracleLob destination);
member this.CopyTo : System.Data.OracleClient.OracleLob -> int64
override this.CopyTo : System.Data.OracleClient.OracleLob -> int64
Public Function CopyTo (destination As OracleLob) As Long

Параметры

destination
OracleLob

OracleLob — объект назначения.

Возвращаемое значение

Int64

Скопированное число байт. В это число не входят дополненные нулевые байты.

Исключения

ArgumentNullException

Значение OracleLob, указанное в параметре destination, является пустым.

InvalidOperationException

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

OracleException

Произошла ошибка Oracle.

Комментарии

Базовые типы данных всегда должны быть одинаковыми. Например, при копировании из NClob, назначением OracleLob также должен быть NClob.

Если целевое смещение находится за пределами конечной точки назначения LOB, то расширяется объект , LOB в который копируются данные. Пространство между концом LOB и смещением назначения за пределами конца заполняется нулями для BLOB типов данных и пробелами для CLOB типов данных и NCLOB .

Чтобы выполнить запись в LOB, необходимо получить LOB с помощью предложения FOR UPDATE в инструкции SQL SELECT и запустить локальную транзакцию.

Примечание

В этом выпуске операция записи в доступную только LOB для чтения операция может завершиться успешно, но не обновить LOB на сервере. Однако в этом случае локальная копия будет обновлена LOB . Поэтому последующие операции чтения объекта OracleLob могут возвращать результаты операции записи.

Метод CopyTo не очищает содержимое места назначения OracleLob перед выполнением операции копирования.

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

CopyTo(OracleLob, Int64)

Копирование из данного объекта OracleLob в объект назначения — OracleLob с указанным объемом данных.

public:
 long CopyTo(System::Data::OracleClient::OracleLob ^ destination, long destinationOffset);
public long CopyTo (System.Data.OracleClient.OracleLob destination, long destinationOffset);
member this.CopyTo : System.Data.OracleClient.OracleLob * int64 -> int64
override this.CopyTo : System.Data.OracleClient.OracleLob * int64 -> int64
Public Function CopyTo (destination As OracleLob, destinationOffset As Long) As Long

Параметры

destination
OracleLob

OracleLob — объект назначения.

destinationOffset
Int64

Смещение, в которое выполняется копирование. Для данных типа CLOB и NCLOB это количество байтов должно быть четным.

Возвращаемое значение

Int64

Скопированное число байт. В это число не входят дополненные нулевые байты.

Исключения

ArgumentNullException

Значение OracleLob, указанное в параметре destination, является полным.

ArgumentOutOfRangeException

Значение, указанное в параметре destinationOffset, меньше нуля или больше 4 гигабайт.

-или-

Значение, указанное в параметре destinationOffset для типа данных CLOB или NCLOB, не является четным.

-или-

Необходимо указать типы данных CLOB и NCLOB с четным количеством байтов.

InvalidOperationException

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

OracleException

Произошла ошибка Oracle.

Комментарии

Базовые типы данных всегда должны быть одинаковыми. Например, при копировании из NClob, назначением OracleLob также должен быть NClob.

Если целевое смещение находится за пределами конечной точки назначения LOB, то расширяется объект , LOB в который копируются данные. Пространство между концом LOB и конечным смещением за пределами конца заполняется нулями для BLOB типов данных и пробелами для CLOB типов данных и NCLOB .

Чтобы выполнить запись в LOB, необходимо получить LOB с помощью предложения FOR UPDATE в инструкции SQL SELECT и запустить локальную транзакцию.

Примечание

В этом выпуске операция записи в доступную только LOB для чтения операцию может завершиться успешно, но не обновляет LOB на сервере. Однако в этом случае локальная копия LOB обновляется. Поэтому последующие операции чтения объекта OracleLob могут возвращать результаты операции записи.

Метод CopyTo не очищает содержимое места назначения OracleLob перед выполнением операции копирования.

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

CopyTo(Int64, OracleLob, Int64, Int64)

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

public:
 long CopyTo(long sourceOffset, System::Data::OracleClient::OracleLob ^ destination, long destinationOffset, long amount);
public long CopyTo (long sourceOffset, System.Data.OracleClient.OracleLob destination, long destinationOffset, long amount);
member this.CopyTo : int64 * System.Data.OracleClient.OracleLob * int64 * int64 -> int64
override this.CopyTo : int64 * System.Data.OracleClient.OracleLob * int64 * int64 -> int64
Public Function CopyTo (sourceOffset As Long, destination As OracleLob, destinationOffset As Long, amount As Long) As Long

Параметры

sourceOffset
Int64

Смещение, из которого выполняется копирование. Для типов данных CLOB и NCLOB это число должно быть четным.

destination
OracleLob

Назначение OracleLobSystem.Data.OracleClient.

destinationOffset
Int64

Конечное смещение, в которое выполняется копирование. Для типов данных CLOB и NCLOB это число должно быть четным.

amount
Int64

Количество данных, которое необходимо скопировать, в байтах. Для типов данных CLOB и NCLOB это число должно быть четным.

Возвращаемое значение

Int64

Скопированное число байт. В это число не входят дополненные нулевые байты.

Исключения

ArgumentNullException

Значение OracleLob, указанное в параметре destination, является полным.

ArgumentOutOfRangeException

Значение, заданное для параметра amount, sourceOffset или destinationOffset меньше нуля или больше 4 гигабайт.

-или-

Значение, заданное для параметра amount, sourceOffset или destinationOffset для данных типа CLOB или NCLOB не является четным.

InvalidOperationException

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

OracleException

Произошла ошибка Oracle.

Комментарии

Базовые типы данных всегда должны быть одинаковыми. Например, при копировании из NClob, назначением OracleLob также должен быть NClob.

Если целевое смещение находится за пределами конечной точки назначения LOB, то расширяется объект , LOB в который копируются данные. Пространство между концом LOB и конечным смещением за пределами конца заполняется нулями для BLOB типов данных и пробелами для CLOB типов данных и NCLOB .

Чтобы выполнить запись в LOB, необходимо получить LOB с помощью предложения FOR UPDATE в инструкции SQL SELECT и запустить локальную транзакцию.

Примечание

В этом выпуске операция записи в доступную только LOB для чтения операцию может завершиться успешно, но не обновляет LOB на сервере. Однако в этом случае локальная копия LOB обновляется. Поэтому последующие операции чтения объекта OracleLob могут возвращать результаты операции записи.

Метод CopyTo не очищает содержимое места назначения OracleLob перед выполнением операции копирования.

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