Acerca del objeto de registro y del objeto de transmisión en ADO
Te daré una dirección. Puedes descargarlo y echarle un vistazo. Si es bueno, obtendrás puntos. Si no, no obtendrás puntos:
<. p>/Down/21209.htmladodb.Métodos/propiedades del objeto de flujo
Método de cancelación
El método de uso es el siguiente
Object.Cancel
Descripción: Cancelar la ejecución asincrónica pendiente. Una llamada al método Execute o Open.
Método cerrar
El método de uso es el siguiente
Object.Close
: cerrar el objeto
Método CopyTo
El método de uso es el siguiente
Object.CopyTo(destStream, [CharNumber])
Descripción: copia los datos del objeto, destStream apunta al objeto a copiar, CharNumber es un parámetro opcional, que se refiere al número de bytes a copiar. Si no se selecciona, se copiarán todos.
Método Flush
El método de uso es el siguiente
Object.Flush
Descripción:
Método LoadFromFile
El método de uso es el siguiente
Object.LoadFromFile(FileName)
Descripción: carga el documento especificado por FileName en el objeto y el parámetro FileName es el nombre de usuario especificado.
Método abierto
El método de uso es el siguiente
Object.Open(Fuente, [Modo], [Opciones], [Nombre de usuario], [Contraseña] )
Descripción: abre el objeto,
Descripción del parámetro: fuente del objeto fuente, opcional.
Modo especifica el modo de apertura, los parámetros opcionales son los siguientes:
p>
adModeRead =1
adModeReadWrite =3
adModeRecursive =4194304
adModeShareDenyNone =16
adModeShareDenyRead =4
adModeShareDenyWrite =8
adModeShareExclusive =12
adModeUnknown =0
adModeWrite =2
Opciones especifica las opciones para abrir, los parámetros opcionales son los siguientes:
adOpenStreamAsync =1
adOpenStreamFromRecord =4
adOpenStreamUnspecified=-1
UserName especifica el usuario. El nombre es opcional.
Contraseña Especifica la contraseña del nombre de usuario
Método de lectura
El método de uso es el siguiente:
Object.Read(Numbytes )
Descripción: Lee el contenido binario de la longitud especificada.
Descripción del parámetro: Numbytes especifica el número que se leerá. Si no se especifica, se leerán todos.
Método ReadText
El método de uso es el siguiente:
Object.ReadText(NumChars)
Descripción: Lee el texto del longitud especificada
p>
Descripción del parámetro: el número a leer especificado por NumChars; si no se especifica, se leerán todos.
Método SaveToFile
El método de uso es el siguiente:
Object.SaveToFile(FileName, [Options])
Explicación: Guardar El contenido del objeto se escribe en el documento especificado por FileName
Descripción del parámetro: el documento especificado por FileName
Opciones de acceso a opciones, que se pueden dejar sin especificar. Los parámetros opcionales son los siguientes. :
adSaveCreateNotExist =1
adSaveCreateOverWrite =2
Método SetEOS
El método de uso es el siguiente:
Object.setEOS()
Instrucciones:
Método SkipLine
El uso es el siguiente:
Object.SkipLine()
Instrucciones:
Método de escritura
El método de uso es el siguiente:
Object.Write(Buffer)
Descripción: Carga los datos especificados en el objeto.
Descripción del parámetro: el búfer es el contenido especificado que se escribirá.
Método WriteText
El método de uso es el siguiente:
Object.Write(Data, [Options])
Descripción: El texto especificado Los datos se cargan en el objeto.
Descripción del parámetro: Los datos son el contenido especificado que se escribirá.
Opciones No se pueden especificar las opciones de escritura. Los parámetros opcionales son los siguientes:
adWriteChar =0
adWriteLine =1
Charset
EOS devuelve si los datos del objeto están vacíos.
LineSeparator especifica el formato de avance de línea. Los parámetros opcionales son
adCR =13
adCRLF =-1
adLF =10<. /p >
Modo especifica o agrega el modo posterior.
Posición especifica o devuelve el puntero actual a los datos del objeto.
Tamaño devuelve el tamaño de los datos dentro del objeto.
Estado devuelve si el estado del objeto está activado.
Tipo especifica o devuelve el tipo de datos. Los parámetros opcionales son:
adTypeBinary =1
adTypeText =2
En registro ADO. objeto:
Propiedad de estado
Para todos los objetos aplicables, indica si el estado del objeto es abierto o cerrado.
Indica la ejecución de métodos asincrónicos en todos los objetos aplicables, indicando si el estado actual del objeto se está conectando, ejecutando o recuperando.
Valor de retorno
Devuelve un valor Long que puede ser un valor ObjectStateEnum. El valor predeterminado es adStateClosed.
Descripción
El estado actual de un objeto determinado se puede determinar en cualquier momento utilizando la propiedad Estado.
La propiedad Estado de un objeto puede ser una combinación de valores. Por ejemplo, si se ejecuta una declaración, esta propiedad tendrá un valor combinado de adStateOpen y adStateExecuting.
La propiedad State es de sólo lectura.
Objetos de registro
Representan filas en un Recordset o archivos o directorios en un sistema de archivos.
Descripción
A través de la colección Campos en el objeto Registro, puede ver los campos asociados con el objeto Registro. ADO permite columnas cuyos valores son objetos, incluidos valores escalares en la colección Fields de objetos Recordset, SafeArray y Record.
Si el objeto Record representa una fila en un Recordset, es posible devolver el Recordset original.
Los objetos de registro pueden imitar un espacio de nombres con estructura de árbol. Cada nodo del árbol es un objeto Registro con columnas asociadas. Estas columnas pueden representar los atributos del nodo y otra información relacionada. En esta estructura de árbol, los objetos Record pueden representar tanto nodos hoja como nodos no hoja. Los nodos que no son hoja pueden tener otros nodos como contenido, mientras que los nodos hoja no tienen dicho contenido. Normalmente, los nodos hoja contienen un flujo binario de datos, mientras que los nodos que no son hoja también pueden tener un flujo binario predeterminado asociado a ellos. Las propiedades del objeto Registro identifican el tipo de nodo.
Los objetos de registro también representan métodos de reemplazo para localizar datos jerárquicos. Puede crear un objeto Registro para representar la raíz de un subárbol específico dentro de una estructura de árbol más grande. Los objetos New Record se pueden abrir y utilizar para representar nodos secundarios.
Un archivo o directorio (un "recurso") se identifica de forma única mediante una URL absoluta. Cuando se abre un Registro con una URL absoluta, se crea explícitamente un objeto Conexión y se establece en el objeto Registro. Un objeto Connection se puede establecer explícitamente en un objeto Record a través de la propiedad ActiveConnection. Los archivos y directorios accesibles a través de objetos de Conexión definen el "contexto" en el que pueden ocurrir las operaciones de Registro.
Los métodos de ubicación y modificación de datos en el objeto Registro también aceptan URL relativas, que utilizan una URL absoluta o el contexto del objeto Conexión como punto de partida para localizar el recurso.
A cada objeto Registro se le asocia un objeto Conexión. Por lo tanto, las operaciones del objeto Registro se consideran parte de una transacción llamando a los métodos de transacción del objeto Conexión.
Los objetos de registro no admiten eventos ADO y, por lo tanto, no responden a las notificaciones.
Utilice los métodos y propiedades del objeto Record para realizar las siguientes operaciones:
Utilice la propiedad ActiveConnection para establecer o devolver el objeto Connection asociado.
Utilice el atributo Modo para indicar permisos de acceso.
Utilice la propiedad ParentURL para devolver la URL del directorio (si lo hay) que contiene el recurso representado por el Registro.
Utilice el atributo Fuente para indicar una URL absoluta, una URL relativa o un conjunto de registros desde el que se puede exportar el registro.
Utilice la propiedad Estado para indicar el estado actual del Registro.
Utilice el atributo RecordType para indicar el tipo de registro: documento simple, documento de colección o documento estructurado.
Utilice el método Cancelar para finalizar la ejecución de una operación asincrónica.
Utilice el método Cerrar para desconectar el Registro de la fuente de datos.
Utilice el método CopyRecord para copiar el archivo o directorio representado por Record a otra ubicación.
Utilice el método DeleteRecord para eliminar el archivo o directorio (y sus subdirectorios) representado por Record.
Utilice el método GetChildren para abrir un Recordset que contenga líneas que representen los subdirectorios y archivos del proyecto representado por un Registro.
Utilice el método MoveRecord para mover el archivo o directorio (y sus subdirectorios) representado por Record a otra ubicación, o para cambiarle el nombre.
Utilice el método Open para asociar un Registro con una fuente de datos existente o para crear un nuevo archivo o directorio.
Propiedad de modo
Indica los permisos efectivos para modificar datos en un objeto Conexión, Registro o Transmisión.
Establecer y devolver valores
Establecer o devolver el valor ConnectModeEnum. Para Conexión, el valor predeterminado es adModeUnknown. Para los objetos Record, el valor predeterminado es adModeRead. Para una secuencia asociada con una fuente base (abierta como fuente con una URL o como secuencia predeterminada del registro), el valor predeterminado es adReadOnly. Para transmisiones no asociadas con una fuente base (con instancias en la memoria), el valor predeterminado es adModeUnknown.
Descripción
Utilice la propiedad Modo para establecer o devolver los derechos de acceso utilizados por el proveedor en la conexión actual. La propiedad Modo solo se puede establecer cuando el objeto Conexión está cerrado.
Para los objetos Stream, si no se especifica el modo de acceso, se heredará de la fuente utilizada para abrir el objeto Stream. Por ejemplo, si se abre una secuencia desde un objeto Record, de forma predeterminada se abrirá en el mismo modo que el objeto Record.
Esta propiedad es de lectura/escritura cuando el objeto está cerrado y de solo lectura cuando el objeto está abierto.
Uso del servicio de datos remoto Cuando se utiliza en el objeto Conexión del cliente, la propiedad Modo solo se puede establecer en adModeUnknown.
Propiedad ParentURL
Indica una cadena de URL absoluta que apunta al Registro principal del objeto Registro actual.
Valor de retorno
Devuelve un valor de cadena que indica la URL del registro principal.
Descripción
La propiedad ParentURL depende de la fuente utilizada para abrir el objeto Record. Por ejemplo, puede abrir un Registro con una fuente que contenga la ruta relativa del directorio al que hace referencia la propiedad ActiveConnection.
Supongamos que "segundo" es una carpeta contenida en "primero".
Abra un objeto Registro con el siguiente código:
record.ActiveConnection = " Publicación) compatible.
Propiedad fuente (Registro ADO)
Indica el elemento representado por el objeto Registro
Establecer y devolver valores
Establecer o devolver el valor Variante que indica el elemento representado por el Registro
Descripción
Si la propiedad ActiveConnection también está configurada, la propiedad Source debe apuntar a la que existe en. el conjunto de registros.Un objeto dentro del alcance de la conexión. Por ejemplo, en un espacio de nombres estructurado en árbol, si la propiedad Fuente contiene una URL absoluta, debe apuntar a un nodo dentro del rango de nodos identificados por la URL en la cadena de conexión. una URL relativa, es válida en el contexto establecido por la propiedad ActiveConnection
La propiedad Fuente es de lectura/escritura cuando el objeto Registro está cerrado y de solo lectura cuando el objeto Registro está abierto >Propiedad Estado.
Indica si el estado del objeto es abierto o cerrado para todos los objetos aplicables.
Indica la ejecución de métodos asincrónicos para todos los objetos aplicables e indica si es así. conectando, ejecutando o recuperando
Valor de retorno
Devuelve un valor Long que puede ser un valor de ObjectStateEnum
Descripción
p>. El estado actual de un objeto determinado se puede determinar en cualquier momento.
La propiedad State de un objeto puede ser una combinación de valores. Por ejemplo, si se está ejecutando una declaración, esta propiedad tendrá un adStateOpen. El valor combinado de adStateExecuting.
La propiedad State es de solo lectura.
La propiedad RecordType
Indica el tipo de objeto Record.
Valor de retorno
Devuelve el valor RecordTypeEnum.
Descripción
La propiedad RecordType es de solo lectura.
Cancelar método
Cancela la ejecución de una llamada a un método asincrónico pendiente.
Sintaxis
object.Cancel
Descripción
Utilice el método Cancel para finalizar la ejecución de una llamada a un método asíncrono (es decir, utilice el método de opción adAsyncConnect, adAsyncExecute o adAsyncFetch llamado).
La siguiente tabla muestra las tareas que finalizarán al utilizar el método Cancelar de un tipo específico de objeto.
Si el objeto finaliza la última llamada asincrónica a este método
Comando Ejecutar
Conexión Ejecutar o Abrir
Registro CopyRecord, DeleteRecord, MoveRecord o Abrir
Recordset Abrir
Transmitir Abrir
Método Cerrar
Cierra el objeto abierto y cualquier objeto relacionado.
Sintaxis
object.Close
Descripción
Utilice el método Close para cerrar un objeto Connection, Record, Recordset o Stream para liberar cualquier recurso del sistema asociado. Cerrar un objeto no lo elimina de la memoria; posteriormente puede cambiar la configuración de sus propiedades y abrirlo nuevamente. Para borrar completamente un objeto de la memoria, establezca la variable del objeto en Nada (en Visual Basic) después de cerrar el objeto.
Conexión
Cerrar un objeto Conexión usando el método Cerrar también cerrará cualquier objeto Recordset activo asociado con la conexión. El objeto Comando asociado con el objeto Conexión de cierre persistirá, pero ya no estará asociado con el objeto Conexión, es decir, su propiedad ActiveConnection se establecerá en Nada. Todos los parámetros definidos por el proveedor también se borran de la colección de parámetros del objeto Command.
Luego se puede llamar al método Open para restablecer la conexión con la misma fuente de datos o con una fuente de datos diferente. Una vez cerrado el objeto Connection, llamar a cualquier método que requiera una conexión abierta a la fuente de datos generará un error.
Mientras un objeto Recordset está abierto en la conexión, cerrar el objeto Connection revertirá los cambios pendientes en todos los objetos Recordset. Cerrar explícitamente un objeto Connection (llamando al método Close) mientras una transacción está en curso generará un error. Si el objeto Conexión sale del alcance mientras una transacción está en progreso, ADO revertirá automáticamente la transacción.
Recordset, Record y Stream
Cerrar un objeto Recordset, Record o Stream utilizando el método Close libera los datos asociados y el acceso independiente a los datos que se hayan podido realizar a través de este objeto concreto. Luego se puede llamar al método Open para volver a abrir el objeto con las mismas propiedades o propiedades modificadas.
Después de cerrar el objeto Recordset, llamar a cualquier método que requiera un cursor activo generará un error.
Si se edita en modo de actualización inmediata, llamar al método Close generará un error y se debe llamar primero al método Update o CancelUpdate. Si cierra un objeto Recordset en modo de actualización por lotes, se perderán todos los cambios realizados desde la última llamada a UpdateBatch.
Si utiliza el método Clone para crear una copia de un objeto Recordset abierto, cerrar el Recordset original o su copia no afecta a ninguna otra copia.
Método CopyRecord
Copiar un archivo o directorio (y su contenido) a otra ubicación.
Sintaxis
CopyRecord (Origen, Destino, Nombre de usuario, Contraseña, Opciones, Asíncrono)
Parámetros
El origen es opcional. Valor de cadena que contiene la URL que especifica el archivo o directorio que se va a copiar. Si se omite Fuente o se especifica una cadena vacía, se copiará el archivo o directorio representado por este Registro.
El destino es opcional. Valor de cadena que contiene la URL que especifica la ubicación para copiar la fuente.
Nombre de usuario Opcional. Valor de cadena que contiene el ID de usuario autorizado para acceder al Destino (si es necesario).
La contraseña es opcional. Valor de cadena que contiene la contraseña para autenticar el nombre de usuario (si es necesario).
Opciones Opcional. Valor CopyRecordOptionsEnum, cuyo valor predeterminado es adCopyUnspecified. Especifica el comportamiento de este método.
Asíncrono Opcional. Un valor booleano que, cuando es Verdadero, especifica que esta operación es asincrónica.
Valor de retorno
Valor de cadena, normalmente devuelve el valor de Destino. Sin embargo, el valor exacto devuelto depende del proveedor.
Notas
Los valores de Origen y Destino deben ser iguales, de lo contrario se producirá un error de tiempo de ejecución. El servidor, ruta o recurso tiene al menos un nombre diferente.
A menos que se especifique adCopyNonRecursive, todos los subdirectorios de Fuente se copiarán de forma recursiva. En operaciones recursivas, el Destino no puede ser un subdirectorio de la Fuente; de lo contrario, la operación no se completará.
Si el Destino identifica un archivo o directorio existente, este método fallará a menos que se especifique adCopyOverWrite.
Importante Considere utilizar la opción adMoveOverWrite. Por ejemplo, al copiar un archivo a un directorio, al especificar esta opción se "eliminará" el directorio y se reemplazará con el archivo.
Método DeleteRecord
Elimina un archivo o directorio (incluidos todos los subdirectorios dentro del directorio).
Sintaxis
DeleteRecord Source, Async
Parámetros
El origen es opcional. Valor de cadena que contiene la URL que identifica el archivo o directorio que se va a eliminar. Si se omite Fuente o se especifica la cadena vacía, se eliminará el archivo o directorio representado por este Registro.
Asíncrono Opcional. Un valor booleano que, cuando es Verdadero, especifica que la operación de eliminación es asincrónica.
Descripción
Una vez completado este método, las operaciones en el archivo o directorio representado por Record pueden fallar. Después de llamar a DeleteRecord, dependiendo de cuándo el proveedor actualice el registro con la fuente de datos, el registro puede comportarse de manera impredecible, por lo que debe cerrarse.
Si este Registro se obtiene de un Recordset, los resultados de esta operación no se reflejarán inmediatamente en el Recordset. Cerrar y volver a abrir el conjunto de registros, o ejecutar los métodos Recordset Requery o Update y Resync, actualizará el Recordset.
Método GetChildren
Devuelve un Recordset cuyas filas representan archivos y subdirectorios en el directorio representado por este Registro.
Sintaxis
Establecer conjunto de registros = record.GetChildren
Valor de retorno
Objeto de conjunto de registros, cada línea del cual representa un archivo o directorio.
Descripción
El proveedor determina qué columnas se incluyen en el Recordset devuelto. Por ejemplo, un proveedor de origen de documentos siempre devuelve un conjunto de registros de recursos.
Método MoveRecord
Mueve un archivo o directorio (y su contenido) a otra ubicación.
Sintaxis
MoveRecord (Origen, Destino, Nombre de usuario, Contraseña, Opciones, Async)
Parámetros
El origen es opcional. Valor de cadena que contiene la URL que identifica el Registro que se va a mover. Si se omite Fuente o se especifica una cadena vacía, se mueve el archivo o directorio representado por este Registro.
El destino es opcional. Valor de cadena que contiene la URL que especifica la ubicación del origen que se va a mover.
Nombre de usuario Opcional. Valor de cadena que contiene el ID de usuario autorizado para acceder al Destino (si es necesario).
La contraseña es opcional. Cadena que contiene la contraseña para autenticar el nombre de usuario (si es necesario).
Opciones Opcional. Valor MoveRecordOptionsEnum, cuyo valor predeterminado es adMoveUnspecified. Especifica el comportamiento de este método.
Asíncrono Opcional. Un valor booleano que, cuando es Verdadero, especifica que esta operación es asincrónica.
Valor de retorno
Valor de cadena. Generalmente devuelve un valor de Destino. Sin embargo, el valor exacto devuelto depende del proveedor.
Notas
Los valores de Origen y Destino deben ser iguales, de lo contrario se producirá un error de tiempo de ejecución. Al menos los nombres del servidor, la ruta y los recursos no pueden ser los mismos.
Este método actualizará todos los enlaces de hipertexto en el archivo que se está moviendo (excepto los especificados en Opciones). Si el Destino identifica un archivo o directorio existente, este método fallará a menos que se especifique adMoveOverWrite.
Nota Considere utilizar la opción adMoveOverWrite. Por ejemplo, para mover un archivo a un directorio, al especificar esta opción se eliminará el directorio y se reemplazará con el archivo.
Una vez completada esta operación, algunas propiedades del objeto Record (como la propiedad ParentURL) no se actualizarán. Las propiedades de un objeto Registro se pueden actualizar cerrando el Registro y volviéndolo a abrir con la URL de la ubicación movida del archivo o directorio.
Si este registro se obtuvo de un conjunto de registros, la nueva ubicación del archivo o directorio movido no se reflejará inmediatamente en el conjunto de registros. Cerrar y reabrir actualizará el conjunto de registros.