Compartilhar via


Método SaveToFile

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

Sintaxe

  
Stream.SaveToFile FileName, SaveOptions  

Parâmetros

filename
Um valor String que contém o nome totalmente qualificado do arquivo no qual o conteúdo do Stream será salvo. Você pode salvar em qualquer local válido ou em qualquer local ao qual tenha acesso por meio de um valor UNC.

SaveOptions
Um valor SaveOptionsEnum que especifica se um novo arquivo deve ser criado por SaveToFile, caso ainda não exista. O valor padrão é adSaveCreateNotExists. Com essas opções, você pode especificar que ocorrerá um erro se o arquivo especificado não existir. Você também pode especificar que SaveToFile substitui o conteúdo atual de um arquivo existente.

Nota

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

Observações

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

Esse método não altera a associação do objeto Stream à fonte subjacente. O objeto Stream ainda será associado à URL original ou de Registro que era sua origem quando aberto.

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

Aplica-se a

objeto stream (ADO)

Consulte Também

do método Open (Fluxo do ADO)
salvar método