Workbooks.Open Método

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Abre uma pasta de trabalho.

public Microsoft.Office.Interop.Excel.Workbook Open (string Filename, object UpdateLinks, object ReadOnly, object Format, object Password, object WriteResPassword, object IgnoreReadOnlyRecommended, object Origin, object Delimiter, object Editable, object Notify, object Converter, object AddToMru, object Local, object CorruptLoad);

Public Function Open (Filename As String, Optional UpdateLinks As Object, Optional ReadOnly As Object, Optional Format As Object, Optional Password As Object, Optional WriteResPassword As Object, Optional IgnoreReadOnlyRecommended As Object, Optional Origin As Object, Optional Delimiter As Object, Optional Editable As Object, Optional Notify As Object, Optional Converter As Object, Optional AddToMru As Object, Optional Local As Object, Optional CorruptLoad As Object) As Workbook

Parâmetros

Filename

String

String necessário. O nome de arquivo da pasta de trabalho a ser aberta.

UpdateLinks

Object

Objeto opcional. Especifica a forma como os links no arquivo são atualizados. Se esse argumento for omitido, será solicitado que o usuário especifique como os links serão atualizados. Caso contrário, esse argumento é um dos valores listados na tabela a seguir. Se o Microsoft Excel estiver abrindo um arquivo no formato WKS, WK1 ou WK3 e o argumento for 2, o UpdateLinks Microsoft Excel gerará gráficos dos grafos anexados ao arquivo. Se o argumento for 0, nenhum gráfico será criado.

ReadOnly

Object

Objeto opcional. Verdadeiro para abrir a pasta de trabalho em modo somente leitura.

Format

Object

Objeto opcional. Se o Microsoft Excel estiver abrindo um arquivo de texto, esse argumento especifica o caractere delimitador, conforme mostrado na tabela a seguir. Se esse argumento for omitido, o delimitador atual será usado.

Password

Object

Objeto opcional. Uma cadeia de caracteres que contém a senha necessária para abrir uma pasta de trabalho protegida. Se esse argumento for omitido e a pasta de trabalho exigir uma senha, será solicitada a senha do usuário.

WriteResPassword

Object

Objeto opcional. Uma cadeia de caracteres que contém a senha necessária para gravar uma pasta de trabalho reservada para gravação. Se esse argumento for omitido e se a pasta de trabalho exigir uma senha, a senha será solicitada do usuário.

IgnoreReadOnlyRecommended

Object

Objeto opcional. True para fazer com que o Microsoft Excel não exiba a mensagem recomendada somente leitura (se a pasta de trabalho tiver sido salva com a opção Somente Leitura Recomendada).

Origin

Object

Objeto opcional. Se o arquivo for um arquivo de texto, esse argumento indicará de onde ele se originou (para que páginas de código e Cr/LF (Feed de Retorno/Linha de Transporte) possam ser mapeados corretamente). Pode ser uma das seguintes XlPlatform constantes: xlMacintosh, xlWindows ou xlMSDOS. Se esse argumento for omitido, o sistema operacional atual será usado.

Delimiter

Object

Objeto opcional. Se o arquivo for um arquivo de texto e o argumento Formatar for 6, esse argumento será uma cadeia de caracteres que especifica o caractere a ser usado como delimitador. Por exemplo, use Chr(9) para guias, use "" para vírgulas, use ";" para ponto e vírgula ou use um caractere personalizado. Somente o primeiro caractere da cadeia de caracteres será usado.

Editable

Object

Objeto opcional. Se o arquivo for um suplemento do Microsoft Excel 4.0, esse argumento será True para abrir o suplemento para que ele seja uma janela visível. Se esse argumento for False ou se for omitido, o suplemento será aberto como oculto e não poderá ser reexibido. Essa opção não se aplica a suplementos criados no Microsoft Excel 5.0 ou posterior. Se o arquivo for um modelo do Excel, use True para abrir o modelo especificado para edição ou False para abrir uma nova pasta de trabalho com base no modelo especificado. O valor padrão é False.

Notify

Object

Objeto opcional. Se o arquivo não puder ser aberto em modo leitura/gravação, esse argumento será True para adicionar o arquivo para a lista de notificações de arquivo. O Microsoft Excel abrirá o arquivo como somente leitura, pesquisará a lista de notificações de arquivo e então notificará o usuário quando o arquivo for disponibilizado. Se esse argumento for False ou se for omitido, nenhuma notificação será solicitada e todas as tentativas de abrir um arquivo não disponível falharão.

Converter

Object

Objeto opcional. O índice do primeiro conversor de arquivos a ser experimentado na abertura do arquivo. O conversor de arquivos especificado é testado primeiro; se esse conversor não reconhecer o arquivo, todos os outros conversores serão julgados. O índice de conversor consiste nos números de linha dos conversores retornados pela FileConverters[Object, Object] propriedade.

AddToMru

Object

Objeto opcional. True para adicionar esta pasta de trabalho à lista de arquivos usados recentemente. O valor padrão é False.

Local

Object

Objeto opcional. True salva arquivos no idioma do Microsoft Excel (incluindo as configurações do painel de controle). False (padrão) salva arquivos na linguagem de Visual Basic for Applications (VBA) (que normalmente é inglês dos EUA, a menos que o projeto VBA do qual Workbooks.Open é executado seja um projeto antigo de VBA xl5/95 internacionalizado).

CorruptLoad

Object

Objeto opcional. Pode ser uma das seguintes constantes: xlNormalLoad, xlRepairFile e xlExtractData. O comportamento padrão se nenhum valor for especificado geralmente é normal, mas pode ser uma carga segura ou recuperação de dados se o Excel já tiver tentado abrir o arquivo. A primeira tentativa é normal. Se o Excel parar de operar durante a abertura do arquivo, a segunda tentativa será a carga segura. Se o Excel parar novamente de operar, a próxima tentativa será a recuperação de dados.

Retornos

Workbook

Comentários

Por padrão, as macros são habilitadas na abertura programática dos arquivos. Use a AutomationSecurity propriedade para definir o modo de segurança de macro usado ao abrir arquivos programaticamente.