Condividi tramite

Metodo My.Computer.FileSystem.RenameDirectory

  • Articolo

Aggiornamento: novembre 2007

Rinomina una directory.

' Usage
My.Computer.FileSystem.RenameDirectory(directory ,newName)
' Declaration
Public Sub RenameDirectory( _
   ByVal directory As String, _
   ByVal newName As String _
)

Parametri

  • directory
    String. Percorso e nome della directory da rinominare. Obbligatorio.

  • newName
    String. Nuovo nome per la directory. Obbligatorio.

Eccezioni

Le seguenti condizioni possono generare un'eccezione:

  • Il percorso non è valido per uno dei seguenti motivi: è una stringa di lunghezza zero, contiene solo spazi vuoti, contiene caratteri non validi o è il percorso di una periferica, vale a dire inizia con \\.\ (ArgumentException).

  • Nel parametro newName sono contenute informazioni sul percorso (ArgumentException).

  • Il percorso non è valido in quanto Nothing (ArgumentNullException).

  • Il parametro newName è Nothing o una stringa vuota (ArgumentNullException).

  • La directory di origine non è valida o non esiste (DirectoryNotFoundException).

  • Un file o una directory già esistenti hanno il nome specificato in newName (IOException).

  • Si tratta di una directory principale (IOException).

  • La lunghezza del percorso supera i 248 caratteri (PathTooLongException).

  • Un nome di file o di directory nel percorso contiene i due punti (:) o ha un formato non valido (NotSupportedException).

  • L'utente non dispone delle autorizzazioni necessarie per visualizzare il percorso (SecurityException).

  • L'utente non dispone delle autorizzazioni necessarie (UnauthorizedAccessException).

Note

Non è possibile utilizzare il metodo per spostare una directory. Per spostare e rinominare una directory, utilizzare il metodo MoveDirectory.

Attività

Nella tabella riportata di seguito sono elencati esempi di attività relative al metodo My.Computer.FileSystem.RenameDirectory.

Per

Vedere

Rinominare una directory

Procedura: rinominare una directory in Visual Basic

Esempio

Nell'esempio la directory Test viene rinominata in SecondTest.

My.Computer.FileSystem.RenameDirectory("C:MyDocuments\Test", "SecondTest")

Requisiti

Spazio dei nomi:Microsoft.VisualBasic.MyServices

Classe:FileSystemProxy (fornisce l'accesso a FileSystem)

Assembly: libreria di runtime di Visual Basic (in Microsoft.VisualBasic.dll)

Disponibilità in base al tipo di progetto

Tipo di progetto

Disponibile

Applicazione Windows

Sì

Libreria di classi

Sì

Applicazione di console

Sì

Libreria di controlli Windows

Sì

Libreria di controllo Web

Sì

Servizio Windows

Sì

Sito Web

Sì

Autorizzazioni

Può essere necessaria l'autorizzazione seguente:

Autorizzazione

Descrizione

FileIOPermission

Controlla la possibilità di accedere ai file e alle cartelle. Enumerazione associata: Unrestricted.

Per ulteriori informazioni, vedere Protezione dall'accesso di codice e Richiesta di autorizzazioni.

Vedere anche

Attività

Procedura: analizzare percorsi di file in Visual Basic

Riferimenti

Oggetto My.Computer.FileSystem

RenameDirectory

Metodo My.Computer.FileSystem.MoveDirectory

Altre risorse

Creazione, eliminazione e spostamento di file e directory in Visual Basic