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

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

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çimde) içeriyor.

SecurityException

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.

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.

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 .

Amaç	Bkz.
Dosyayı taşıma	Nasıl Yapılır: Visual Basic'te Dosya Taşıma

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

Özel durumlar

ArgumentException

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.

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çimde) içeriyor.

SecurityException

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.

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.

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 .

Amaç	Bkz.
Dosyayı taşıma	Nasıl Yapılır: Visual Basic'te Dosya Taşıma

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

Özel durumlar

ArgumentException

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.

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çimde) içeriyor.

SecurityException

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.

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.

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 .

Amaç	Bkz.
Dosyayı taşıma	Nasıl Yapılır: Visual Basic'te Dosya Taşıma

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

ArgumentException

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.

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 belirtilmemiş bir 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çimde) içeriyor.

SecurityException

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.

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.

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 .

Amaç	Bkz.
Dosyayı taşıma	Nasıl Yapılır: Visual Basic'te Dosya Taşıma

Ayrıca bkz.

• UIOption
• UICancelOption