Objeto de secuencia (ADO)

Representa una secuencia de datos binarios o texto.

En jerarquías estructuradas en árbol, como un sistema de archivos o un sistema de correo electrónico, un objeto Record puede tener una secuencia binaria de bits asociada predeterminada que contenga el contenido del archivo o el correo electrónico. Se puede usar un objeto Stream para manipular campos o registros que contienen estos flujos de datos. Un objeto Stream se puede obtener de estas maneras:

• Desde una dirección URL que apunta a un objeto (normalmente un archivo) que contiene datos binarios o de texto. Este objeto puede ser un documento simple, un objeto Record que representa un documento estructurado o una carpeta.

• Al abrir el objeto Stream predeterminado asociado a un objeto Record. Puede obtener la secuencia predeterminada asociada a un objeto Record cuando se abre Record, para eliminar un recorrido de ida y vuelta solo para abrir la secuencia.

• Al crear una instancia de un objeto Stream. Estos objetos Stream se pueden usar para almacenar datos para los fines de la aplicación. A diferencia de un objeto Stream asociado a una dirección URL, o el objeto Stream de un objeto Record, un objeto Stream con instancias no tiene ninguna asociación con un origen subyacente de forma predeterminada.

Con los métodos y propiedades de un objeto Stream, se puede hacer lo siguiente:

• Abrir un objeto Stream desde Record o una dirección URL con el método Open.

• Cerrar un objeto Stream con el método Close.

• Introducir bytes o texto en un objeto Stream con los métodos Write y WriteText.

• Leer bytes de Stream con los métodos Read y ReadText.

• Escribir datos de Stream que todavía están en el búfer de ADO en el objeto subyacente con el método Flush.

• Copiar el contenido de un objeto Stream en otro objeto Stream con el método CopyTo.

• Controlar cómo se leen las líneas del archivo de origen con el método SkipLine y la propiedad LineSeparator .

• Determine el final de la posición del flujo con la propiedad EOS y el método SetEOS.

• Guarde y restaure datos en archivos con los métodos SaveToFile y LoadFromFile .

• Especificar el juego de caracteres usado para almacenar el objeto Stream con la propiedad Charset.

• Detener una operación de Stream asincrónica con el método Cancel.

• Determinar el número de bytes de un objeto Stream con la propiedad Size.

• Controlar la posición actual dentro de un objeto Stream con la propiedad Position.

• Determinar el tipo de datos de un objeto Stream con la propiedad Type.

• Determinar el estado actual del objeto Stream (cerrado, abierto o en ejecución) con la propiedad State.

• Especificar el modo de acceso de Stream con la propiedad Mode.

Nota:

Las URL que usan el esquema http invocan automáticamente el Proveedor de Microsoft OLE DB para publicaciones en Internet. Para obtener más información, vea Direcciones URL absolutas y relativas.

El objeto Stream es seguro para el scripting.

Esta sección contiene los temas siguientes.

• Propiedades, métodos y eventos del objeto Stream

Consulte también

Registros y secuencias