Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Path classe

 

Date de publication : novembre 2016

Effectue des opérations sur des instances de String qui contiennent des informations relatives au chemin d'accès d'un fichier ou d'un répertoire. Ces opérations sont effectuées différemment selon la plateforme.

Pour parcourir le code source .NET Framework pour ce type, consultez la Reference Source.

Espace de noms:   System.IO
Assembly:  mscorlib (dans mscorlib.dll)


[ComVisibleAttribute(true)]
public static class Path

NomDescription
System_CAPS_pubmethodSystem_CAPS_staticChangeExtension(String, String)

Modifie l’extension d’une chaîne de chemin d’accès.

System_CAPS_pubmethodSystem_CAPS_staticCombine(String, String)

Combine deux chaînes de caractères en un chemin d'accès.

System_CAPS_pubmethodSystem_CAPS_staticCombine(String, String, String)

Combine trois chaînes en un chemin d'accès.

System_CAPS_pubmethodSystem_CAPS_staticCombine(String, String, String, String)

Combine quatre chaînes en un chemin d'accès.

System_CAPS_pubmethodSystem_CAPS_staticCombine(String[])

Combine un tableau de chaînes en un chemin d’accès.

System_CAPS_pubmethodSystem_CAPS_staticGetDirectoryName(String)

Retourne les informations relatives au répertoire pour la chaîne de chemin d’accès spécifiée.

System_CAPS_pubmethodSystem_CAPS_staticGetExtension(String)

Retourne l’extension de la chaîne de chemin d’accès spécifiée.

System_CAPS_pubmethodSystem_CAPS_staticGetFileName(String)

Retourne le nom et l’extension de fichier de la chaîne de chemin d’accès spécifiée.

System_CAPS_pubmethodSystem_CAPS_staticGetFileNameWithoutExtension(String)

Retourne le nom de fichier de la chaîne de chemin d’accès spécifiée sans l’extension.

System_CAPS_pubmethodSystem_CAPS_staticGetFullPath(String)

Retourne le chemin d’accès absolu de la chaîne de chemin d’accès spécifiée.

System_CAPS_pubmethodSystem_CAPS_staticGetInvalidFileNameChars()

Obtient un tableau contenant les caractères qui ne sont pas autorisés dans les noms de fichiers.

System_CAPS_pubmethodSystem_CAPS_staticGetInvalidPathChars()

Obtient un tableau contenant les caractères qui ne sont pas autorisés dans les noms de chemins d’accès.

System_CAPS_pubmethodSystem_CAPS_staticGetPathRoot(String)

Obtient les informations relatives au répertoire racine du chemin d’accès spécifié.

System_CAPS_pubmethodSystem_CAPS_staticGetRandomFileName()

Retourne un nom de dossier ou de fichier aléatoire.

System_CAPS_pubmethodSystem_CAPS_staticGetTempFileName()

Crée un fichier temporaire de zéro octet nommé de façon univoque sur le disque et retourne le chemin d’accès complet de ce fichier.

System_CAPS_pubmethodSystem_CAPS_staticGetTempPath()

Retourne le chemin d’accès du dossier temporaire de l’utilisateur actuel.

System_CAPS_pubmethodSystem_CAPS_staticHasExtension(String)

Détermine si un chemin d’accès inclut une extension de nom de fichier.

System_CAPS_pubmethodSystem_CAPS_staticIsPathRooted(String)

Obtient une valeur indiquant si la chaîne de chemin d’accès spécifiée contient une racine.

NomDescription
System_CAPS_pubfieldSystem_CAPS_staticAltDirectorySeparatorChar

Fournit un caractère de remplacement spécifique à la plateforme, utilisé pour séparer les niveaux de répertoire dans une chaîne de chemin d'accès qui reflète une organisation de système de fichiers hiérarchique.

System_CAPS_pubfieldSystem_CAPS_staticDirectorySeparatorChar

