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. É possível salvar em qualquer local válido ou ao qual você tenha acesso por meio de um valor UNC.

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

Observação

Em caso de substituição de um arquivo existente (quando adSaveCreateOverwrite estiver definido), SaveToFile irá truncar quaisquer bytes do arquivo existente original que seguem o novo EOS.

Comentários

SaveToFile pode ser usado 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 ser aberto antes de chamar SaveToFile.

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

Após uma operação 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

Método Open (Fluxo do ADO)
Método Save