OracleLob Класс

Определение

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

System.Data.OracleClient

Сборка:

System.Data.OracleClient.dll

Представляет двоичный тип данных больших объектов (LOB), хранящихся на сервере Oracle. Этот класс не наследуется.

public ref class OracleLob sealed : System::IO::Stream, ICloneable, System::Data::SqlTypes::INullable

public sealed class OracleLob : System.IO.Stream, ICloneable, System.Data.SqlTypes.INullable

type OracleLob = class
    inherit Stream
    interface ICloneable
    interface IDisposable
    interface INullable

Public NotInheritable Class OracleLob
Inherits Stream
Implements ICloneable, INullable

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

Object

MarshalByRefObject

Stream

OracleLob

Реализации

INullable ICloneable IDisposable

Комментарии

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

Может OracleLob быть одним из этих OracleType типов данных.

Тип данных OracleType	Описание
Blob	Тип данных Oracle BLOB , содержащий двоичные данные с максимальным размером 4 гигабайта (ГБ). Соответствует Array типа Byte.
Clob	Тип данных Oracle CLOB , содержащий символьные данные, основанный на кодировке по умолчанию, установленной на сервере, с максимальным размером 4 ГБ. Соответствует String.
NClob	Тип данных Oracle NCLOB , содержащий символьные данные на основе национального набора символов на сервере с максимальным размером 4 ГБ. Соответствует String.

Разработчик приложения .NET может извлекать значения Oracle LOB в базовые типы данных .NET, такие как Array тип Byte и String, или специализированный OracleLob тип данных. Класс OracleLob поддерживает чтение данных из oracle LOB в базе данных Oracle и их запись в нее.

Ниже приведены main характеристики OracleLob типа данных, которые отличают его от базовых типов данных .NET.

• После извлечения значения Oracle LOB из базы данных Oracle в OracleLob класс можно изменить LOB данные в открытой транзакции, и ваши изменения будут отражены непосредственно в базе данных. Если вы извлекаете значение Oracle LOB в Array тип Byte или String и обновляете эти массивы, изменения не будут отражены в базе данных.

• При использовании OracleLob класса для доступа к фрагменту LOB значения клиенту передается только этот блок из базы данных Oracle. При использовании GetChars метода для доступа к фрагменту LOB значения все содержимое значения передается из базы данных Oracle клиенту.

Чтобы получить OracleLob объект , вызовите GetOracleLob метод .

Можно создать объект со значением OracleLob NULL, используя следующий формат:

OracleLob myLob = OracleLob.Null;  

Dim myLob As OracleLob = OracleLob.Null

Этот метод используется в основном для проверки того, имеет ли возвращенный LOB с сервера объект NULL, как показано в этом примере:

if (myLob == OracleLob.Null)  

If (myLob = OracleLob.Null) Then

Значение NULL LOB ведет себя аналогично нулевому байту LOB в , который Read выполняется успешно и всегда возвращает ноль байтов.

При выборе столбца LOB , содержащего значение NULL, возвращается Nullзначение .

Необходимо начать транзакцию перед получением временного LOB. В противном OracleDataReader случае может не получить данные позже.

Вы также можете открыть временный LOB объект в Oracle, вызвав DBMS_LOB. Системная хранимая процедура CREATETEMPORARY и привязка выходного LOB параметра. На стороне клиента временный LOB объект ведет себя как табличный LOB. Например, чтобы обновить временный LOB, он должен быть заключен в транзакцию.

В следующем примере показано, как открыть временный LOBобъект :

var connection = new OracleConnection("server=MyServer; integrated security=yes;");  
connection.Open();  
OracleTransaction transaction = connection.BeginTransaction();  
OracleCommand command = connection.CreateCommand();  
command.Transaction = transaction;  
command.CommandText = "declare xx blob; begin dbms_lob.createtemporary(xx, false, 0); :tempblob := xx; end;";  
command.Parameters.Add(new OracleParameter("tempblob", OracleType.Blob)).Direction = ParameterDirection.Output;  
command.ExecuteNonQuery();  
var tempLob = (OracleLob)command.Parameters[0].Value;  
var tempbuff = new byte[10000];  
tempLob.BeginBatch(OracleLobOpenMode.ReadWrite);  
tempLob.Write(tempbuff,0,tempbuff.Length);  
tempLob.EndBatch();  
command.Parameters.Clear();  
command.CommandText = "MyTable.MyProc";  
command.CommandType = CommandType.StoredProcedure;    
command.Parameters.Add(new OracleParameter("ImportDoc", OracleType.Blob)).Value = tempLob;  
command.ExecuteNonQuery();  
transaction.Commit();  
connection.Close(); 

Примечание

Унаследованный WriteByte метод завершается ошибкой при использовании с символьными InvalidOperationException данными и создается исключение . Вместо этого рекомендуется использовать метод Write.

Временные LOBзакрыты только при закрытии подключения, но при пуле и под нагрузкой временные LOBне закрываются. Это можно устранить, ликвидируя временный LOB, вызвав tempLob.Dispose().

