Método My.Computer.FileSystem.MoveFile

Artigo
08/25/2010

Move um arquivo para um novo local.

' Usage
My.Computer.FileSystem.MoveFile(sourceFileName ,destinationFileName)
My.Computer.FileSystem.MoveFile(sourceFileName ,destinationFileName ,overwrite)
My.Computer.FileSystem.MoveFile(sourceFileName ,destinationFileName ,showUI)
My.Computer.FileSystem.MoveFile(sourceFileName ,destinationFileName ,showUI ,onUserCancel)
' Declaration
Public Sub MoveFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String _
)
' -or-
Public Sub MoveFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String, _
   ByVal overwrite As Boolean _
)
' -or-
Public Sub MoveFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String, _
   ByVal showUI As UIOption _
)
' -or-
Public Sub MoveFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String, _
   ByVal showUI As UIOption, _
   ByVal onUserCancel As UICancelOption _
)

Parâmetros

sourceFileName
String.Caminho do arquivo a ser movido.Obrigatório.
destinationFileName
String.Caminho do diretório no qual o arquivo deve ser movido.Obrigatório.
overwrite
Boolean.Especifica se deve substituir arquivos existentes.O padrão é False.Obrigatório.
showUI
Enumeração UIOption.Especifica se deve ser rastreiem visualmente o progresso da operação.O padrão é UIOption.OnlyErrorDialogs.Obrigatório.
onUserCancel
Enumeração UICancelOption.Especifica se uma exceção é lançada quando o usuário cancela a operação.O padrão é UICancelOption.ThrowException.Obrigatório.

Exceções

As seguintes condições podem causar uma exceção:

O caminho inválido para um dos seguintes motivos: Ele é uma cadeia de comprimento zero; ele contém somente espaços em branco; ele contém caracteres inválidos; ou é um caminho de dispositivo (começa com \\.\) (ArgumentException).
O nome do arquivo termina com uma barra invertida (\) (ArgumentException).
O caminho não é válido porque ele é Nothing (ArgumentNullException).
destinationFileName é Nothing ou uma sequência vazia (ArgumentNullException).
O arquivo de origem não é válido ou não existe (FileNotFoundException).
O caminho combinado aponta para um diretório existente, o arquivo de destino existe e overwrite é conjunto para False, um arquivo no diretório de destino com o mesmo nome está em uso, ouo usuário não tem permissões suficientes para acessar o arquivo (IOException).
Um nome de arquivo ou de diretório no caminho contém dois-pontos (:) ou está em um formato inválido (NotSupportedException).
onUserCancel é definido como ThrowExceptione o usuário cancelou a operação ou ocorre de um erro de E/s não especificado ()OperationCanceledException).
O caminho excede o comprimento máximo definido pelo sistema (PathTooLongException).
O usuário não possui permissões necessárias para exibir o caminho (SecurityException).
O usuário não tem permissão necessária (UnauthorizedAccessException).

Comentários

Se a estrutura de destino não existir, ele será criado.

The MoveFile método preserva ACEs (entradas de controle de acesso) somente quando mover o arquivo dentro do mesmo volume. Isso inclui ACEs herdadas, que se tornam ACEs diretas quando movido (direta ACEs têm precedência sobre ACEs herdadas).Se um arquivo for movido entre volumes, ACEs não serão copiadas.

Tarefas

A tabela a seguir lista exemplos de tarefas envolvendo o método My.Computer.FileSystem.MoveFile.

Para	Consulte
Mover um arquivo.	Como: Mover um arquivo no Visual Basic
Como: mover uma coleção de arquivos	Como: Mover uma coleção de arquivos no Visual Basic
Para mover o conteúdo de um diretório	Como: Mover o conteúdo de um diretório no Visual Basic

Exemplo

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 o renomeia Test2.txt.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")

Requisitos

Namespace:Microsoft.VisualBasic.MyServices

Classe:FileSystemProxy (fornece acesso a FileSystem)

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Disponibilidade por Tipo de Projeto

Tipo de Projeto	Disponível
Aplicativo do Windows	Sim
Biblioteca de Classe	Sim
Aplicativo de Console	Sim
Biblioteca de Controle do Windows	Sim
Biblioteca de Controle da Web	Sim
Serviço do Windows	Sim
Site	Sim

Permissões

As seguintes permissões podem ser necessárias:

Permissão	Descrição
EnvironmentPermission	Controla a capacidade de acessar todas as variáveis de ambiente.Enumeração associada: Unrestricted.
FileIOPermission	Controla a habilidade de acesso a arquivos e pastas.Enumeração associada: Unrestricted.
RegistryPermission	Controla a capacidade de acessar as variáveis de registro.Enumeração associada: Unrestricted.
UIPermission	Controla as permissões relacionadas às interfaces com o usuário e área de transferência.Enumeração associada: SafeSubWindows.