Método Workbooks. Open (Excel)Workbooks.Open method (Excel)

Abre un libro.Opens a workbook.

Nota

¿Le interesa el desarrollo de soluciones que amplían la experiencia de Office en varias plataformas?Interested in developing solutions that extend the Office experience across multiple platforms? Vea el nuevo modelo de complementos de Office.Check out the new Office Add-ins model. Los complementos de Office tienen una pequeña superficie en comparación con los complementos y las soluciones de VSTO y puede compilarlos con casi cualquier tecnología de programación web, como HTML5, JavaScript, CSS3 y XML.Office Add-ins have a small footprint compared to VSTO Add-ins and solutions, and you can build them by using almost any web programming technology, such as HTML5, JavaScript, CSS3, and XML.

SintaxisSyntax

expresión. Abrir (Filename, UpdateLinks, ReadOnly, Format, password, WriteResPassword, IgnoreReadOnlyRecommended, Origin, __ delimiter, editable, _Notify _, Convertidor, AddToMru, local, CorruptLoad)expression.Open (FileName, UpdateLinks, ReadOnly, Format, Password, WriteResPassword, IgnoreReadOnlyRecommended, Origin, Delimiter, Editable, Notify, Converter, AddToMru, Local, CorruptLoad)

expresión Variable que representa un objeto Workbooks .expression A variable that represents a Workbooks object.

ParámetrosParameters

NombreName Obligatorio/opcionalRequired/Optional Tipo de datosData type DescripciónDescription
FileNameFileName OpcionalOptional VariantVariant Cadena.String. El nombre de archivo del libro que se debe abrir.The file name of the workbook to be opened.
UpdateLinksUpdateLinks OpcionalOptional VariantVariant Especifica la forma en que se actualizan las referencias externas (vínculos) del archivo, como la referencia a un rango en el libro Budget. xls =SUM([Budget.xls]Annual!C10:C25)en la fórmula siguiente.Specifies the way external references (links) in the file, such as the reference to a range in the Budget.xls workbook in the following formula =SUM([Budget.xls]Annual!C10:C25), are updated. Si no se especifica este argumento, se pide al usuario que especifique cómo se deben actualizar los vínculos.If this argument is omitted, the user is prompted to specify how links will be updated. Para obtener más información acerca de los valores que se usan con este parámetro, vea la sección de comentarios.For more information about the values used by this parameter, see the Remarks section.

Si Microsoft Excel abre un archivo en formato WKS, WK1 o WK3 y el argumento UpdateLinks es 0, no se creará ningún gráfico; de lo contrario, Microsoft Excel genera gráficos a partir de los gráficos adjuntos al archivo.If Microsoft Excel is opening a file in the WKS, WK1, or WK3 format and the UpdateLinks argument is 0, no charts are created; otherwise, Microsoft Excel generates charts from the graphs attached to the file.
ReadOnlyReadOnly OpcionalOptional VariantVariant True para abrir el libro en modo de solo lectura.True to open the workbook in read-only mode.
FormatFormat OpcionalOptional VariantVariant Si Microsoft Excel abre un archivo de texto, este argumento especifica el carácter delimitador.If Microsoft Excel opens a text file, this argument specifies the delimiter character. Si este argumento se omite, se usará el delimitador actual.If this argument is omitted, the current delimiter is used. Para obtener más información sobre los valores que usa este parámetro, consulte la sección Comentarios.For more information about the values used by this parameter, see the Remarks section.
PasswordPassword OpcionalOptional VariantVariant Cadena que contiene la contraseña necesaria para abrir un libro protegido.A string that contains the password required to open a protected workbook. Si este argumento se omite y el libro requiere contraseña, se solicita al usuario que especifique la contraseña.If this argument is omitted and the workbook requires a password, the user is prompted for the password.
WriteResPasswordWriteResPassword OpcionalOptional VariantVariant Cadena que contiene la contraseña necesaria para abrir un libro protegido contra escritura.A string that contains the password required to write to a write-reserved workbook. Si este argumento se omite y el libro requiere contraseña, se solicita al usuario que especifique la contraseña.If this argument is omitted and the workbook requires a password, the user will be prompted for the password.
IgnoreReadOnlyRecommendedIgnoreReadOnlyRecommended OpcionalOptional VariantVariant 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).True to have Microsoft Excel not display the read-only recommended message (if the workbook was saved with the Read-Only Recommended option).
OrígenesOrigin OpcionalOptional VariantVariant 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.If the file is a text file, this argument indicates where it originated, so that code pages and Carriage Return/Line Feed (CR/LF) can be mapped correctly. Puede ser una de las siguientes constantes XlPlatform : xlMacintosh, xlWindowso xlMSDOS.Can be one of the following XlPlatform constants: xlMacintosh, xlWindows, or xlMSDOS. Si este argumento se omite, se usará el sistema operativo actual.If this argument is omitted, the current operating system is used.
DelimitadorDelimiter OpcionalOptional VariantVariant Si el archivo es un archivo de texto y el argumento de formato es 6, este argumento es una cadena que especifica el carácter que se va a utilizar como delimitador.If the file is a text file and the Format argument is 6, this argument is a string that specifies the character to be used as the delimiter. Por ejemplo, use Chr(9) para tabulaciones, use "," para comas, use ";" para puntos y coma o use un carácter personalizado.For example, use Chr(9) for tabs, use "," for commas, use ";" for semicolons, or use a custom character. Solo se usa el primer carácter de la cadena.Only the first character of the string is used.
EditableEditable OpcionalOptional VariantVariant Si el archivo es un complemento de Microsoft Excel 4,0, este argumento es true para abrir el complemento para que sea una ventana visible.If the file is a Microsoft Excel 4.0 add-in, this argument is True to open the add-in so that it is a visible window. Si este argumento es false o se omite, el complemento se abre como oculto y no se puede mostrar.If this argument is False or omitted, the add-in is opened as hidden, and it cannot be unhidden. Esta opción no se aplica a complementos creados en Microsoft Excel 5,0 o posterior.This option does not apply to add-ins created in Microsoft Excel 5.0 or later.

