Método MoveRecord (ADO)

Move a entidade representada por uma de Registro de para outro local.

Sintaxe

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

Parâmetros

de origem
Opcional. Um valor String que contém uma URL que identifica o registro a ser movido. Se de origem for omitido ou especificar uma cadeia de caracteres vazia, o objeto representado por este de Registro será movido. Por exemplo, se o registro representar um arquivo, o conteúdo do arquivo será movido para o local especificado pelo Destination.

de destino do
Opcional. Um valor String que contém uma URL especificando o local em que de origem será movido.

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

de senha
Opcional. Um de cadeia de caracteres de que contém a senha que, se necessário, verifica username.

opções de
Opcional. Um valor MoveRecordOptionsEnum cujo valor padrão é adMoveUnspecified. Especifica o comportamento desse método.

Assíncrona
Opcional. Um valor booliano que, quando True, especifica que essa operação deve ser assíncrona.

Valor retornado

Um valor de cadeia de caracteres. Normalmente, o valor da de Destino é retornado. No entanto, o valor exato retornado depende do provedor.

Observações

Os valores de de origem e de destino de 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 especificado de outra forma pelo Options. Esse método falhará se Destination identificar um objeto existente (por exemplo, um arquivo ou diretório), a menos que adMoveOverWrite seja especificado.

Nota

Use a opção adMoveOverWrite criteriosamente. Por exemplo, especificar essa opção ao mover um arquivo para um diretório excluirá o diretório e o substituirá pelo arquivo.

Determinados atributos do objeto Record, como a propriedade ParentURL, não serão atualizados após a conclusão desta operação. Atualize as propriedades do Registro objeto fechando a de Registroe abrindo novamente com a URL do local para onde o arquivo ou diretório foi movido.

Se esse de Registro tiver sido obtido de um Recordset, o novo local do arquivo ou diretório movido não será refletido imediatamente no do conjunto de registros. Atualize o conjunto de registros fechando-o e abrindo-o novamente.

Nota

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, consulte URLs absolutas e relativas.

Aplica-se a

do objeto de registro (ADO)

Consulte Também

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