FileSystem.MoveFile Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Move um arquivo para um novo local.
Sobrecargas
| Nome | Description |
|---|---|
| MoveFile(String, String) |
Move um arquivo para um novo local. |
| MoveFile(String, String, UIOption) |
Move um arquivo para um novo local. |
| MoveFile(String, String, Boolean) |
Move um arquivo para um novo local. |
| MoveFile(String, String, UIOption, UICancelOption) |
Move um arquivo para um novo local. |
MoveFile(String, String)
Move um arquivo para um novo local.
public:
static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName);public static void MoveFile(string sourceFileName, string destinationFileName);static member MoveFile : string * string -> unitPublic Shared Sub MoveFile (sourceFileName As String, destinationFileName As String)Parâmetros
- sourceFileName
- String
Caminho do arquivo a ser movido.
- destinationFileName
- String
Caminho do diretório para o qual o arquivo deve ser movido.
Exceções
O caminho não é válido por um dos seguintes motivos: é uma cadeia de caracteres de comprimento zero; ele contém apenas espaço em branco; ele contém caracteres inválidos; ou é um caminho do dispositivo (começa com \\.\); termina com uma barra à direita.
destinationFileName é ou uma Nothing cadeia de caracteres vazia.
O arquivo de origem não é válido ou não existe.
O arquivo está em uso por outro processo ou ocorre um erro de E/S.
O caminho excede o comprimento máximo definido pelo sistema.
Um nome de arquivo ou diretório no caminho contém dois-pontos (:) ou está em um formato inválido.
O usuário não tem permissões necessárias para exibir 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 arquivo Test.txt de TestDir1 para TestDir2 e renomeia-o Test2.txt.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Comentários
Se a estrutura de destino não existir, ela será criada.
O método MoveFile preserva ACEs (entradas de Controle de Acesso) somente ao mover o arquivo dentro do mesmo volume. Isso inclui ACEs herdadas, que se tornam ACEs diretas quando movidas (ACEs diretas têm precedência sobre ACEs herdadas). Se um arquivo for movido entre volumes, as ACEs não serão copiadas.
A tabela a seguir lista um exemplo de uma tarefa que envolve o My.Computer.FileSystem.MoveFile método.
| Para | Veja |
|---|---|
| Mover um arquivo | Como mover um arquivo em Visual Basic |
Aplica-se a
MoveFile(String, String, UIOption)
Move um arquivo para um novo local.
public:
static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);public static void MoveFile(string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);static member MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unitPublic Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)Parâmetros
- sourceFileName
- String
Caminho do arquivo a ser movido.
- destinationFileName
- String
Caminho do diretório para o qual o arquivo deve ser movido.
- showUI
- UIOption
Especifica se a operação deve acompanhar visualmente o progresso da operação. O padrão é UIOption.OnlyErrorDialogs.
Exceções
O caminho não é válido por um dos seguintes motivos: é uma cadeia de caracteres de comprimento zero; ele contém apenas espaço em branco; ele contém caracteres inválidos; ou é um caminho do dispositivo (começa com \\.\); termina com uma barra à direita.
destinationFileName é ou uma Nothing cadeia de caracteres vazia.
O arquivo de origem não é válido ou não existe.
O arquivo está em uso por outro processo ou ocorre um erro de E/S.
O caminho excede o comprimento máximo definido pelo sistema.
Um nome de arquivo ou diretório no caminho contém dois-pontos (:) ou está em um formato inválido.
O usuário não tem permissões necessárias para exibir 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 arquivo Test.txt de TestDir1 para TestDir2 e renomeia-o Test2.txt.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Comentários
Se a estrutura de destino não existir, ela será criada.
O método MoveFile preserva ACEs (entradas de Controle de Acesso) somente ao mover o arquivo dentro do mesmo volume. Isso inclui ACEs herdadas, que se tornam ACEs diretas quando movidas (ACEs diretas têm precedência sobre ACEs herdadas). Se um arquivo for movido entre volumes, as ACEs não serão copiadas.
A tabela a seguir lista um exemplo de uma tarefa que envolve o My.Computer.FileSystem.MoveFile método.
| Para | Veja |
|---|---|
| Mover um arquivo | Como mover um arquivo em Visual Basic |
Confira também
Aplica-se a
MoveFile(String, String, Boolean)
Move um arquivo para um novo local.
public:
static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, bool overwrite);public static void MoveFile(string sourceFileName, string destinationFileName, bool overwrite);static member MoveFile : string * string * bool -> unitPublic Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)Parâmetros
- sourceFileName
- String
Caminho do arquivo a ser movido.
- destinationFileName
- String
Caminho do diretório para o qual o arquivo deve ser movido.
- overwrite
- Boolean
True para substituir arquivos existentes; caso contrário False. O padrão é False.
Exceções
O caminho não é válido por um dos seguintes motivos: é uma cadeia de caracteres de comprimento zero; ele contém apenas espaço em branco; ele contém caracteres inválidos; ou é um caminho do dispositivo (começa com \\.\); termina com uma barra à direita.
destinationFileName é ou uma Nothing cadeia de caracteres vazia.
O arquivo de origem não é válido ou não existe.
O arquivo está em uso por outro processo ou ocorre um erro de E/S.
O caminho excede o comprimento máximo definido pelo sistema.
Um nome de arquivo ou diretório no caminho contém dois-pontos (:) ou está em um formato inválido.
O usuário não tem permissões necessárias para exibir 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 arquivo Test.txt de TestDir1 para TestDir2 e renomeia-o Test2.txt.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Comentários
Se a estrutura de destino não existir, ela será criada.
O método MoveFile preserva ACEs (entradas de Controle de Acesso) somente ao mover o arquivo dentro do mesmo volume. Isso inclui ACEs herdadas, que se tornam ACEs diretas quando movidas (ACEs diretas têm precedência sobre ACEs herdadas). Se um arquivo for movido entre volumes, as ACEs não serão copiadas.
A tabela a seguir lista um exemplo de uma tarefa que envolve o My.Computer.FileSystem.MoveFile método.
| Para | Veja |
|---|---|
| Mover um arquivo | Como mover um arquivo em Visual Basic |
Aplica-se a
MoveFile(String, String, UIOption, UICancelOption)
Move um arquivo para um novo local.
public:
static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);public static void MoveFile(string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);static member MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unitPublic Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption, onUserCancel As UICancelOption)Parâmetros
- sourceFileName
- String
Caminho do arquivo a ser movido.
- destinationFileName
- String
Caminho do diretório para o qual o arquivo deve ser movido.
- showUI
- UIOption
Especifica se a operação deve acompanhar visualmente o progresso da operação. O padrão é UIOption.OnlyErrorDialogs.
- onUserCancel
- UICancelOption
Especifica se uma exceção é gerada ou não quando o usuário cancela a operação. O padrão é UICancelOption.ThrowException.
Exceções
O caminho não é válido por um dos seguintes motivos: é uma cadeia de caracteres de comprimento zero; ele contém apenas espaço em branco; ele contém caracteres inválidos; ou é um caminho do dispositivo (começa com \\.\); termina com uma barra à direita.
destinationFileName é ou uma Nothing cadeia de caracteres vazia.
O arquivo de origem não é válido ou não existe.
O arquivo está em uso por outro processo ou ocorre um erro de E/S.
onUserCancel é definido como ThrowException, e o usuário cancelou a operação ou ocorre um erro de E/S não especificado.
O caminho excede o comprimento máximo definido pelo sistema.
Um nome de arquivo ou diretório no caminho contém dois-pontos (:) ou está em um formato inválido.
O usuário não tem permissões necessárias para exibir 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 arquivo Test.txt de TestDir1 para TestDir2 e renomeia-o Test2.txt.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Comentários
Se a estrutura de destino não existir, ela será criada.
O método MoveFile preserva ACEs (entradas de Controle de Acesso) somente ao mover o arquivo dentro do mesmo volume. Isso inclui ACEs herdadas, que se tornam ACEs diretas quando movidas (ACEs diretas têm precedência sobre ACEs herdadas). Se um arquivo for movido entre volumes, as ACEs não serão copiadas.
A tabela a seguir lista um exemplo de uma tarefa que envolve o My.Computer.FileSystem.MoveFile método.
| Para | Veja |
|---|---|
| Mover um arquivo | Como mover um arquivo em Visual Basic |