Fournit un caractère spécifique à la plateforme, utilisé pour séparer les niveaux de répertoire dans une chaîne de chemin d'accès qui reflète une organisation de système de fichiers hiérarchique.

System_CAPS_pubfieldSystem_CAPS_staticInvalidPathChars

Obsolète. Fournit un tableau de caractères (spécifique à la plateforme) qui ne peuvent pas être spécifiés dans des arguments de chaîne de chemin d'accès passés aux membres de la classe Path.

System_CAPS_pubfieldSystem_CAPS_staticPathSeparator

Caractère de séparation spécifique à la plateforme, utilisé pour séparer les chaînes de chemin d’accès dans les variables d’environnement.

System_CAPS_pubfieldSystem_CAPS_staticVolumeSeparatorChar

Fournit un caractère de séparation de volume spécifique à la plateforme.

System_CAPS_noteRemarque

Pour afficher le code source .NET Framework pour ce type, consultez la Reference Source. Vous pouvez parcourir le code source en ligne, télécharger la référence hors connexion et parcourir les sources (y compris les correctifs et mises à jour) pendant le débogage ; see instructions.

Le .NET Framework ne prend pas en charge l’accès direct aux disques physiques via les chemins d’accès qui sont des noms de périphériques, tels que « \\.\PHYSICALDRIVE0 ».

Un chemin d’accès est une chaîne qui fournit l’emplacement d’un fichier ou répertoire. Un chemin d’accès ne pointe pas nécessairement vers un emplacement sur le disque ; par exemple, un chemin d’accès peut mapper à un emplacement en mémoire ou sur un périphérique. Le format exact d’un chemin d’accès est déterminé par la plateforme actuelle. Par exemple, sur certains systèmes, un chemin d’accès peut commencer par une lettre de lecteur ou le volume, alors que cet élément n’est pas présent dans d’autres systèmes. Sur certains systèmes, les chemins d’accès peuvent contenir des extensions, qui indiquent le type d’informations stockées dans le fichier. Le format d’une extension de nom de fichier est dépendante de la plateforme ; par exemple, certains systèmes limitent les extensions à trois caractères, et d’autres ne le font pas. La plateforme actuelle détermine également le jeu de caractères utilisé pour séparer les éléments d’un chemin d’accès et le jeu de caractères qui ne peut pas être utilisé lors de la spécification de chemins d’accès. En raison de ces différences, les champs de la Path classe, ainsi que le comportement exact de certains membres de la Path classe sont dépendants de la plateforme.

Un chemin d’accès peut contenir des informations d’emplacement absolu ou relatif. Chemins d’accès absolus spécifient un emplacement : le fichier ou le répertoire peut être identifiée, quelle que soit l’emplacement actuel. Chemins d’accès relatifs spécifient un emplacement partiel : l’emplacement actuel est utilisé comme point de départ lors de la localisation d’un fichier spécifié avec un chemin d’accès relatif. Pour déterminer le répertoire actif, appelez Directory.GetCurrentDirectory.

La plupart des membres de la Path classe n’interagissent pas avec le système de fichiers et ne vérifient pas l’existence du fichier spécifié par une chaîne de chemin d’accès. Path classe les membres qui modifient une chaîne de chemin d’accès, tel que ChangeExtension, n’ont aucun effet sur les noms de fichiers dans le système de fichiers. Path membres de faire, toutefois, valider le contenu d’une chaîne de chemin d’accès spécifié et lever une ArgumentException exception si la chaîne contient des caractères qui ne sont pas valides dans les chaînes de chemin d’accès, comme défini dans les caractères renvoyés à partir de la GetInvalidPathChars méthode. Par exemple, sur les plateformes de bureau Windows, les caractères de chemin non valide peuvent inclure guillemet («), inférieur à (<), supérieur à (>), barre verticale (|), retour arrière (\b), valeur null (\0) et les caractères Unicode 16 à 18 et 20 25 via.

