FileSystem.Rename(String, String) Yöntem

Tanım

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

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

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

Özel durumlar

Yol geçersiz.

OldPath dosyası yok.

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

İşlev birRename 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 yalnızca hem hem de NewPathOldPath aynı sürücüde bulunduğunda var olan bir dizini yeniden adlandırabilir. Rename yeni bir dosya veya dizin oluşturamıyor.

İşlevi Rename açık bir dosyada kullanmak bir hataya neden olur. Açık bir dosyayı yeniden adlandırmadan önce kapatmalısınız. Rename bağımsız değişkenler birden çok karakterli (*) ve tek karakterli (?) joker karakterler içeremez.

Important

Korumalı olmayan bir konumdan korumalı bir konuma dosya kopyalamak için kullanılırken Rename , dosya daha az kısıtlanmış hakları korur. Olası bir güvenlik riskiyle karşı karşıya olmadığınızı denetleyin.

Şunlara uygulanır

Ayrıca bkz.