FileSystem.Rename(String, String) Yöntem
Tanım
Ö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
Ö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.