Les membres de la Path classe permettent d’exécuter rapidement et facilement des opérations courantes telles que déterminer si une extension de nom de fichier fait partie d’un chemin d’accès et de combiner deux chaînes en un chemin d’accès.

Tous les membres de la Path classe sont statique et peuvent donc être appelés sans disposer d’une instance d’un chemin d’accès.

System_CAPS_noteRemarque

Dans les membres qui acceptent un chemin d’accès sous forme de chaîne d’entrée, ce chemin d’accès doit être correctement construit, ou une exception est levée. Par exemple, si un chemin d’accès est qualifié complet mais commence par un espace, le chemin d’accès n’est pas tronqué dans les méthodes de la classe. Par conséquent, le chemin d’accès est incorrect et une exception est levée. De même, un chemin d’accès ou une combinaison de chemins d’accès ne peut pas être qualifiée complet deux fois. Par exemple, « c:\temp c:\windows » génère également une exception dans la plupart des cas. Assurez-vous que vos chemins d’accès sont corrects lors de l’utilisation des méthodes qui acceptent une chaîne de chemin d’accès.

Dans les membres qui acceptent un chemin d’accès, le chemin d’accès peut faire référence à un fichier ou simplement à un répertoire. Le chemin d’accès spécifié peut également faire référence à un chemin d’accès relatif ou un chemin d’accès Universal Naming Convention (UNC) pour un nom de serveur et de partage. Par exemple, tous les éléments suivants sont des chemins d’accès acceptables :

  • « c:\\MyDir\\MyFile.txt » en c# ou « c:\MyDir\MyFile.txt » en Visual Basic.

  • « c:\\MyDir » en c# ou « c:\MyDir » en Visual Basic.

  • « C:\\monRépertoire\\monSousRépertoire » en c# ou « Monrépertoire\monsousrépertoire » en Visual Basic.

  • « \\\MyServer\\MyShare » en c# ou « \\MyServer\MyShare » en Visual Basic.

Toutes ces opérations sont effectuées sur les chaînes, il est impossible de vérifier que les résultats sont valides dans tous les scénarios. Par exemple, le GetExtension méthode analyse une chaîne que vous passez à celui-ci et retourne l’extension de cette chaîne. Toutefois, cela ne signifie pas qu’un fichier avec cette extension existe sur le disque.

Pour obtenir la liste des tâches d’e/s courantes, consultez Tâches d'E/S courantes.

L’exemple de code suivant illustre certains membres principaux de la Path classe.

using System;
using System.IO;

class Test 
{

    public static void Main() 
    {
        string path1 = @"c:\temp\MyTest.txt";
        string path2 = @"c:\temp\MyTest";
        string path3 = @"temp";

        if (Path.HasExtension(path1)) 
        {
            Console.WriteLine("{0} has an extension.", path1);
        }

        if (!Path.HasExtension(path2)) 
        {
            Console.WriteLine("{0} has no extension.", path2);
        }

        if (!Path.IsPathRooted(path3)) 
        {
            Console.WriteLine("The string {0} contains no root information.", path3);
        }

        Console.WriteLine("The full path of {0} is {1}.", path3, Path.GetFullPath(path3));
        Console.WriteLine("{0} is the location for temporary files.", Path.GetTempPath());
        Console.WriteLine("{0} is a file available for use.", Path.GetTempFileName());

        /* This code produces output similar to the following:
         * c:\temp\MyTest.txt has an extension.
         * c:\temp\MyTest has no extension.
         * The string temp contains no root information.
         * The full path of temp is D:\Documents and Settings\cliffc\My Documents\Visual Studio 2005\Projects\ConsoleApplication2\ConsoleApplication2\bin\Debug\temp.
         * D:\Documents and Settings\cliffc\Local Settings\Temp\8\ is the location for temporary files.
         * D:\Documents and Settings\cliffc\Local Settings\Temp\8\tmp3D.tmp is a file available for use.
         */
    }
}

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 1.1
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: