Aracılığıyla paylaş


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

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

Ö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

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

Ayrıca bkz.