Método MoveRecord (ADO)
Aplica-se ao: Access 2013, Office 2013
Move a entidade representada por um Record para outro local.
Sintaxe
Gravar. MoveRecord (Fonte, Destino, Nome de Usuário, Senha, Opções, Assíncrono)
Parâmetros
| Parâmetro | Descrição |
|---|---|
| Source | Opcional. Um valor String que contém uma URL que identifica o Record a ser movido. Se Source for omitido ou especificar uma sequência 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 o ID de usuário que, se necessário, autoriza acesso ao Destination. |
| Password | Opcional. Uma String que contém a senha que, se necessária, verifica UserName. |
| Options | Opcional. Um valor MoveRecordOptionsEnum cujo valor padrão é adMoveUnspecified. Especifica o comportamento deste método. |
| Async | Opcional. Um valor booliano que, quando True, especifica essa operação deve ser assíncrono. |
Valor de retorno
Um valor String. Normalmente, o valor de 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 utilizando-se o Internet Publishing Provider, este método atualiza todos os links de hipertexto nos arquivos que estão sendo movidos, a menos que especificado o contrário por Options. Este método falha se Destination identificar um objeto existente (por exemplo, um arquivo ou diretório), a menos que adMoveOverWrite seja especificado.
Observação
[!OBSERVAçãO] Utilize a opção adMoveOverWrite criteriosamente. Por exemplo, especificar essa opção ao mover um arquivo para um diretório irá excluir o diretório e substituí-lo pelo arquivo.
Alguns atributos do objeto Record, tal 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, em seguida, reabrindo-o com a URL do local em que o arquivo ou diretório foi movido.
Se esse Record foi obtido de um Recordset, o novo local do arquivo ou diretório movido não será refletido imediatamente no Recordset. Atualize o Recordset fechando e reabrindo o mesmo.
Observação
[!OBSERVAçãO] URLs using the http scheme will automatically invoke the Microsoft OLE DB Provider for Internet Publishing. Para obter mais informações, consulte URLs absolutas e relativas.