Método SaveToFile (ADO)

Aplica-se ao: Access 2013, Office 2013

Salva o conteúdo binário de um Stream para um arquivo.

Sintaxe

Stream. SaveToFileFileName, SaveOptions

Parâmetros

Parâmetro	Descrição
FileName	Um valor String que contém o nome totalmente qualificado do arquivo no qual o conteúdo do Stream será salvo. É possível salvar em qualquer localidade local válida ou em qualquer local que você tenha acesso por um valor de UNC.
Saveoptions	Um valor SaveOptionsEnum que especifica se um novo arquivo deve ser criado por SaveToFile, se ele ainda não existir. O valor padrão é adSaveCreateNotExists. Com essas opções, é possível especificar que ocorre um erro se o arquivo especificado não existir. Também é possível especificar se SaveToFile sobrescreve o conteúdo atual de um arquivo existente.

Observação

Se você sobrescrever um arquivo existente (quando adSaveCreateOverwrite estiver definido), SaveToFile truncará quaisquer bytes do arquivo existente original que seguem o novo EOS.

Comentários

SaveToFile pode ser utilizado para copiar o conteúdo de um objeto Stream para um arquivo local. Não há alteração no conteúdo ou nas propriedades do objeto Stream. O objeto Stream deve estar aberto antes de chamar SaveToFile.

Este método não altera a associação do objeto Stream com sua fonte base. O objeto Stream ainda estará associado à URL original ou ao Record que era sua fonte quando foi aberto.

Após uma operação SaveToFile, a posição atual (Position) no fluxo será definida para o início do fluxo (0).