Open (método) (Stream de ADO)

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

Sintaxis

  
Stream.Open Source, Mode , OpenOptions, UserName, Password  

Parámetros

Origen
Opcional. Valor Variant que especifica el origen de datos para 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"). Como alternativa, el Origen puede contener una referencia a un objeto Record ya abierto, que abre la secuencia predeterminada asociada al objeto Record. Si no se especifica el Origen, se crea y se abre una instancia de Stream, que no está asociada a ningún origen subyacente de forma predeterminada. Para obtener más información sobre los esquemas de direcciones URL y sus proveedores asociados, vea Direcciones URL absolutas y relativas.

Modo
Opcional. Valor ConnectModeEnum que especifica el modo de acceso para el objeto Stream resultante (por ejemplo, lectura y escritura o solo lectura). Su valor predeterminado es adModeUnknown. Consulte la propiedad Mode para obtener más información sobre los modos de acceso. Si no se especifica el valor Mode, el objeto de origen lo hereda. Por ejemplo, si el objeto Record de origen se abre en modo de solo lectura, el objeto Stream también se abrirá en modo de solo lectura de forma predeterminada.

OpenOptions
Opcional. Un valor StreamOpenOptionsEnum. El valor predeterminado es adOpenStreamUnspecified.

UserName
Opcional. Valor String que contiene la identificación del usuario que, si es necesario, accede al objeto Stream.

Contraseña
Opcional. Valor String que contiene la contraseña que, si es necesario, accede 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. Del mismo modo, el valor Mode del objeto Record se transfiere al objeto Stream. Cuando no se especifica Source, el objeto Stream abierto no contiene datos y tiene un Tamaño de cero (0). Para evitar perder los datos que se escriben en este objeto Stream cuando se cierra Stream, guarde Stream con los métodos CopyTo o SaveToFile, o guárdelo en otra ubicación de la memoria.

Un valor OpenOptions de adOpenStreamFromRecord identifica el contenido del parámetro Source para que sea un objeto Record ya abierto. El comportamiento predeterminado es tratar Source como una dirección URL que apunta directamente a un nodo de una estructura de árbol, como un archivo. Se abre el flujo predeterminado asociado a ese nodo.

Aunque Stream no está abierto, es posible leer todas las propiedades de solo lectura de Stream. Si un objeto Stream se abre de forma asincrónica, todas las operaciones posteriores (distintas de comprobar el valor State y otras propiedades de solo lectura) se bloquean hasta que se complete la operación Open.

Además de las opciones que se trataron anteriormente, al no especificar Source, puede crear una instancia de un objeto Stream en memoria sin asociarlo a un origen subyacente. Puede agregar datos dinámicamente a la secuencia escribiendo datos binarios o de texto en el objeto Stream con Write o WriteText, o cargando datos de un archivo con LoadFromFile.

Se aplica a

Objeto de secuencia (ADO)

Consulte también

Open (método) (conexión de ADO)
Open (método) (registro de ADO)
Open (método) (conjunto de registros ADO)
Método OpenSchema
Método SaveToFile