OracleBFile Clase

Definición

Espacio de nombres:

System.Data.OracleClient

Ensamblado:

System.Data.OracleClient.dll

Representa un objeto OracleBFile administrado diseñado para funcionar con el tipo de datos BFILE de Oracle. Esta clase no puede heredarse.

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

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

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

Public NotInheritable Class OracleBFile
Inherits Stream
Implements ICloneable, INullable

Herencia

Object

MarshalByRefObject

Stream

OracleBFile

Implementaciones

INullable ICloneable IDisposable

Comentarios

El tipo de datos de Oracle BFILE es un tipo de datos de Oracle LOB que contiene una referencia a datos binarios con un tamaño máximo de 4 gigabytes. BFILE Oracle difiere de otros tipos de datos de Oracle LOB en que sus datos se almacenan en un archivo físico en el sistema operativo en lugar de en el servidor. Tenga en cuenta que el BFILE tipo de datos proporciona acceso de solo lectura a los datos. Por lo tanto, no se admiten métodos orientados a escritura heredados de la Stream clase .

Otras características de un BFILE tipo de datos que lo distinguen de un LOB tipo de datos son:

• contiene datos no estructurados.

• admite el troceo en el servidor.

• utiliza semántica de copia de referencia. Por ejemplo, si realiza una operación de copia en , BFILEsolo se copia el BFILE localizador (que es una referencia al archivo). Los datos del archivo no se copian.

El BFILE tipo de datos debe usarse para hacer referencia a LOBs que tienen un tamaño grande y, por lo tanto, no resulta práctico almacenarlos en la base de datos. Hay sobrecarga de cliente, servidor y comunicación para usar un BFILE tipo de datos en comparación con el LOB tipo de datos. Es más eficaz acceder a si BFILE solo necesita obtener una pequeña cantidad de datos. Es más eficaz acceder a los residentes LOBde la base de datos si necesita obtener todo el objeto.

Cada objeto distinto de NULL OracleBFile está asociado a dos entidades que definen la ubicación del archivo físico subyacente:

• Un objeto DIRECTORY de Oracle, que es un alias de base de datos de un directorio del sistema de archivos, y

• el nombre de archivo del archivo físico subyacente, que se encuentra en el directorio asociado con el objeto DIRECTORY.

Después de crear un BFILE , puede recuperar su localizador en forma de un OracleBFile objeto mediante los ExecuteReader métodos o ExecuteScalar .

Para obtener un OracleBFile objeto, llame al GetOracleBFile método .

El archivo físico al que está asociado un OracleBFile objeto no necesita existir hasta que intente acceder a él. Una aplicación puede enlazar un OracleBFile objeto a un archivo inexistente, crear el archivo físico en la ubicación esperada y, a continuación, llamar a Read.

Cualquier intento de acceder a un objeto cerrado OracleBFile mediante los Read métodos o Seek vuelve a abrir una OracleBFile secuencia automáticamente.

En el siguiente ejemplo de C# se muestra cómo se puede crear un BFILE objeto en una tabla de Oracle y, a continuación, recuperarlo en forma de objeto OracleBFile . En el ejemplo se muestra el uso del OracleDataReader objeto y los OracleBFileSeek métodos y Read .

private void GetOracleBFile(string connectionString)
{
    //Create and open the connection.
    using (OracleConnection connection = new OracleConnection(connectionString))
    {
        connection.Open();

        //Create and execute the commands.
        OracleCommand command = connection.CreateCommand();
        command.CommandText = "CREATE OR REPLACE DIRECTORY TestDir AS 'c:\\bfiles'";
        command.ExecuteNonQuery();
        command.CommandText = "CREATE TABLE TestTable(col1 number, col2 BFILE)";
        command.ExecuteNonQuery();
        command.CommandText = "INSERT INTO TestTable VALUES ('2', BFILENAME('TESTDIR', 'File.jpg'))";
        command.ExecuteNonQuery();
        command.CommandText = "SELECT * FROM TestTable";

        //Read the BFile data.
        byte[] buffer = new byte[100];
        OracleDataReader dataReader = command.ExecuteReader();
        using (dataReader)
        {
            if (dataReader.Read())
            {
                OracleBFile BFile = dataReader.GetOracleBFile(1);
                using (BFile)
                {
                    BFile.Seek(0, SeekOrigin.Begin);
                    BFile.Read(buffer, 0, 100);
                }
            }
        }
    }
    return;
}

Para obtener más información sobre cómo crear y usar oracle BFILE, consulte el tema adecuado en la documentación de Oracle.

Nota

Los BeginWritemétodos , EndWritey WriteByte , que se heredan de la System.IO.Stream clase , no se admiten porque el BFILE tipo de datos es de solo lectura.

Campos

Null	Representa un objeto OracleBFile nulo que no está enlazado a un archivo físico.

Propiedades