Si el archivo es una plantilla de Excel, true para abrir la plantilla especificada para su edición.If the file is an Excel template, True to open the specified template for editing. False para abrir un nuevo libro basado en la plantilla especificada.False to open a new workbook based on the specified template. El valor predeterminado es False.The default value is False.
NotifyNotify OpcionalOptional VariantVariant 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.If the file cannot be opened in read/write mode, this argument is True to add the file to the file notification list. 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.Microsoft Excel will open the file as read-only, poll the file notification list, and then notify the user when the file becomes available. Si este argumento es False o se omite, no se solicita ninguna notificación y se producirá un error al intentar archivos no disponibles.If this argument is False or omitted, no notification is requested, and any attempts to open an unavailable file will fail.
CatalizaConverter OpcionalOptional VariantVariant Índice del primer convertidor de archivos que se debe probar al abrir el archivo.The index of the first file converter to try when opening the file. El convertidor de archivos especificado se intenta en primer lugar; si el convertidor no reconoce el archivo, se prueban todos los demás convertidores.The specified file converter is tried first; if this converter does not recognize the file, all other converters are tried. El índice del convertidor consta de los números de fila de los convertidores devueltos por la propiedad FileConverters .The converter index consists of the row numbers of the converters returned by the FileConverters property.
AddToMruAddToMru OpcionalOptional VariantVariant True para agregar este libro a la lista de archivos usados recientemente.True to add this workbook to the list of recently used files. El valor predeterminado es False.The default value is False.
LocalLocal OpcionalOptional VariantVariant True guarda los archivos contra el idioma de Microsoft Excel (incluida la configuración del panel de control).True saves files against the language of Microsoft Excel (including control panel settings). 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).False (default) saves files against the language of Visual Basic for Applications (VBA) (which is typically United States English unless the VBA project where Workbooks.Open is run from is an old internationalized XL5/95 VBA project).
CorruptLoadCorruptLoad OpcionalOptional XlCorruptLoadXlCorruptLoad Puede ser una de las constantes siguientes: xlNormalLoad, xlRepairFile y xlExtractData.Can be one of the following constants: xlNormalLoad, xlRepairFile and xlExtractData. El comportamiento predeterminado si no se especifica ningún valor es xlNormalLoady no intenta recuperarse cuando se inicia a través del OM.The default behavior if no value is specified is xlNormalLoad, and does not attempt recovery when initiated through the OM.

Valor devueltoReturn value

Objeto Workbook que representa el libro abierto.A Workbook object that represents the opened workbook.

ComentariosRemarks

De manera predeterminada, las macros están habilitadas al abrir los archivos mediante programación.By default, macros are enabled when opening files programmatically. Use la propiedad AutomationSecurity para establecer el modo de seguridad de macros que se utiliza al abrir archivos mediante programación.Use the AutomationSecurity property to set the macro security mode used when opening files programmatically.

Puede especificar uno de los valores siguientes en el parámetro UpdateLinks para determinar si las referencias externas (vínculos) se actualizan al abrir el libro.You can specify one of the following values in the UpdateLinks parameter to determine whether external references (links) are updated when the workbook is opened.

ValorValue DescripciónDescription
comprendi0 Las referencias externas (vínculos) no se actualizarán al abrirse el libro.External references (links) will not be updated when the workbook is opened.
3 3 Las referencias externas (vínculos) se actualizarán al abrirse el libro.External references (links) will be updated when the workbook is opened.

Puede especificar uno de los valores siguientes en el parámetro Format para determinar el carácter delimitador del archivo.You can specify one of the following values in the Format parameter to determine the delimiter character for the file.

ValorValue DelimitadorDelimiter
1 1 PestañasTabs
2 2 ComasCommas
3 3 EspaciosSpaces
4 4 Punto y comaSemicolons
5 5 NothingNothing
6 6 Carácter personalizado (consulte el argumento Delimiter)Custom character (see the Delimiter argument)

EjemploExample

En el código de ejemplo siguiente, se abre el libro Analysis.xls y se ejecuta su macro Auto_abrir.The following code example opens the workbook Analysis.xls and then runs its Auto_Open macro.

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.The following code example imports a sheet from another workbook onto a new sheet in the current workbook. 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.Sheet1 in the current workbook must contain the path name of the workbook to import in cell D3, the file name in cell D4, and the worksheet name in cell D5. La hoja de cálculo importada se inserta después de Sheet1 en el libro actual.The imported worksheet is inserted after Sheet1 in the current workbook.

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 comentariosSupport and feedback

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación?Have questions or feedback about Office VBA or this documentation? 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.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.