FileSystem.MoveFile Yöntem

Tanım

Dosyayı yeni bir konuma taşır.

Aşırı Yüklemeler

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
Kaynak:
FileSystem.vb
Kaynak:
FileSystem.vb

Dosyayı yeni bir konuma taşır.

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

Parametreler

sourceFileName
String

Taşınacak dosyanın yolu.

destinationFileName
String

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

Özel durumlar

Yol aşağıdaki nedenlerden biri için geçerli değildir: 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.

destinationFileName veya Nothing boş bir dizedir.

Kaynak dosya geçerli değil veya yok.

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

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

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

Kullanıcının yolu görüntülemek için gerekli izinleri yok.

Örnekler

Bu örnek, dosyasını Test.txt dosyasından TestDir1 öğesine TestDir2taşır.

VB
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.

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

Açıklamalar

Hedef yapı yoksa oluşturulur.

yöntemi yalnızca MoveFile dosyayı aynı birim içinde taşırken ACL'leri (Access Control Girdileri) korur. Bu, taşındığında doğrudan ACL'lere dönüşen 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 listeledik My.Computer.FileSystem.MoveFile .

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

MoveFile(String, String, UIOption)

Kaynak:
FileSystem.vb
Kaynak:
FileSystem.vb
Kaynak:
FileSystem.vb

Dosyayı yeni bir konuma taşır.

C#
public static void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);

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. UIOption.OnlyErrorDialogs varsayılan değerdir.

Özel durumlar

Yol aşağıdaki nedenlerden biri için geçerli değildir: 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.

destinationFileName veya Nothing boş bir dizedir.

Kaynak dosya geçerli değil veya yok.

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

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

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

Kullanıcının yolu görüntülemek için gerekli izinleri yok.

Örnekler

Bu örnek, dosyasını Test.txt dosyasından TestDir1 öğesine TestDir2taşır.

VB
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.

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

Açıklamalar

Hedef yapı yoksa oluşturulur.

yöntemi yalnızca MoveFile dosyayı aynı birim içinde taşırken ACL'leri (Access Control Girdileri) korur. Bu, taşındığında doğrudan ACL'lere dönüşen 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 listeledik My.Computer.FileSystem.MoveFile .

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

MoveFile(String, String, Boolean)

Kaynak:
FileSystem.vb
Kaynak:
FileSystem.vb
Kaynak:
FileSystem.vb

Dosyayı yeni bir konuma taşır.

C#
public static void MoveFile (string sourceFileName, string destinationFileName, bool overwrite);

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. False varsayılan değerdir.

Özel durumlar

Yol aşağıdaki nedenlerden biri için geçerli değildir: 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.

destinationFileName veya Nothing boş bir dizedir.

Kaynak dosya geçerli değil veya yok.

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

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

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

Kullanıcının yolu görüntülemek için gerekli izinleri yok.

Örnekler

Bu örnek, dosyasını Test.txt dosyasından TestDir1 öğesine TestDir2taşır.

VB
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.

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

Açıklamalar

Hedef yapı yoksa oluşturulur.

yöntemi yalnızca MoveFile dosyayı aynı birim içinde taşırken ACL'leri (Access Control Girdileri) korur. Bu, taşındığında doğrudan ACL'lere dönüşen 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 listeledik My.Computer.FileSystem.MoveFile .

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

MoveFile(String, String, UIOption, UICancelOption)

Kaynak:
FileSystem.vb
Kaynak:
FileSystem.vb
Kaynak:
FileSystem.vb

Dosyayı yeni bir konuma taşır.

C#
public static void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

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. UIOption.OnlyErrorDialogs varsayılan değerdir.

onUserCancel
UICancelOption

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

Özel durumlar

Yol aşağıdaki nedenlerden biri için geçerli değildir: 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.

destinationFileName veya Nothing boş bir dizedir.

Kaynak dosya geçerli değil veya yok.

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

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

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

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

Kullanıcının yolu görüntülemek için gerekli izinleri yok.

Örnekler

Bu örnek, dosyasını Test.txt dosyasından TestDir1 öğesine TestDir2taşır.

VB
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.

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

Açıklamalar

Hedef yapı yoksa oluşturulur.

yöntemi yalnızca MoveFile dosyayı aynı birim içinde taşırken ACL'leri (Access Control Girdileri) korur. Bu, taşındığında doğrudan ACL'lere dönüşen 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 listeledik My.Computer.FileSystem.MoveFile .

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1