OracleLob Classe

Definição

Namespace:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Representa um tipo de dados (LOB) binário de objeto grande armazenado em um servidor Oracle. Essa classe não pode ser herdada.

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

Herança

Object

MarshalByRefObject

Stream

OracleLob

Implementações

INullable ICloneable IDisposable

Comentários

Um OracleLob difere de um OracleBFile em que os dados são armazenados no servidor em vez de em um arquivo físico no sistema operacional. Ele também pode ser um objeto de leitura/gravação, ao contrário de um OracleBFile, que é sempre somente leitura.

Um OracleLob pode ser um desses OracleType tipos de dados.

Tipo de dados OracleType	Descrição
Blob	Um tipo de dados Oracle BLOB que contém dados binários com um tamanho máximo de 4 GB (gigabytes). Isso mapeia para um Array do tipo Byte.
Clob	Um tipo de dados Oracle CLOB que contém dados de caracteres, com base no conjunto de caracteres padrão no servidor, com um tamanho máximo de 4 GB. Isso é mapeado para String.
NClob	Um tipo de dados Oracle NCLOB que contém dados de caracteres, com base no conjunto de caracteres nacional no servidor com um tamanho máximo de 4 GB. Isso é mapeado para String.

Um desenvolvedor de aplicativos .NET pode recuperar os valores do Oracle LOB em tipos de dados .NET básicos, como Array do tipo Byte e Stringou do tipo de dados especializado OracleLob . A OracleLob classe dá suporte à leitura e gravação de dados no Oracle LOB no banco de dados Oracle.

Veja a seguir as características main de um OracleLob tipo de dados que as distinguem dos tipos de dados básicos do .NET:

• Depois de recuperar o LOB valor oracle do banco de dados Oracle para a OracleLob classe , você pode alterar os LOB dados em uma transação aberta e suas alterações são refletidas diretamente no banco de dados. Se você recuperar o valor oracle LOB em um Array do tipo Byte ou String e atualizar essas matrizes, suas alterações não serão refletidas no banco de dados.

• Quando você usa a OracleLob classe para acessar uma parte de um LOB valor, somente essa parte é passada do banco de dados Oracle para o cliente. Quando você usa o GetChars método para acessar uma parte de um LOB valor, todo o conteúdo do valor é passado do banco de dados Oracle para o cliente.

Para obter um OracleLob objeto , chame o GetOracleLob método .

Você pode construir um OracleLob que seja NULL usando este formato:

OracleLob myLob = OracleLob.Null;  

Dim myLob As OracleLob = OracleLob.Null

Essa técnica é usada principalmente para testar se um LOB retornado do servidor é NULL, como ilustra este exemplo:

if (myLob == OracleLob.Null)  

If (myLob = OracleLob.Null) Then

Um NULL LOB se comporta de forma semelhante a um byte LOB zero no que Read é bem-sucedido e sempre retorna zero bytes.

A seleção de uma LOB coluna que contém um valor nulo retorna Null.

Você deve iniciar uma transação antes de obter um temporário LOB. Caso contrário, o OracleDataReader poderá falhar ao obter dados posteriormente.

Você também pode abrir um temporário LOB no Oracle chamando o DBMS_LOB. Procedimento armazenado do sistema CREATETEMPORARY e associação de um LOB parâmetro de saída. No lado do cliente, um temporário LOB se comporta como um baseado em LOBtabela. Por exemplo, para atualizar o temporário LOB, ele deve ser colocado em uma transação.

O exemplo a seguir demonstra como abrir um temporário 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(); 

Observação

O método herdado falhará WriteByte se usado com dados de caractere e um InvalidOperationException for gerado. Use o método Write em seu lugar.

Os s temporários LOBsão fechados somente quando a conexão é fechada, mas com o pooling e sob carga, LOBos temporários não fecham. Isso pode ser resolvido descartando o temporário LOB, invocando tempLob.Dispose().

Campos

Null	Representa um objeto OracleLob nulo.

Propriedades

CanRead	Obtém um valor que indica se o fluxo LOB pode ser lido.
CanSeek	Obtém um valor que indica se as operações de busca progressiva ou regressiva podem ser executadas.
CanTimeout	Obtém um valor que determina se o fluxo atual pode atingir o tempo limite. (Herdado de Stream)
CanWrite	Sempre retorna true, independentemente se o LOB oferece suporte à criação ou não.
ChunkSize	Obtém um valor que indica o número mínimo de bytes a serem recuperados ou enviados ao servidor durante uma operação de leitura/gravação.
Connection	Obtém o OracleConnection usado por essa instância do OracleLob.
IsBatched	Obtém um valor que indica se um aplicativo chamou o método BeginBatch().
IsNull	Obtém um valor que indica se o OracleLob é um fluxo Null.
IsTemporary	Obtém um valor que indica se o OracleLob é um LOB temporário.
Length	Obtém um valor que retorna o tamanho do OracleLob.
LobType	Obtém um valor que retorna o tipo de dados do LOB.
Position	Obtém a posição de leitura atual no fluxo OracleLob.
ReadTimeout	Obtém ou define um valor, em milissegundos, que determina por quanto tempo o fluxo tentará realizar a leitura antes do tempo limite. (Herdado de Stream)
Value	Obtém o valor do fluxo de Common Language Runtime equivalente do valor subjacente.
WriteTimeout	Obtém ou define um valor, em milissegundos, que determina por quanto tempo o fluxo tentará realizar a gravação antes do tempo limite. (Herdado de Stream)

