FileSystemProxy.MoveFile Método

Definição

Namespace:

Microsoft.VisualBasic.MyServices

Assembly:

Microsoft.VisualBasic.Forms.dll

Move um arquivo para um novo local.

Sobrecargas

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:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName);

public void MoveFile (string sourceFileName, string destinationFileName);

member this.MoveFile : string * string -> unit

Public 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

ArgumentException

O caminho não é válido por um dos seguintes motivos: é uma cadeia de comprimento zero, contém apenas espaços em branco, contém caracteres inválidos ou é um caminho de dispositivo (começa com \\.\); ele termina com uma barra à direita.

ArgumentNullException

destinationFileName é Nothing ou é uma cadeia de caracteres vazia.

FileNotFoundException

O arquivo de origem não é válido ou não existe.

IOException

O arquivo está sendo usado por outro processo, ou ocorre um erro de E/S.

PathTooLongException

O caminho excede o tamanho máximo definido pelo sistema.

NotSupportedException

Um nome de arquivo ou de diretório no caminho contém dois-pontos (:) ou está em um formato inválido.

SecurityException

O usuário não tem as 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 o renomeia 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 MoveFile método preserva ACEs (entradas Controle de Acesso) somente ao mover o arquivo dentro do mesmo volume. Isso inclui ACEs herdadas, que se tornam ACEs diretas quando movidos (ACEs diretos têm precedência sobre ACEs herdados). 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	Consulte
Mover um arquivo	Como: mover um arquivo

Confira também

• Objetos (Visual Basic)
• Criando, excluindo e movendo arquivos e diretórios no Visual Basic

MoveFile(String, String, UIOption)

Move um arquivo 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 -> unit

Public 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 o progresso da operação deve ser acompanhado visualmente. O padrão é UIOption.OnlyErrorDialogs.

Exceções

ArgumentException

O caminho não é válido por um dos seguintes motivos: é uma cadeia de comprimento zero, contém apenas espaços em branco, contém caracteres inválidos ou é um caminho de dispositivo (começa com \\.\); ele termina com uma barra à direita.

ArgumentNullException

destinationFileName é Nothing ou é uma cadeia de caracteres vazia.

FileNotFoundException

O arquivo de origem não é válido ou não existe.

IOException

O arquivo está sendo usado por outro processo, ou ocorre um erro de E/S.

PathTooLongException

O caminho excede o tamanho máximo definido pelo sistema.

NotSupportedException

Um nome de arquivo ou de diretório no caminho contém dois-pontos (:) ou está em um formato inválido.

SecurityException

O usuário não tem as 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 o renomeia 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 MoveFile método preserva ACEs (entradas Controle de Acesso) somente ao mover o arquivo dentro do mesmo volume. Isso inclui ACEs herdadas, que se tornam ACEs diretas quando movidos (ACEs diretos têm precedência sobre ACEs herdados). 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	Consulte
Mover um arquivo	Como: mover um arquivo

Confira também

• UIOption
• Objetos (Visual Basic)
• Criando, excluindo e movendo arquivos e diretórios no Visual Basic

MoveFile(String, String, Boolean)

Move um arquivo 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 -> unit

Public 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

ArgumentException

O caminho não é válido por um dos seguintes motivos: é uma cadeia de comprimento zero, contém apenas espaços em branco, contém caracteres inválidos ou é um caminho de dispositivo (começa com \\.\); ele termina com uma barra à direita.

ArgumentNullException

destinationFileName é Nothing ou é uma cadeia de caracteres vazia.

FileNotFoundException

O arquivo de origem não é válido ou não existe.

IOException

O arquivo está sendo usado por outro processo, ou ocorre um erro de E/S.

PathTooLongException

O caminho excede o tamanho máximo definido pelo sistema.

NotSupportedException

Um nome de arquivo ou de diretório no caminho contém dois-pontos (:) ou está em um formato inválido.

SecurityException

O usuário não tem as 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 o renomeia 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 MoveFile método preserva ACEs (entradas Controle de Acesso) somente ao mover o arquivo dentro do mesmo volume. Isso inclui ACEs herdadas, que se tornam ACEs diretas quando movidos (ACEs diretos têm precedência sobre ACEs herdados). 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	Consulte
Mover um arquivo	Como: mover um arquivo

Confira também

• Objetos (Visual Basic)
• Criando, excluindo e movendo arquivos e diretórios no Visual Basic

MoveFile(String, String, UIOption, UICancelOption)

Move um arquivo 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 -> unit

Public 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 o progresso da operação deve ser acompanhado visualmente. O padrão é UIOption.OnlyErrorDialogs.

onUserCancel

UICancelOption

Especifica se uma exceção é lançada ou não quando o usuário cancela a operação. O padrão é UICancelOption.ThrowException.

Exceções

ArgumentException

O caminho não é válido por um dos seguintes motivos: é uma cadeia de comprimento zero, contém apenas espaços em branco, contém caracteres inválidos ou é um caminho de dispositivo (começa com \\.\); ele termina com uma barra à direita.

ArgumentNullException

destinationFileName é Nothing ou é uma cadeia de caracteres vazia.

FileNotFoundException

O arquivo de origem não é válido ou não existe.

IOException

O arquivo está sendo usado por outro processo, ou ocorre um erro de E/S.

OperationCanceledException

onUserCancel é definido como ThrowException e o usuário cancelou a operação ou ocorreu um erro de E/S não especificado.

PathTooLongException

O caminho excede o tamanho máximo definido pelo sistema.

NotSupportedException

Um nome de arquivo ou de diretório no caminho contém dois-pontos (:) ou está em um formato inválido.

SecurityException

O usuário não tem as 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 o renomeia 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 MoveFile método preserva ACEs (Controle de Acesso Entradas) somente ao mover o arquivo dentro do mesmo volume. Isso inclui ACEs herdados, que se tornam ACEs diretos quando movidos (ACEs diretos têm precedência sobre ACEs herdados). Se um arquivo for movido entre volumes, os ACEs não serão copiados.

A tabela a seguir lista um exemplo de uma tarefa envolvendo o My.Computer.FileSystem.MoveFile método .

Para	Consulte
Mover um arquivo	Como: mover um arquivo

Confira também

• UIOption
• UICancelOption
• Criando, excluindo e movendo arquivos e diretórios no Visual Basic