CanRead	Obtiene un valor que indica si se puede leer la secuencia BFILE.
CanSeek	Obtiene un valor que indica si se pueden realizar operaciones de búsqueda hacia delante y de búsqueda hacia atrás.
CanTimeout	Obtiene un valor que determina si se puede agotar el tiempo de espera de la secuencia actual. (Heredado de Stream)
CanWrite	Obtiene un valor que indica si el objeto admite escritura.
Connection	Obtiene el objeto OracleConnection que utiliza esta instancia de OracleBFile.
DirectoryName	Obtiene el nombre del objeto DIRECTORY, al que está asociado un objeto OracleBFile.
FileExists	Obtiene un valor que indica si en el sistema operativo hay un archivo físico con datos BFILE.
FileName	Obtiene el nombre de BFILE sin la ruta de acceso.
IsNull	Obtiene un valor que indica si el objeto OracleBFile es una secuencia Null.
Length	Obtiene un valor que devuelve la longitud en bytes del archivo físico al que está asociado el objeto OracleBFile.
Position	Obtiene la actual posición de lectura en la secuencia OracleBFile.
ReadTimeout	Obtiene o establece un valor, en milisegundos, que determina durante cuánto tiempo la secuencia intentará realizar operaciones de lectura antes de que se agote el tiempo de espera. (Heredado de Stream)
Value	Obtiene Array de tipo Byte que contiene los datos de OracleBFile.
WriteTimeout	Obtiene o establece un valor, en milisegundos, que determina durante cuánto tiempo la secuencia intentará realizar operaciones de escritura antes de que se agote el tiempo de espera. (Heredado de Stream)

Métodos

BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)	Comienza una operación de lectura asincrónica. (Considere usar ReadAsync(Byte[], Int32, Int32) en su lugar). (Heredado de Stream)
BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)	Comienza una operación de escritura asincrónica. (Considere usar WriteAsync(Byte[], Int32, Int32) en su lugar). (Heredado de Stream)
Clone()	Crea una copia de este objeto OracleBFile asociada al mismo archivo físico que el original.
Close()	Cierra la secuencia actual y libera todos los recursos (como sockets e identificadores de archivo) asociados a esta. En lugar de llamar a este método, asegúrese de que la secuencia se desecha correctamente. (Heredado de Stream)
CopyTo(Int64, OracleLob, Int64, Int64)	Copia desde OracleBFile a un OracleLob de destino, con la cantidad de datos especificada y los desplazamientos de origen y de destino.
CopyTo(OracleLob)	Copia todo el contenido de OracleBFile al principio de un OracleLob de destino.
CopyTo(OracleLob, Int64)	Copia todo el contenido de OracleBFile en un OracleLob de destino en el desplazamiento especificado.
CopyTo(Stream)	Lee los bytes de la secuencia actual y los escribe en otra secuencia de destino. Ambas posiciones de secuencias están avanzadas por el número de bytes copiados. (Heredado de Stream)
CopyTo(Stream, Int32)	Lee todos los bytes de la secuencia actual y los escribe en otra secuencia, usando el tamaño de búfer especificado. Ambas posiciones de secuencias están avanzadas por el número de bytes copiados. (Heredado de Stream)
CopyToAsync(Stream)	Lee asincrónicamente los bytes de la secuencia actual y los escribe en otra secuencia. Ambas posiciones de secuencias están avanzadas por el número de bytes copiados. (Heredado de Stream)
CopyToAsync(Stream, CancellationToken)	Lee de forma asincrónica los bytes de la secuencia actual y los escribe en otra secuencia mediante un token de cancelación especificado. Ambas posiciones de secuencias están avanzadas por el número de bytes copiados. (Heredado de Stream)
CopyToAsync(Stream, Int32)	Lee asincrónicamente los bytes de la secuencia actual y los escribe en otra secuencia, usando el tamaño de búfer especificado. Ambas posiciones de secuencias están avanzadas por el número de bytes copiados. (Heredado de Stream)
CopyToAsync(Stream, Int32, CancellationToken)	Lee asincrónicamente los bytes de la secuencia actual y los escribe en otra secuencia, utilizando el tamaño de búfer y el token de cancelación especificados. Ambas posiciones de secuencias están avanzadas por el número de bytes copiados. (Heredado de Stream)
CreateObjRef(Type)	Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
CreateWaitHandle()	Obsoletos. Asigna un objeto WaitHandle. (Heredado de Stream)
Dispose()	Libera todos los recursos que usa Stream. (Heredado de Stream)
Dispose(Boolean)	Libera los recursos no administrados que usa Stream y, de forma opcional, libera los recursos administrados. (Heredado de Stream)
DisposeAsync()	Libera de forma asincrónica los recursos no administrados usados por Stream. (Heredado de Stream)
EndRead(IAsyncResult)	Espera a que se complete la lectura asincrónica que se encuentra pendiente. (Considere usar ReadAsync(Byte[], Int32, Int32) en su lugar). (Heredado de Stream)
EndWrite(IAsyncResult)	Finaliza una operación de escritura asincrónica. (Considere usar WriteAsync(Byte[], Int32, Int32) en su lugar). (Heredado de Stream)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
Flush()	No se admite actualmente.
FlushAsync()	Borra asincrónicamente todos los búferes de esta secuencia y hace que los datos almacenados en búfer se escriban en el dispositivo subyacente. (Heredado de Stream)
FlushAsync(CancellationToken)	Borra asincrónicamente todos los búferes de esta secuencia, y hace que todos los datos almacenados en búfer se escriban en el dispositivo subyacente y supervisa las solicitudes de cancelación. (Heredado de Stream)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetLifetimeService()	Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
InitializeLifetimeService()	Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
ObjectInvariant()	Obsoletos. Proporciona compatibilidad con una clase Contract. (Heredado de Stream)
Read(Byte[], Int32, Int32)	Lee una secuencia de bytes en la secuencia OracleBFile actual y hace avanzar la posición dentro de la secuencia en función del número de bytes leídos.
Read(Span<Byte>)	Cuando se reemplaza en una clase derivada, se lee una secuencia de bytes en la secuencia actual y se hace avanzar la posición dentro de la secuencia el número de bytes leídos. (Heredado de Stream)
ReadAsync(Byte[], Int32, Int32)	Lee asincrónicamente una secuencia de bytes de la secuencia actual y avanza la posición en esta secuencia según el número de bytes leídos. (Heredado de Stream)
ReadAsync(Byte[], Int32, Int32, CancellationToken)	Lee de forma asincrónica una secuencia de bytes en la secuencia actual, se hace avanzar la posición dentro de la secuencia el número de bytes leídos y controla las solicitudes de cancelación. (Heredado de Stream)
ReadAsync(Memory<Byte>, CancellationToken)	Lee de forma asincrónica una secuencia de bytes en la secuencia actual, se hace avanzar la posición dentro de la secuencia el número de bytes leídos y controla las solicitudes de cancelación. (Heredado de Stream)
ReadAtLeast(Span<Byte>, Int32, Boolean)	Lee al menos un número mínimo de bytes de la secuencia actual y avanza la posición dentro de la secuencia por el número de bytes leídos. (Heredado de Stream)
ReadAtLeastAsync(Memory<Byte>, Int32, Boolean, CancellationToken)	Lee de forma asincrónica al menos un número mínimo de bytes de la secuencia actual, avanza la posición dentro de la secuencia por el número de bytes leídos y supervisa las solicitudes de cancelación. (Heredado de Stream)
ReadByte()	Lee un byte de la secuencia y hace avanzar la posición de la secuencia en un byte, o devuelve -1 si está al final de la secuencia. (Heredado de Stream)
ReadExactly(Byte[], Int32, Int32)	count Lee el número de bytes de la secuencia actual y avanza la posición dentro de la secuencia. (Heredado de Stream)
ReadExactly(Span<Byte>)	Lee bytes de la secuencia actual y avanza la posición dentro de la secuencia hasta buffer que se rellena . (Heredado de Stream)
ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken)	Lee count de forma asincrónica el número de bytes de la secuencia actual, avanza la posición dentro de la secuencia y supervisa las solicitudes de cancelación. (Heredado de Stream)
ReadExactlyAsync(Memory<Byte>, CancellationToken)	Lee de forma asincrónica los bytes de la secuencia actual, avanza la posición dentro de la secuencia hasta buffer que se rellena y supervisa las solicitudes de cancelación. (Heredado de Stream)
Seek(Int64, SeekOrigin)	Establece la posición en la secuencia OracleBFile actual.
SetFileName(String, String)	Enlaza el objeto OracleBFile a otro archivo del sistema operativo.
SetLength(Int64)	Actualmente no se admite.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
Write(Byte[], Int32, Int32)	Actualmente no se admite.
Write(ReadOnlySpan<Byte>)	Cuando se reemplaza en una clase derivada, se escribe una secuencia de bytes en la secuencia actual y se hace avanzar la posición actual dentro de la secuencia el número de bytes escritos. (Heredado de Stream)
WriteAsync(Byte[], Int32, Int32)	Escribe asincrónicamente una secuencia de bytes en la secuencia actual y avanza la posición actual en esta secuencia según el número de bytes escritos. (Heredado de Stream)
WriteAsync(Byte[], Int32, Int32, CancellationToken)	Escribe de forma asincrónica una secuencia de bytes en la secuencia actual, se hace avanzar la posición actual dentro de la secuencia el número de bytes escritos y controla las solicitudes de cancelación. (Heredado de Stream)
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)	Escribe de forma asincrónica una secuencia de bytes en la secuencia actual, se hace avanzar la posición actual dentro de la secuencia el número de bytes escritos y controla las solicitudes de cancelación. (Heredado de Stream)
WriteByte(Byte)	Escribe un byte a la posición actual en la secuencia y avanza la posición de la secuencia en un byte. (Heredado de Stream)

Métodos de extensión

CopyToAsync(Stream, PipeWriter, CancellationToken)

Lee de forma asincrónica los bytes de Stream y los escribe en el elemento PipeWriter especificado, mediante un token de cancelación.