Métodos

Append(OracleLob)	Acrescenta dados do LOB especificado no LOB atual.
BeginBatch()	Impede que gatilhos do lado do servidor disparem ao executar várias operações de leitura.
BeginBatch(OracleLobOpenMode)	Impede que gatilhos do lado do servidor disparem ao executar várias operações de leitura e gravação no modo de acesso especificado.
BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)	Inicia uma operação de leitura assíncrona. (Considere o uso de ReadAsync(Byte[], Int32, Int32) em seu lugar.) (Herdado de Stream)
BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)	Inicia uma operação de gravação assíncrona. (Considere o uso de WriteAsync(Byte[], Int32, Int32) em seu lugar.) (Herdado de Stream)
Clone()	Cria um novo objeto OracleLob que faz referência ao mesmo Oracle LOB que o objeto OracleLob original.
Close()	Fecha o fluxo atual e libera todos os recursos (como soquetes e identificadores de arquivos) associados ao fluxo atual. Em vez de chamar esse método, verifique se o fluxo é descartado corretamente. (Herdado de Stream)
CopyTo(Int64, OracleLob, Int64, Int64)	Copia deste OracleLob para um destino OracleLob com a quantidade especificada de dados e o deslocamento de origem.
CopyTo(OracleLob)	Copia deste OracleLob para um destino OracleLob.
CopyTo(OracleLob, Int64)	Copia deste OracleLob para um destino OracleLob com a quantidade de dados especificada.
CopyTo(Stream)	Lê os bytes do fluxo atual e os grava em outro fluxo. Ambas as posições de fluxo são avançadas pelo número de bytes copiados. (Herdado de Stream)
CopyTo(Stream, Int32)	Lê os bytes do fluxo atual e os grava em outro fluxo usando um tamanho do buffer especificado. Ambas as posições de fluxo são avançadas pelo número de bytes copiados. (Herdado de Stream)
CopyToAsync(Stream)	Lê de forma assíncrona os bytes do fluxo atual e os grava em outro fluxo. Ambas as posições de fluxo são avançadas pelo número de bytes copiados. (Herdado de Stream)
CopyToAsync(Stream, CancellationToken)	Lê de forma assíncrona os bytes do fluxo atual e os grava em outro fluxo usando um token de cancelamento especificado. Ambas as posições de fluxo são avançadas pelo número de bytes copiados. (Herdado de Stream)
CopyToAsync(Stream, Int32)	Lê de maneira assíncrona os bytes do fluxo atual e os grava em outro fluxo usando um tamanho do buffer especificado. Ambas as posições de fluxo são avançadas pelo número de bytes copiados. (Herdado de Stream)
CopyToAsync(Stream, Int32, CancellationToken)	Lê de forma assíncrona os bytes do fluxo atual e os grava em outro fluxo usando um tamanho do buffer especificado e um token de cancelamento. Ambas as posições de fluxo são avançadas pelo número de bytes copiados. (Herdado de Stream)
CreateObjRef(Type)	Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
CreateWaitHandle()	Obsoleto. Aloca um objeto WaitHandle. (Herdado de Stream)
Dispose()	Libera todos os recursos usados pelo Stream. (Herdado de Stream)
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo Stream e opcionalmente libera os recursos gerenciados. (Herdado de Stream)
DisposeAsync()	Libera de forma assíncrona os recursos não gerenciados usados pelo Stream. (Herdado de Stream)
EndBatch()	Permite que gatilhos do lado do servidor continuem a disparar depois de executar várias operações de gravação.
EndRead(IAsyncResult)	Espera a leitura assíncrona pendente ser concluída. (Considere o uso de ReadAsync(Byte[], Int32, Int32) em seu lugar.) (Herdado de Stream)
EndWrite(IAsyncResult)	Encerra uma operação de gravação assíncrona. (Considere o uso de WriteAsync(Byte[], Int32, Int32) em seu lugar.) (Herdado de Stream)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
Erase()	Apaga todos os dados deste OracleLob.
Erase(Int64, Int64)	Apaga a quantidade especificada de dados neste OracleLob.
Flush()	Sem suporte no momento.
FlushAsync()	Limpa de forma assíncrona todos os buffers nesse fluxo e faz com que os dados armazenados em buffer sejam gravados no dispositivo subjacente. (Herdado de Stream)
FlushAsync(CancellationToken)	Limpa todos os buffers nesse fluxo de forma assíncrona, faz com que os dados armazenados em buffer sejam gravados no dispositivo subjacente e monitora as solicitações de cancelamento. (Herdado de Stream)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLifetimeService()	Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InitializeLifetimeService()	Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
ObjectInvariant()	Obsoleto. Oferece suporte a um Contract. (Herdado de Stream)
Read(Byte[], Int32, Int32)	Lê uma sequência de bytes do fluxo OracleLob atual de forma assíncrona e avança a posição no fluxo até o número de bytes lidos.
Read(Span<Byte>)	Quando for substituído em uma classe derivada, lê uma sequência de bytes do fluxo atual e avança a posição dentro do fluxo até o número de bytes lidos. (Herdado de Stream)
ReadAsync(Byte[], Int32, Int32)	Lê uma sequência de bytes do fluxo atual de forma assíncrona e avança a posição no fluxo até o número de bytes lidos. (Herdado de Stream)
ReadAsync(Byte[], Int32, Int32, CancellationToken)	Lê de forma assíncrona uma sequência de bytes do fluxo atual, avança a posição no fluxo até o número de bytes lidos e monitora as solicitações de cancelamento. (Herdado de Stream)
ReadAsync(Memory<Byte>, CancellationToken)	Lê de forma assíncrona uma sequência de bytes do fluxo atual, avança a posição no fluxo até o número de bytes lidos e monitora as solicitações de cancelamento. (Herdado de Stream)
ReadAtLeast(Span<Byte>, Int32, Boolean)	Lê pelo menos um número mínimo de bytes do fluxo atual e avança a posição dentro do fluxo pelo número de bytes lidos. (Herdado de Stream)
ReadAtLeastAsync(Memory<Byte>, Int32, Boolean, CancellationToken)	Lê de forma assíncrona pelo menos um número mínimo de bytes do fluxo atual, avança a posição dentro do fluxo pelo número de bytes lidos e monitora solicitações de cancelamento. (Herdado de Stream)
ReadByte()	Lê um byte do fluxo e avança a posição no fluxo em um byte ou retorna -1 caso esteja no final do fluxo. (Herdado de Stream)
ReadExactly(Byte[], Int32, Int32)	Lê count o número de bytes do fluxo atual e avança a posição dentro do fluxo. (Herdado de Stream)
ReadExactly(Span<Byte>)	Lê bytes do fluxo atual e avança a posição dentro do fluxo até que o buffer seja preenchido. (Herdado de Stream)
ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken)	Lê count de forma assíncrona o número de bytes do fluxo atual, avança a posição dentro do fluxo e monitora as solicitações de cancelamento. (Herdado de Stream)
ReadExactlyAsync(Memory<Byte>, CancellationToken)	Lê bytes de forma assíncrona do fluxo atual, avança a posição dentro do fluxo até que o buffer seja preenchido e monitora solicitações de cancelamento. (Herdado de Stream)
Seek(Int64, SeekOrigin)	Define a posição no fluxo OracleLob atual.
SetLength(Int64)	Define o tamanho do fluxo OracleLob para um valor menor que o tamanho atual.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
Write(Byte[], Int32, Int32)	Grava assincronamente uma sequência de bytes no fluxo OracleLob atual e avança a posição atual dentro desse fluxo no número de bytes gravados.
Write(ReadOnlySpan<Byte>)	Quando for substituído em uma classe derivada, grava uma sequência de bytes no fluxo atual e avança a posição atual dentro desse fluxo até o número de bytes gravados. (Herdado de Stream)
WriteAsync(Byte[], Int32, Int32)	Grava assincronamente uma sequência de bytes no fluxo atual e avança a posição atual dentro desse fluxo no número de bytes gravados. (Herdado de Stream)
WriteAsync(Byte[], Int32, Int32, CancellationToken)	Grava uma sequência de bytes no fluxo atual assincronamente, avança a posição atual dentro desse fluxo pelo número de bytes gravados e monitora as solicitações de cancelamento. (Herdado de Stream)
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)	Grava uma sequência de bytes no fluxo atual assincronamente, avança a posição atual dentro desse fluxo pelo número de bytes gravados e monitora as solicitações de cancelamento. (Herdado de Stream)
WriteByte(Byte)	Grava um byte na posição atual no fluxo OracleLob e avança a posição dentro no fluxo em um byte.

Métodos de Extensão

CopyToAsync(Stream, PipeWriter, CancellationToken)

Lê de forma assíncrona os bytes do Stream e grava-os no PipeWriter especificado usando um token de cancelamento especificado.