Path.ChangeExtension(String, String) Méthode

public:
 static System::String ^ ChangeExtension(System::String ^ path, System::String ^ extension);

public static string ChangeExtension(string path, string extension);

static member ChangeExtension : string * string -> string

Public Shared Function ChangeExtension (path As String, extension As String) As String

Paramètres

Retours

Informations sur le chemin d’accès modifié.

Sur les plateformes de bureau basées sur Windows, si path est null ou une chaîne vide ( » « ), les informations de chemin d’accès sont retournées non modifiées. Si extension c’est nullle cas, la chaîne retournée contient le chemin spécifié avec son extension supprimée. Si path elle n’a pas d’extension et extension n’est pas null, la chaîne de chemin d’accès retournée contient extension ajoutée à la fin de path.

Exceptions

Exemples

L’exemple suivant illustre une utilisation de la ChangeExtension méthode.

using System;
using System.IO;

public class PathSnippets
{

    public void ChangeExtension()
    {
        string goodFileName = @"C:\mydir\myfile.com.extension";
        string badFileName = @"C:\mydir\";
        string result;

        result = Path.ChangeExtension(goodFileName, ".old");
        Console.WriteLine("ChangeExtension({0}, '.old') returns '{1}'",
            goodFileName, result);

        result = Path.ChangeExtension(goodFileName, "");
        Console.WriteLine("ChangeExtension({0}, '') returns '{1}'",
            goodFileName, result);

        result = Path.ChangeExtension(badFileName, ".old");
        Console.WriteLine("ChangeExtension({0}, '.old') returns '{1}'",
            badFileName, result);

        // This code produces output similar to the following:
        //
        // ChangeExtension(C:\mydir\myfile.com.extension, '.old') returns 'C:\mydir\myfile.com.old'
        // ChangeExtension(C:\mydir\myfile.com.extension, '') returns 'C:\mydir\myfile.com.'
        // ChangeExtension(C:\mydir\, '.old') returns 'C:\mydir\.old'

Imports System.IO

Public Class PathSnippets
    Public Sub ChangeExtension()
        Dim goodFileName As String = "C:\mydir\myfile.com.extension"
        Dim badFileName As String = "C:\mydir\"
        Dim result As String
        result = Path.ChangeExtension(goodFileName, ".old")
        Console.WriteLine("ChangeExtension({0}, '.old') returns '{1}'", goodFileName, result)
        result = Path.ChangeExtension(goodFileName, "")
        Console.WriteLine("ChangeExtension({0}, '') returns '{1}'", goodFileName, result)
        result = Path.ChangeExtension(badFileName, ".old")
        Console.WriteLine("ChangeExtension({0}, '.old') returns '{1}'", badFileName, result)

        ' This code produces output similar to the following:
        '
        ' ChangeExtension(C:\mydir\myfile.com.extension, '.old') returns 'C:\mydir\myfile.com.old'
        ' ChangeExtension(C:\mydir\myfile.com.extension, '') returns 'C:\mydir\myfile.com.'
        ' ChangeExtension(C:\mydir\, '.old') returns 'C:\mydir\.old'

Remarques

Si ni extension ne path contient de point (.), ChangeExtension ajoute la période.

Le extension paramètre peut contenir plusieurs points et tous les caractères de chemin d’accès valides, et peut être n’importe quelle longueur. Si extension c’est nullle cas, la chaîne retournée contient le contenu de path la dernière période et tous les caractères suivants ont été supprimés.

S’il extension s’agit d’une chaîne vide, la chaîne de chemin d’accès retournée contient le contenu des path caractères suivants la dernière période supprimée.

Si path elle n’a pas d’extension et extension n’est pas null, la chaîne retournée contient path suivi de extension.

Si extension ce n’est pas null le cas et ne contient pas de période de début, la période est ajoutée.

Si path elle contient une extension multiple séparée par plusieurs périodes, la chaîne retournée contient le contenu de path la dernière période et tous les caractères suivants sont remplacés par extension. Par exemple, si path c’est «\Dir1\examples\pathtests.csx.txt» et extension « cs », le chemin modifié est « \Dir1\examples\pathtests.csx.cs ».

Il n’est pas possible de vérifier que les résultats retournés sont valides dans tous les scénarios. Par exemple, s’il path est vide, extension est ajouté.

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

Voir aussi

• formats de chemin d’accès Fichier sur les systèmes Windows
• E/S de fichier et de flux
• Guide pratique pour lire du texte à partir d’un fichier
• Guide pratique pour écrire du texte dans un fichier