Поля

Null	Представляет пустой объект OracleLob.

Свойства

CanRead	Получает значение, определяющее возможность чтения потока LOB.
CanSeek	Получает значение, показывающее, могут ли быть выполнены операции прямого и обратного поиска.
CanTimeout	Возвращает значение, которое показывает, может ли для данного потока истечь время ожидания. (Унаследовано от Stream)
CanWrite	Всегда возвращает логическое значение ИСТИНА, независимо от того, поддерживает ли LOB запись или нет.
ChunkSize	Получает значение, определяющее минимальное количество байтов, которое необходимо извлечь с сервера или отправить на сервер при выполнении операции чтения или записи.
Connection	Получает OracleConnection, используемый данным экземпляром OracleLob.
IsBatched	Получает значение, определяющее, вызвало ли приложение метод BeginBatch().
IsNull	Получает значение, определяющее, является ли OracleLob потоком Null.
IsTemporary	Получает значение, определяющее, является ли OracleLob временным LOB.
Length	Получает значение, возвращающее размер OracleLob.
LobType	Получает значение, возвращающее тип данных LOB.
Position	Получает текущую позицию чтения в потоке OracleLob.
ReadTimeout	Возвращает или задает значение в миллисекундах, определяющее период времени, отведенного потоку на выполнение операции чтения. (Унаследовано от Stream)
Value	Получает эквивалент общеязыковой среды выполнения потока для базового значения.
WriteTimeout	Возвращает или задает значение в миллисекундах, определяющее период времени, отведенного потоку на выполнение операции записи. (Унаследовано от Stream)

Методы

