FileSystem.MoveFile Yöntem

Tanım

Ad Alanı:

Microsoft.VisualBasic.FileIO

Bütünleştirilmiş Kod:

Microsoft.VisualBasic.Core.dll

Dosyayı yeni bir konuma taşır.

Aşırı Yüklemeler

Name	Description
MoveFile(String, String)	Dosyayı yeni bir konuma taşır.
MoveFile(String, String, UIOption)	Dosyayı yeni bir konuma taşır.
MoveFile(String, String, Boolean)	Dosyayı yeni bir konuma taşır.
MoveFile(String, String, UIOption, UICancelOption)	Dosyayı yeni bir konuma taşır.

MoveFile(String, String)

Kaynak:

FileSystem.vb

Dosyayı yeni bir konuma taşır.

public:
 static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName);

public static void MoveFile(string sourceFileName, string destinationFileName);

static member MoveFile : string * string -> unit

Public Shared Sub MoveFile (sourceFileName As String, destinationFileName As String)

Parametreler

sourceFileName

String

Taşınacak dosyanın yolu.

destinationFileName

String

Dosyanın taşınması gereken dizinin yolu.

Özel durumlar

ArgumentException

Yol aşağıdaki nedenlerden biri için geçerli değil: sıfır uzunluklu bir dizedir; yalnızca boşluk içerir; geçersiz karakterler içeriyor; veya bir cihaz yoludur (\\.\ile başlar); sondaki eğik çizgiyle biter.

ArgumentNullException

destinationFileName veya Nothing boş bir dizedir.

FileNotFoundException

Kaynak dosya geçerli değil veya yok.

IOException

Dosya başka bir işlem tarafından kullanılıyor veya G/Ç hatası oluşuyor.

PathTooLongException

Yol, sistem tarafından tanımlanan uzunluk üst sınırını aşıyor.

NotSupportedException

Yoldaki bir dosya veya dizin adı iki nokta üst üste (:) veya geçersiz biçimdedir) içeriyor.

SecurityException

Kullanıcı, yolu görüntülemek için gerekli izinlere sahip değil.

Örnekler

Bu örnek, dosyayı Test.txt konumundan TestDir1 konumuna taşır.

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

Bu örnek, dosyasını Test.txt öğesine TestDir1TestDir2 taşır ve olarak yeniden adlandırır Test2.txt.

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

Açıklamalar

Hedef yapı yoksa oluşturulur.

MoveFile yöntemi, yalnızca dosyayı aynı birim içinde taşırken ACL'leri (Access Control Girdileri) korur. Bu, taşındığında doğrudan ACL'ler haline gelen devralınan ACL'leri içerir (doğrudan ACL'ler devralınan ACL'lere göre önceliklidir). Bir dosya birimler arasında taşınırsa, ACL'ler kopyalanmaz.

Aşağıdaki tabloda, yöntemini içeren bir görev örneği listeleniyor My.Computer.FileSystem.MoveFile .

İçin	Bkz:
Dosyayı taşıma	H nasıl yapılır: dosyayı Visual Basic

MoveFile(String, String, UIOption)

Kaynak:

FileSystem.vb

Dosyayı yeni bir konuma taşır.

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 -> unit

Public Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)

Parametreler

sourceFileName

String

Taşınacak dosyanın yolu.

destinationFileName

String

Dosyanın taşınması gereken dizinin yolu.

showUI

UIOption

İşlemin ilerleme durumunun görsel olarak izlenip izlenmeyeceğini belirtir. Varsayılan UIOption.OnlyErrorDialogs değeridir.

Özel durumlar

ArgumentException

Yol aşağıdaki nedenlerden biri için geçerli değil: sıfır uzunluklu bir dizedir; yalnızca boşluk içerir; geçersiz karakterler içeriyor; veya bir cihaz yoludur (\\.\ile başlar); sondaki eğik çizgiyle biter.

ArgumentNullException

destinationFileName veya Nothing boş bir dizedir.

FileNotFoundException

Kaynak dosya geçerli değil veya yok.

IOException

Dosya başka bir işlem tarafından kullanılıyor veya G/Ç hatası oluşuyor.

PathTooLongException

Yol, sistem tarafından tanımlanan uzunluk üst sınırını aşıyor.

NotSupportedException

Yoldaki bir dosya veya dizin adı iki nokta üst üste (:) veya geçersiz biçimdedir) içeriyor.

SecurityException

Kullanıcı, yolu görüntülemek için gerekli izinlere sahip değil.

Örnekler

Bu örnek, dosyayı Test.txt konumundan TestDir1 konumuna taşır.

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

Bu örnek, dosyasını Test.txt öğesine TestDir1TestDir2 taşır ve olarak yeniden adlandırır Test2.txt.

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

Açıklamalar

Hedef yapı yoksa oluşturulur.

MoveFile yöntemi, yalnızca dosyayı aynı birim içinde taşırken ACL'leri (Access Control Girdileri) korur. Bu, taşındığında doğrudan ACL'ler haline gelen devralınan ACL'leri içerir (doğrudan ACL'ler devralınan ACL'lere göre önceliklidir). Bir dosya birimler arasında taşınırsa, ACL'ler kopyalanmaz.

Aşağıdaki tabloda, yöntemini içeren bir görev örneği listeleniyor My.Computer.FileSystem.MoveFile .

