FileSystemProxy.MoveFile Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Move um ficheiro para um novo local.
Sobrecargas
| Name | Description |
|---|---|
| MoveFile(String, String) |
Move um ficheiro para um novo local. |
| MoveFile(String, String, UIOption) |
Move um ficheiro para um novo local. |
| MoveFile(String, String, Boolean) |
Move um ficheiro para um novo local. |
| MoveFile(String, String, UIOption, UICancelOption) |
Move um ficheiro para um novo local. |
MoveFile(String, String)
Move um ficheiro para um novo local.
public:
void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName);public void MoveFile(string sourceFileName, string destinationFileName);member this.MoveFile : string * string -> unitPublic Sub MoveFile (sourceFileName As String, destinationFileName As String)Parâmetros
- sourceFileName
- String
Caminho do ficheiro a mover.
- destinationFileName
- String
Caminho do diretório para onde o ficheiro deve ser movido.
Exceções
O caminho não é válido por uma das seguintes razões: é uma cadeia de comprimento zero; contém apenas espaço em branco; contém caracteres inválidos; ou é um caminho de dispositivo (começa por \\.\); termina com um corte de arrasto.
destinationFileName é Nothing ou uma corda vazia.
O ficheiro fonte não é válido ou não existe.
O ficheiro é utilizado por outro processo, ou ocorre um erro de E/S.
O percurso excede o comprimento máximo definido pelo sistema.
Um nome de ficheiro ou diretório no caminho contém dois pontos (:) ou está num formato inválido.
O utilizador não tem as permissões necessárias para visualizar o caminho.
Exemplos
Este exemplo move o arquivo Test.txt de TestDir1 para TestDir2.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")
Este exemplo move o ficheiro Test.txt de TestDir1 para TestDir2 e renomeia-o Test2.txtpara .
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Observações
Se a estrutura alvo não existir, ela é criada.
O método MoveFile preserva ACEs (Entradas Controlo de Acesso) apenas ao mover o ficheiro dentro do mesmo volume. Isto inclui as ACEs herdadas, que se tornam ACEs diretas quando transferidas (as ACEs diretas têm precedência sobre as ACEs herdadas). Se um ficheiro for movido entre volumes, os ACEs não serão copiados.
A tabela seguinte apresenta um exemplo de uma tarefa envolvendo o My.Computer.FileSystem.MoveFile método.
| Para | Veja |
|---|---|
| Mover um ficheiro | Como: Mover um arquivo |
Ver também
Aplica-se a
MoveFile(String, String, UIOption)
Move um ficheiro para um novo local.
public:
void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);public void MoveFile(string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);member this.MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unitPublic Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)Parâmetros
- sourceFileName
- String
Caminho do ficheiro a mover.
- destinationFileName
- String
Caminho do diretório para onde o ficheiro deve ser movido.
- showUI
- UIOption
Especifica se deve acompanhar visualmente o progresso da operação. A predefinição é UIOption.OnlyErrorDialogs.
Exceções
O caminho não é válido por uma das seguintes razões: é uma cadeia de comprimento zero; contém apenas espaço em branco; contém caracteres inválidos; ou é um caminho de dispositivo (começa por \\.\); termina com um corte de arrasto.
destinationFileName é Nothing ou uma corda vazia.
O ficheiro fonte não é válido ou não existe.
O ficheiro é utilizado por outro processo, ou ocorre um erro de E/S.
O percurso excede o comprimento máximo definido pelo sistema.
Um nome de ficheiro ou diretório no caminho contém dois pontos (:) ou está num formato inválido.
O utilizador não tem as permissões necessárias para visualizar o caminho.
Exemplos
Este exemplo move o arquivo Test.txt de TestDir1 para TestDir2.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")
Este exemplo move o ficheiro Test.txt de TestDir1 para TestDir2 e renomeia-o Test2.txtpara .
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Observações
Se a estrutura alvo não existir, ela é criada.
O método MoveFile preserva ACEs (Entradas Controlo de Acesso) apenas ao mover o ficheiro dentro do mesmo volume. Isto inclui as ACEs herdadas, que se tornam ACEs diretas quando transferidas (as ACEs diretas têm precedência sobre as ACEs herdadas). Se um ficheiro for movido entre volumes, os ACEs não serão copiados.
A tabela seguinte apresenta um exemplo de uma tarefa envolvendo o My.Computer.FileSystem.MoveFile método.
| Para | Veja |
|---|---|
| Mover um ficheiro | Como: Mover um arquivo |
Ver também
Aplica-se a
MoveFile(String, String, Boolean)
Move um ficheiro para um novo local.
public:
void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, bool overwrite);public void MoveFile(string sourceFileName, string destinationFileName, bool overwrite);member this.MoveFile : string * string * bool -> unitPublic Sub MoveFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)Parâmetros
- sourceFileName
- String
Caminho do ficheiro a mover.
- destinationFileName
- String
Caminho do diretório para onde o ficheiro deve ser movido.
- overwrite
- Boolean
True sobrescrever ficheiros existentes; caso contrário False. A predefinição é False.
Exceções
O caminho não é válido por uma das seguintes razões: é uma cadeia de comprimento zero; contém apenas espaço em branco; contém caracteres inválidos; ou é um caminho de dispositivo (começa por \\.\); termina com um corte de arrasto.
destinationFileName é Nothing ou uma corda vazia.
O ficheiro fonte não é válido ou não existe.
O ficheiro é utilizado por outro processo, ou ocorre um erro de E/S.
O percurso excede o comprimento máximo definido pelo sistema.
Um nome de ficheiro ou diretório no caminho contém dois pontos (:) ou está num formato inválido.
O utilizador não tem as permissões necessárias para visualizar o caminho.
Exemplos
Este exemplo move o arquivo Test.txt de TestDir1 para TestDir2.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")
Este exemplo move o ficheiro Test.txt de TestDir1 para TestDir2 e renomeia-o Test2.txtpara .
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Observações
Se a estrutura alvo não existir, ela é criada.
O método MoveFile preserva ACEs (Entradas Controlo de Acesso) apenas ao mover o ficheiro dentro do mesmo volume. Isto inclui as ACEs herdadas, que se tornam ACEs diretas quando transferidas (as ACEs diretas têm precedência sobre as ACEs herdadas). Se um ficheiro for movido entre volumes, os ACEs não serão copiados.
A tabela seguinte lista exemplos de uma tarefa envolvendo o My.Computer.FileSystem.MoveFile método.
| Para | Veja |
|---|---|
| Mover um ficheiro | Como: Mover um arquivo |
Ver também
Aplica-se a
MoveFile(String, String, UIOption, UICancelOption)
Move um ficheiro para um novo local.
public:
void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);public void MoveFile(string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);member this.MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unitPublic Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption, onUserCancel As UICancelOption)Parâmetros
- sourceFileName
- String
Caminho do ficheiro a mover.
- destinationFileName
- String
Caminho do diretório para onde o ficheiro deve ser movido.
- showUI
- UIOption
Especifica se deve acompanhar visualmente o progresso da operação. A predefinição é UIOption.OnlyErrorDialogs.
- onUserCancel
- UICancelOption
Especifica se uma exceção é lançada quando o utilizador cancela a operação. A predefinição é UICancelOption.ThrowException.
Exceções
O caminho não é válido por uma das seguintes razões: é uma cadeia de comprimento zero; contém apenas espaço em branco; contém caracteres inválidos; ou é um caminho de dispositivo (começa por \\.\); termina com um corte de arrasto.
destinationFileName é Nothing ou uma corda vazia.
O ficheiro fonte não é válido ou não existe.
O ficheiro é utilizado por outro processo, ou ocorre um erro de E/S.
onUserCancel está definido para ThrowException, e ou o utilizador cancelou a operação ou ocorre um erro de E/S não especificado.
O percurso excede o comprimento máximo definido pelo sistema.
Um nome de ficheiro ou diretório no caminho contém dois pontos (:) ou está num formato inválido.
O utilizador não tem as permissões necessárias para visualizar o caminho.
Exemplos
Este exemplo move o arquivo Test.txt de TestDir1 para TestDir2.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")
Este exemplo move o ficheiro Test.txt de TestDir1 para TestDir2 e renomeia-o Test2.txtpara .
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Observações
Se a estrutura alvo não existir, ela é criada.
O método MoveFile preserva ACEs (Entradas Controlo de Acesso) apenas ao mover o ficheiro dentro do mesmo volume. Isto inclui as ACEs herdadas, que se tornam ACEs diretas quando transferidas (as ACEs diretas têm precedência sobre as ACEs herdadas). Se um ficheiro for movido entre volumes, os ACEs não serão copiados.
A tabela seguinte apresenta um exemplo de uma tarefa envolvendo o My.Computer.FileSystem.MoveFile método.
| Para | Veja |
|---|---|
| Mover um ficheiro | Como: Mover um arquivo |