Método Workbooks.Open (Excel)
Abre un libro.
Nota:
¿Le interesa el desarrollo de soluciones que amplían la experiencia de Office en varias plataformas? Vea el nuevo modelo de complementos de Office. Los complementos de Office tienen una huella pequeña en comparación con los complementos y soluciones de VSTO, y se pueden construir utilizando casi cualquier tecnología de programación web, como HTML5, JavaScript, CSS3 y XML.
Sintaxis
expresión. Open (FileName, UpdateLinks, ReadOnly, Format, Password, WriteResPassword, IgnoreReadOnlyRecommended, Origin, Delimiter, Editable, Notify, Converter, AddToMru, Local, CorruptLoad)
Expresión Variable que representa un objeto Workbooks .
Parameters
| Nombre | Obligatorio/opcional | Tipo de datos | Descripción |
|---|---|---|---|
| FileName | Opcional | Variant | Cadena. El nombre de archivo del libro que se debe abrir. |
| UpdateLinks | Opcional | Variant | Especifica la forma en que se actualizan las referencias externas (vínculos) del archivo, como la referencia a un rango en el libro de Budget.xls de la fórmula =SUM([Budget.xls]Annual!C10:C25)siguiente. Si no se especifica este argumento, se pide al usuario que especifique cómo se deben actualizar los vínculos. Para obtener más información acerca de los valores que se usan con este parámetro, vea la sección de comentarios.Si Microsoft Excel abre un archivo en el formato WKS, WK1 o WK3 y el argumento UpdateLinks es 0, no se crean gráficos; De lo contrario, Microsoft Excel genera gráficos a partir de los gráficos adjuntos al archivo. |
| ReadOnly | Opcional | Variant | True para abrir el libro en modo de solo lectura. |
| Format | Opcional | Variant | Si Microsoft Excel abre un archivo de texto, este argumento especifica el carácter delimitador. Si este argumento se omite, se usará el delimitador actual. Para obtener más información sobre los valores que usa este parámetro, consulte la sección Comentarios. |
| Password | Opcional | Variant | Cadena que contiene la contraseña necesaria para abrir un libro protegido. Si este argumento se omite y el libro requiere contraseña, se solicita al usuario que especifique la contraseña. |
| WriteResPassword | Opcional | Variant | Cadena que contiene la contraseña necesaria para abrir un libro protegido contra escritura. Si este argumento se omite y el libro requiere contraseña, se solicita al usuario que especifique la contraseña. |
| IgnoreReadOnlyRecommended | Opcional | Variant | True para que Microsoft Excel no muestre el mensaje de solo lectura recomendada (si el libro se guardó mediante la opción Recomendado solo lectura). |
| Origen | Opcional | Variant | Si el archivo es un archivo de texto, este argumento indica su origen, de modo que las páginas de código y retorno de carro, avance de línea (CR/LF) se puedan asignar correctamente. Puede ser una de las siguientes constantes XlPlatform : xlMacintosh, xlWindows o xlMSDOS. Si este argumento se omite, se usará el sistema operativo actual. |
| Delimitador | Opcional | Variant | Si el archivo es un archivo de texto y el argumento Format es 6, este argumento es una cadena que especifica el carácter que se usará como delimitador. Por ejemplo, use Chr(9) para tabulaciones, use "," para comas, use ";" para puntos y coma o use un carácter personalizado. Solo se usa el primer carácter de la cadena. |
| Editable | Opcional | Variant | Si el archivo es un complemento de Microsoft Excel 4.0, este argumento es True para abrir el complemento de modo que sea una ventana visible. Si este argumento es False o se omite, el complemento se abre como oculto y no se puede ocultar. Esta opción no se aplica a los complementos creados en Microsoft Excel 5.0 o posterior. Si el archivo es una plantilla de Excel, True para abrir la plantilla especificada para su edición. False para abrir un nuevo libro basado en la plantilla especificada. El valor predeterminado es False. |
| Notificar | Opcional | Variant | Si el archivo no se puede abrir en modo de lectura o escritura, este argumento es True para agregar el archivo a la lista de notificaciones de archivo. Microsoft Excel abrirá el archivo en modo de solo lectura, sondeará la lista de notificaciones de archivo y notificará al usuario cuando el archivo se haga disponible. Si este argumento es False o se omite, no se solicita ninguna notificación y se producirá un error al intentar archivos no disponibles. |
| Convertidor | Opcional | Variant | Índice del primer convertidor de archivos que se debe probar al abrir el archivo. El convertidor de archivos especificado se intenta en primer lugar; si el convertidor no reconoce el archivo, se prueban todos los demás convertidores. El índice del convertidor consta de los números de fila de los convertidores devueltos por la propiedad FileConverters . |
| AddToMru | Opcional | Variant | True para agregar este libro a la lista de archivos usados recientemente. El valor predeterminado es False. |
| Local | Opcional | Variant | True guarda los archivos contra el idioma de Microsoft Excel (incluida la configuración del panel de control). False (valor predeterminado) guarda los archivos contra el idioma de Visual Basic para aplicaciones (VBA) (que suele ser inglés (Estados Unidos) a menos que el proyecto de VBA en el que se ejecuta Workbooks.Open es de un proyecto de VBA para XL5/95 antiguo internacionalizado). |
| CorruptLoad | Opcional | XlCorruptLoad | Puede ser una de las constantes siguientes: xlNormalLoad, xlRepairFile y xlExtractData. El comportamiento predeterminado si no se especifica ningún valor es xlNormalLoad y no intenta la recuperación cuando se inicia a través del OM. |
Valor devuelto
Objeto Workbook que representa el libro abierto.
Comentarios
De manera predeterminada, las macros están habilitadas al abrir los archivos mediante programación. Use la propiedad AutomationSecurity para establecer el modo de seguridad de macros que se usa al abrir archivos mediante programación.
Puede especificar uno de los siguientes valores en el parámetro UpdateLinks para determinar si las referencias externas (vínculos) se actualizan cuando se abre el libro.
| Valor | Descripción |
|---|---|
| 0 | Las referencias externas (vínculos) no se actualizarán al abrirse el libro. |
| 3 | Las referencias externas (vínculos) se actualizarán al abrirse el libro. |
Puede especificar uno de los siguientes valores en el parámetro Format para determinar el carácter delimitador del archivo.
| Valor | Delimitador |
|---|---|
| 1 | Pestañas |
| 2 | Comas |
| 3 | Espacios |
| 4 | Punto y coma |
| 5 | Nothing |
| 6 | Carácter personalizado (consulte el argumento Delimiter) |
Ejemplo:
En el código de ejemplo siguiente, se abre el libro Analysis.xls y se ejecuta su macro Auto_abrir.
Workbooks.Open "ANALYSIS.XLS"
ActiveWorkbook.RunAutoMacros xlAutoOpen
En el código de ejemplo siguiente, se importa una hoja de otro libro en una hoja nueva del libro actual. Sheet1 del libro actual debe contener el nombre de la ruta de acceso del libro que se debe importar en la celda D3, el nombre de archivo en la celda D4 y el nombre de la hoja de cálculo en la celda D5. La hoja de cálculo importada se inserta después de Sheet1 en el libro actual.
Sub ImportWorksheet()
' This macro will import a file into this workbook
Sheets("Sheet1").Select
PathName = Range("D3").Value
Filename = Range("D4").Value
TabName = Range("D5").Value
ControlFile = ActiveWorkbook.Name
Workbooks.Open Filename:=PathName & Filename
ActiveSheet.Name = TabName
Sheets(TabName).Copy After:=Workbooks(ControlFile).Sheets(1)
Windows(Filename).Activate
ActiveWorkbook.Close SaveChanges:=False
Windows(ControlFile).Activate
End Sub
Soporte técnico y comentarios
¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.