Open (método, Stream de ADO)

Se aplica a: Access 2013, Office 2013

Abre un objeto Stream para manipular secuencias de datos binarios o de texto.

Sintaxis

Stream. Código abierto, Modo, OpenOptions, UserName, Contraseña

Parámetros

Parámetro	Descripción
Source	Es opcional. Valor de tipo Variant que especifica el origen de datos del objeto Stream. El origen puede contener una cadena de dirección URL absoluta que apunta a un nodo existente en una estructura de árbol conocida, como un correo electrónico o un sistema de archivos. Se debe especificar una dirección URL mediante la palabra clave URL ("URL=scheme:///server folder"). Asimismo, Source puede contener una referencia a un objeto Record abierto, que abre la secuencia predeterminada asociada al objeto Record. Si no se especifica Source, se crea y se abre una instancia de Stream, que no está asociada a ningún origen subyacente de manera predeterminada. Para obtener más información sobre los esquemas de direcciones URL y sus proveedores asociados, consulte Direcciones URL absolutas y relativas.
Modo	Es opcional. Valor de ConnectModeEnum que especifica el modo de acceso del objeto Stream resultante (por ejemplo, de lectura y escritura, o bien, de solo lectura). El valor predeterminado es adModeUnknown. Vea la propiedad Mode para obtener más información sobre los modos de acceso. Si no se especifica Mode, su valor se hereda del objeto de origen. Por ejemplo, si el objeto Record de origen se abre en modo de solo lectura, el objeto Stream también se abrirá de forma predeterminada en modo de solo lectura.
OpenOptions	Es opcional. Valor de StreamOpenOptionsEnum. El valor predeterminado es adOpenStreamUnspecified.
UserName	Es opcional. Valor de tipo String con la identificación del usuario que, en caso de que sea necesario, obtiene acceso al objeto Stream.
Password	Es opcional. Valor de tipo String con la contraseña que, en caso de que sea necesario, obtiene acceso al objeto Stream.

Comentarios

Cuando se pasa un objeto Record como parámetro de origen, los parámetros UserID y Password no se usan porque el acceso al objeto Record ya está disponible. De forma similar, el modo del objeto Record se transfiere al objeto Stream. Cuando no se especifica Source, el Stream abierto no contiene datos y tiene un tamaño de cero (0). Para evitar perder los datos que se escriben en esta Stream cuando se cierra el Stream, guarde el Stream con los métodos CopyTo o SaveToFile o guárdelo en otra ubicación de memoria.

El valor adOpenStreamFromRecord de OpenOptions identifica el contenido del parámetro Source como un objeto Record abierto. El comportamiento predeterminado es tratar Source como una dirección URL que señala directamente un nodo en una estructura de árbol, como un archivo. Se abre la secuencia predeterminada asociada a ese nodo.

Mientras no esté abierto el objeto Stream, es posible leer todas las propiedades de solo lectura de Stream. Si se abre un objeto Stream asincrónicamente, todas las operaciones subsiguientes (que no sean la comprobación de State y otras propiedades de solo lectura) se bloquean hasta que finalice la operación Open.

Además de las opciones anteriormente descritas, si no se especifica el valor de Source, se puede crear simplemente una instancia de un objeto Stream en la memoria sin asociarla a un origen subyacente. Se pueden agregar datos dinámicamente a la secuencia escribiendo simplemente datos binarios o de texto en el objeto Stream mediante Write o WriteText, o bien, cargando los datos desde un archivo mediante LoadFromFile.