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
Consulte Também
Método Move (ADO)
Métodos MoveFirst, MoveLast, MoveNext e MovePrevious (ADO)
Métodos MoveFirst, MoveLast, MoveNext e MovePrevious (RDS)