İçin	Bkz:
Dosyayı taşıma	H nasıl yapılır: dosyayı Visual Basic

Ayrıca bkz.

• UIOption

MoveFile(String, String, Boolean)

Kaynak:

FileSystem.vb

Dosyayı yeni bir konuma taşır.

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 -> unit

Public Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)

Parametreler

sourceFileName

String

Taşınacak dosyanın yolu.

destinationFileName

String

Dosyanın taşınması gereken dizinin yolu.

overwrite

Boolean

True varolan dosyaların üzerine yazmak için; aksi takdirde False. Varsayılan False değeridir.

Özel durumlar

ArgumentException

Yol aşağıdaki nedenlerden biri için geçerli değil: sıfır uzunluklu bir dizedir; yalnızca boşluk içerir; geçersiz karakterler içeriyor; veya bir cihaz yoludur (\\.\ile başlar); sondaki eğik çizgiyle biter.

ArgumentNullException

destinationFileName veya Nothing boş bir dizedir.

FileNotFoundException

Kaynak dosya geçerli değil veya yok.

IOException

Dosya başka bir işlem tarafından kullanılıyor veya G/Ç hatası oluşuyor.

PathTooLongException

Yol, sistem tarafından tanımlanan uzunluk üst sınırını aşıyor.

NotSupportedException

Yoldaki bir dosya veya dizin adı iki nokta üst üste (:) veya geçersiz biçimdedir) içeriyor.

SecurityException

Kullanıcı, yolu görüntülemek için gerekli izinlere sahip değil.

Örnekler

Bu örnek, dosyayı Test.txt konumundan TestDir1 konumuna taşır.

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

Bu örnek, dosyasını Test.txt öğesine TestDir1TestDir2 taşır ve olarak yeniden adlandırır Test2.txt.

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

Açıklamalar

Hedef yapı yoksa oluşturulur.

MoveFile yöntemi, yalnızca dosyayı aynı birim içinde taşırken ACL'leri (Access Control Girdileri) korur. Bu, taşındığında doğrudan ACL'ler haline gelen devralınan ACL'leri içerir (doğrudan ACL'ler devralınan ACL'lere göre önceliklidir). Bir dosya birimler arasında taşınırsa, ACL'ler kopyalanmaz.

Aşağıdaki tabloda, yöntemini içeren bir görev örneği listeleniyor My.Computer.FileSystem.MoveFile .

İçin	Bkz:
Dosyayı taşıma	H nasıl yapılır: dosyayı Visual Basic

MoveFile(String, String, UIOption, UICancelOption)

Kaynak:

FileSystem.vb

Dosyayı yeni bir konuma taşır.

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 -> unit

Public Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption, onUserCancel As UICancelOption)

Parametreler

sourceFileName

String

Taşınacak dosyanın yolu.

destinationFileName

String

Dosyanın taşınması gereken dizinin yolu.

showUI

UIOption

İşlemin ilerleme durumunun görsel olarak izlenip izlenmeyeceğini belirtir. Varsayılan UIOption.OnlyErrorDialogs değeridir.

onUserCancel

UICancelOption

Kullanıcı işlemi iptal ettiğinde bir özel durum oluşturup oluşturmayacağını belirtir. Varsayılan UICancelOption.ThrowException değeridir.

Özel durumlar

ArgumentException

Yol aşağıdaki nedenlerden biri için geçerli değil: sıfır uzunluklu bir dizedir; yalnızca boşluk içerir; geçersiz karakterler içeriyor; veya bir cihaz yoludur (\\.\ile başlar); sondaki eğik çizgiyle biter.

ArgumentNullException

destinationFileName veya Nothing boş bir dizedir.

FileNotFoundException

Kaynak dosya geçerli değil veya yok.

IOException

Dosya başka bir işlem tarafından kullanılıyor veya G/Ç hatası oluşuyor.

OperationCanceledException

onUserCancel olarak ayarlanır ThrowExceptionve kullanıcı işlemi iptal etti veya belirtilmeyen bir G/Ç hatası oluşur.

PathTooLongException

Yol, sistem tarafından tanımlanan uzunluk üst sınırını aşıyor.

NotSupportedException

Yoldaki bir dosya veya dizin adı iki nokta üst üste (:) veya geçersiz biçimdedir) içeriyor.

SecurityException

Kullanıcı, yolu görüntülemek için gerekli izinlere sahip değil.

Örnekler

Bu örnek, dosyayı Test.txt konumundan TestDir1 konumuna taşır.

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

Bu örnek, dosyasını Test.txt öğesine TestDir1TestDir2 taşır ve olarak yeniden adlandırır Test2.txt.

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

Açıklamalar

Hedef yapı yoksa oluşturulur.

MoveFile yöntemi, yalnızca dosyayı aynı birim içinde taşırken ACL'leri (Access Control Girdileri) korur. Bu, taşındığında doğrudan ACL'ler haline gelen devralınan ACL'leri içerir (doğrudan ACL'ler devralınan ACL'lere göre önceliklidir). Bir dosya birimler arasında taşınırsa, ACL'ler kopyalanmaz.

Aşağıdaki tabloda, yöntemini içeren bir görev örneği listeleniyor My.Computer.FileSystem.MoveFile .

İçin	Bkz:
Dosyayı taşıma	H nasıl yapılır: dosyayı Visual Basic

Ayrıca bkz.

• UIOption
• UICancelOption