Método MoveRecord (ADO)

Move a entidade representada por um Record para outro local.

Sintaxe

  
Record.MoveRecord (Source, Destination, UserName, Password, Options, Async)  

Parâmetros

Origem
Opcional. Um valor String com uma URL que identifica o Record a ser movido. Se Source for omitido ou especificar uma cadeia de caracteres vazia, o objeto representado por este Record será movido. Por exemplo, se o Record representar um arquivo, o conteúdo do arquivo será movido para o local especificado por Destination.

Destino
Opcional. Um valor String que contém uma URL que especifica o local em que Source será movido.

UserName
Opcional. Um valor String que contém a ID do usuário que, se necessário, autoriza o acesso a Destination.

Senha
Opcional. Um String que contém a senha que, se necessário, verifica UserName.

Opções
Opcional. Um valor MoveRecordOptionsEnum cujo valor padrão é adMoveUnspecified. Especifica o comportamento deste método.

Async
Opcional. Um valor Boolean que, quando definido como True, especifica que essa operação deve ser assíncrona.

Valor de retorno

Um valor de String. Normalmente, o valor Destination é retornado. No entanto, o valor exato retornado depende do provedor.

Comentários

Os valores de Source e Destination não devem ser idênticos; caso contrário, ocorrerá um erro em tempo de execução. Pelo menos os nomes de servidor, caminho e recurso devem ser diferentes.

Para arquivos movidos usando o Provedor de Publicação da Internet, esse método atualiza todos os links de hipertexto em arquivos que estão sendo movidos, a menos que especificados de outra forma por Options. Esse método falhará se Destination identificar um objeto existente (por exemplo, um arquivo ou diretório), a menos que adMoveOverWrite seja especificado.

Observação

Use a opção adMoveOverWrite criteriosamente. Por exemplo, especificar essa opção ao mover um arquivo para um diretório vai excluir o diretório e substituí-lo pelo arquivo.

Determinados atributos do objeto Record, como a propriedade ParentURL, não serão atualizados após a conclusão dessa operação. Atualize as propriedades do objeto Record fechando o Record e abrindo-o novamente com a URL do local em que o arquivo ou diretório foi movido.

Se esse Record tiver sido obtido de um Recordset, o novo local do arquivo ou diretório movido não será refletido imediatamente no Recordset. Para atualizar o Recordset, feche-o e abra-o novamente.

Observação

As URLs que usam o esquema HTTP invocarão automaticamente o Provedor Microsoft OLE DB para Publicação na Internet. Para obter mais informações, confira URLs absolutas e relativas.

Aplica-se A

Objeto Record (ADO)

Consulte Também

Método Move (ADO)
Métodos MoveFirst, MoveLast, MoveNext e MovePrevious (ADO)
Métodos MoveFirst, MoveLast, MoveNext e MovePrevious (RDS)