Path.ChangeExtension(String, String) Methode

Definitie

Naamruimte:
System.IO
Assembly's:
mscorlib.dll, System.Runtime.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
netstandard.dll

Hiermee wijzigt u de extensie van een padtekenreeks.

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

Parameters

path
String

De padgegevens die u wilt wijzigen.

extension
String

De nieuwe uitbreiding (met of zonder voorloopperiode). Geef op null uit een bestaande extensie pathte verwijderen.

Retouren

String

De gewijzigde padgegevens.

Als op Windows bureaubladplatforms path is null of een lege tekenreeks (""), wordt de padinformatie ongewijzigd geretourneerd. Als extension dat het is null, bevat de geretourneerde tekenreeks het opgegeven pad met de extensie verwijderd. Als path er geen extensie is en extension niet null, bevat extension de geretourneerde padtekenreeks toegevoegd aan het einde van path.

Uitzonderingen

ArgumentException

.NET Framework en .NET Core-versies ouder dan 2.1: path bevat een of meer ongeldige tekens die zijn gedefinieerd in GetInvalidPathChars().

Voorbeelden

In het volgende voorbeeld ziet u een gebruik van de ChangeExtension methode.

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'

Opmerkingen

Als geen van beide pathextension perioden (.) bevat, ChangeExtension wordt de punt toegevoegd.

De extension parameter kan meerdere perioden en geldige padtekens bevatten en kan elke lengte hebben. Als extension dat het is null, bevat de geretourneerde tekenreeks de inhoud van path de laatste periode en alle tekens die erop volgen verwijderd.

Als extension dit een lege tekenreeks is, bevat de geretourneerde padtekenreeks de inhoud van path alle tekens na de laatste periode verwijderd.

Als path er geen extensie is en extension dit niet nullhet geval is, bevat path de geretourneerde tekenreeks gevolgd door extension.

Als extension dat niet null het geval is en geen voorloopperiode bevat, wordt de periode toegevoegd.

Als path deze een meerdere extensie bevat, gescheiden door meerdere punten, bevat de geretourneerde tekenreeks de inhoud van path de laatste periode en alle tekens die erop volgen, vervangen door extension. Als bijvoorbeeld path '\Dir1\examples\pathtests.csx.txt' is en extension 'cs' is, is het gewijzigde pad '\Dir1\examples\pathtests.csx.cs'.

Het is niet mogelijk om te controleren of de geretourneerde resultaten geldig zijn in alle scenario's. Als dit bijvoorbeeld path leeg is, extension wordt toegevoegd.

Zie Algemene I/O-taken voor een lijst met algemene I/O-taken.

Van toepassing op

Zie ook