Append(OracleLob)	Добавляет данные из указанного LOB в текущий LOB.
BeginBatch()	Предотвращает срабатывание серверных триггеров при выполнении нескольких операций чтения.
BeginBatch(OracleLobOpenMode)	Предотвращает срабатывание серверных триггеров при выполнении нескольких операций чтения и записи в указанном режиме доступа.
BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)	Начинает операцию асинхронного чтения. (Рекомендуется использовать ReadAsync(Byte[], Int32, Int32).) (Унаследовано от Stream)
BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)	Начинает операцию асинхронной записи. (Рекомендуется использовать WriteAsync(Byte[], Int32, Int32).) (Унаследовано от Stream)
Clone()	Создает новый объект OracleLob, который ссылается на тот же LOB Oracle, что и исходный объект OracleLob.
Close()	Закрывает текущий поток и отключает все ресурсы (например, сокеты и файловые дескрипторы), связанные с текущим потоком. Вместо вызова данного метода, убедитесь в том, что поток надлежащим образом ликвидирован. (Унаследовано от Stream)
CopyTo(Int64, OracleLob, Int64, Int64)	Копирует из данного объекта OracleLob в OracleLob, являющийся объектом назначения, с указанным объемом данных и смещением источника.
CopyTo(OracleLob)	Копирует из данного объекта OracleLob в объект назначения — OracleLob.
CopyTo(OracleLob, Int64)	Копирование из данного объекта OracleLob в объект назначения — OracleLob с указанным объемом данных.
CopyTo(Stream)	Считывает байты из текущего потока и записывает их в другой поток. Обе позиции потоков перемещаются по количеству скопированных байтов. (Унаследовано от Stream)
CopyTo(Stream, Int32)	Считывает байты из текущего потока и записывает их в другой поток, используя указанный размер буфера. Обе позиции потоков перемещаются по количеству скопированных байтов. (Унаследовано от Stream)
CopyToAsync(Stream)	Асинхронно считывает байты из текущего потока и записывает их в другой поток. Обе позиции потоков перемещаются по количеству скопированных байтов. (Унаследовано от Stream)
CopyToAsync(Stream, CancellationToken)	Асинхронно считывает байты из текущего потока и записывает их в другой поток, используя указанный токен отмены. Обе позиции потоков перемещаются по количеству скопированных байтов. (Унаследовано от Stream)
CopyToAsync(Stream, Int32)	Асинхронно считывает байты из текущего потока и записывает их в другой поток, используя указанный размер буфера. Обе позиции потоков перемещаются по количеству скопированных байтов. (Унаследовано от Stream)
CopyToAsync(Stream, Int32, CancellationToken)	Асинхронно считывает байты из текущего потока и записывает их в другой поток, используя указанный размер буфера и токен отмены. Обе позиции потоков перемещаются по количеству скопированных байтов. (Унаследовано от Stream)
CreateObjRef(Type)	Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject)
CreateWaitHandle()	Устаревшие.. Выделяет объект WaitHandle. (Унаследовано от Stream)
Dispose()	Освобождает все ресурсы, занятые модулем Stream. (Унаследовано от Stream)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые объектом Stream, а при необходимости освобождает также управляемые ресурсы. (Унаследовано от Stream)
DisposeAsync()	Асинхронно освобождает неуправляемые ресурсы, используемые классом Stream. (Унаследовано от Stream)
EndBatch()	Позволяет серверным триггерам возобновить работу после выполнения нескольких операций записи.
EndRead(IAsyncResult)	Ожидает завершения отложенного асинхронного чтения. (Рекомендуется использовать ReadAsync(Byte[], Int32, Int32).) (Унаследовано от Stream)
EndWrite(IAsyncResult)	Заканчивает операцию асинхронной записи. (Рекомендуется использовать WriteAsync(Byte[], Int32, Int32).) (Унаследовано от Stream)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
Erase()	Удаляет все данные из этого OracleLob.
Erase(Int64, Int64)	Удаляет заданный объем данных из этого OracleLob.
Flush()	Не поддерживается в текущей версии.
FlushAsync()	Асинхронно очищает все буферы для этого потока и вызывает запись всех буферизованных данных в базовое устройство. (Унаследовано от Stream)
FlushAsync(CancellationToken)	Асинхронно очищает все буферы данного потока, вызывает запись буферизованных данных в базовое устройство и отслеживает запросы отмены. (Унаследовано от Stream)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetLifetimeService()	Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра. (Унаследовано от MarshalByRefObject)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
InitializeLifetimeService()	Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
MemberwiseClone(Boolean)	Создает неполную копию текущего объекта MarshalByRefObject. (Унаследовано от MarshalByRefObject)
ObjectInvariant()	Устаревшие.. Обеспечивает поддержку для Contract. (Унаследовано от Stream)
Read(Byte[], Int32, Int32)	Считывает последовательность байтов из текущего потока OracleLob и перемещает позицию внутри потока на число считанных байтов.
Read(Span<Byte>)	При переопределении в производном классе считывает последовательность байтов из текущего потока и перемещает позицию в потоке на число считанных байтов. (Унаследовано от Stream)
ReadAsync(Byte[], Int32, Int32)	Асинхронно считывает последовательность байтов из текущего потока и перемещает позицию внутри потока на число считанных байтов. (Унаследовано от Stream)
ReadAsync(Byte[], Int32, Int32, CancellationToken)	Асинхронно считывает последовательность байтов из текущего потока, перемещает позицию в потоке на число считанных байтов и отслеживает запросы отмены. (Унаследовано от Stream)
ReadAsync(Memory<Byte>, CancellationToken)	Асинхронно считывает последовательность байтов из текущего потока, перемещает позицию в потоке на число считанных байтов и отслеживает запросы отмены. (Унаследовано от Stream)
ReadAtLeast(Span<Byte>, Int32, Boolean)	Считывает по крайней мере минимальное количество байтов из текущего потока и перемещает позицию в потоке на число прочитанных байтов. (Унаследовано от Stream)
ReadAtLeastAsync(Memory<Byte>, Int32, Boolean, CancellationToken)	Асинхронно считывает по крайней мере минимальное количество байтов из текущего потока, перемещает позицию в потоке на число прочитанных байтов и отслеживает запросы отмены. (Унаследовано от Stream)
ReadByte()	Считывает байт из потока и перемещает позицию в потоке на один байт или возвращает -1, если достигнут конец потока. (Унаследовано от Stream)
ReadExactly(Byte[], Int32, Int32)	Считывает count количество байтов из текущего потока и перемещает позицию в потоке. (Унаследовано от Stream)
ReadExactly(Span<Byte>)	Считывает байты из текущего потока и перемещает позицию в потоке buffer до заполнения . (Унаследовано от Stream)
ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken)	Асинхронно считывает count количество байтов из текущего потока, перемещает позицию в потоке и отслеживает запросы отмены. (Унаследовано от Stream)
ReadExactlyAsync(Memory<Byte>, CancellationToken)	Асинхронно считывает байты из текущего потока, перемещает позицию в потоке buffer до заполнения и отслеживает запросы отмены. (Унаследовано от Stream)
Seek(Int64, SeekOrigin)	Задает позицию в текущем потоке OracleLob.
SetLength(Int64)	Задает длину потока OracleLob меньше текущей длины.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
Write(Byte[], Int32, Int32)	Записывает последовательность байтов в текущий поток OracleLob и перемещает текущую позицию внутри потока на число записанных байтов.
Write(ReadOnlySpan<Byte>)	При переопределении в производном классе записывает последовательность байтов в текущий поток и перемещает текущую позицию в нем вперед на число записанных байтов. (Унаследовано от Stream)
WriteAsync(Byte[], Int32, Int32)	Асинхронно записывает последовательность байтов в текущий поток и перемещает текущую позицию внутри потока на число записанных байтов. (Унаследовано от Stream)
WriteAsync(Byte[], Int32, Int32, CancellationToken)	Асинхронно записывает последовательность байтов в текущий поток, перемещает текущую позицию внутри потока на число записанных байтов и отслеживает запросы отмены. (Унаследовано от Stream)
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)	Асинхронно записывает последовательность байтов в текущий поток, перемещает текущую позицию внутри потока на число записанных байтов и отслеживает запросы отмены. (Унаследовано от Stream)
WriteByte(Byte)	Записывает байт в текущее положение в потоке OracleLob, при этом позиция в потоке перемещается вперед на один байт.