FileSystem.Rename(String, String) Yöntem

Başvuru

Tanım

Ad Alanı:: Microsoft.VisualBasic

Bütünleştirilmiş Kod:: Microsoft.VisualBasic.Core.dll

Bütünleştirilmiş Kod:: Microsoft.VisualBasic.dll

Kaynak:: FileSystem.vb

Kaynak:: FileSystem.vb

Kaynak:: FileSystem.vb

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Disk dosyasını veya dizinini yeniden adlandırır. Bu My özellik, dosya G/Ç işlemlerinde Renamedaha iyi üretkenlik ve performans sağlar. Daha fazla bilgi için bkz. FileSystem.

public:
 static void Rename(System::String ^ OldPath, System::String ^ NewPath);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static void Rename (string OldPath, string NewPath);

public static void Rename (string OldPath, string NewPath);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Rename : string * string -> unit

static member Rename : string * string -> unit

Public Sub Rename (OldPath As String, NewPath As String)

Parametreler

OldPath: String

Gereklidir. Var olan dosya adını ve konumunu belirten bir dize ifadesi. OldPath dosyanın dizinini ve sürücüsünü içerebilir.

NewPath: String

Gereklidir. Yeni dosya adını ve konumunu belirten bir dize ifadesi. NewPath hedef konumun dizinini ve sürücüsünü içerebilir. tarafından NewPath belirtilen dosya adı zaten var olamaz.

Öznitelikler: SupportedOSPlatformAttribute

Özel durumlar

ArgumentException

Yol geçersiz.

FileNotFoundException

OldPath dosyası yok.

IOException

Farklı bir cihaza yeniden adlandırılamıyor.

Örnekler

Bu örnek, Rename bir dosyayı yeniden adlandırmak için işlevini kullanır. Bu örneğin amaçları doğrultusunda, belirtilen dizinlerin zaten var olduğunu varsayalım.

Dim OldName, NewName As String
OldName = "OLDFILE"
' Define file names.
NewName = "NEWFILE"
' Rename file.
Rename(OldName, NewName)

OldName = "C:\OLDDIR\OLDFILE"
NewName = "C:\NEWDIR\NEWFILE"
' Move and rename file.
Rename(OldName, NewName)

Açıklamalar

Rename İşlev bir dosyayı yeniden adlandırır ve gerekirse farklı bir dizine taşır. Rename İşlev, bir dosyayı sürücüler arasında taşıyabilir, ancak var olan bir dizini yalnızca hem OldPath hem de NewPath aynı sürücüde bulunduğunda yeniden adlandırabilir. Rename yeni bir dosya veya dizin oluşturamıyor.

açık bir dosyada işlevinin Rename kullanılması hataya neden olur. Açık bir dosyayı yeniden adlandırmadan önce kapatmanız gerekir. Rename bağımsız değişkenler birden çok karakterli (*) ve tek karakterli (?) joker karakterler içeremez.

Önemli

Korumalı olmayan bir konumdan korumalı bir konuma dosya kopyalamak için kullanıldığında Rename , dosya daha az kısıtlanmış hakları korur. Olası bir güvenlik riski getirmediğinizden emin olun.

Şunlara uygulanır

Aracılığıyla paylaş