Path.ChangeExtension(String, String) Methode

Definition

Namespace:
System.IO
Assemblys:
mscorlib.dll, System.Runtime.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
netstandard.dll

Ändert die Erweiterung einer Pfadzeichenfolge.

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

Parameter

path
String

Die zu ändernden Pfadinformationen.

extension
String

Die neue Verlängerung (mit oder ohne führende Periode). Geben Sie null an, dass eine vorhandene Erweiterung aus pathentfernt werden soll.

Gibt zurück

String

Die geänderten Pfadinformationen.

Wenn path auf Windows-basierten Desktopplattformen null oder eine leere Zeichenfolge ("") ist, werden die Pfadinformationen unverändert zurückgegeben. Ist extension dies nullder Wert, enthält die zurückgegebene Zeichenfolge den angegebenen Pfad, wobei die Erweiterung entfernt wurde. Wenn path keine Erweiterung vorhanden ist und extension nicht null, enthält extension die zurückgegebene Pfadzeichenfolge am Ende von path.

Ausnahmen

ArgumentException

.NET Framework- und .NET Core-Versionen, die älter als 2.1 sind: path enthält mindestens ein ungültiges Zeichen, das in GetInvalidPathChars().

Beispiele

Im folgenden Beispiel wird die Verwendung der ChangeExtension Methode veranschaulicht.

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'

Hinweise

Wenn weder pathextension ein Punkt (.) enthalten ist, ChangeExtension wird der Punkt hinzugefügt.

Der extension Parameter kann mehrere Punkte und alle gültigen Pfadzeichen enthalten und kann eine beliebige Länge sein. Ist extension dies nullder Wert, enthält die zurückgegebene Zeichenfolge den Inhalt des path letzten Punkts und alle Zeichen, die darauf folgen.

Wenn extension es sich um eine leere Zeichenfolge handelt, enthält die zurückgegebene Pfadzeichenfolge den Inhalt aller path Zeichen nach dem letzten Entfernten Zeitraum.

Wenn path keine Erweiterung vorhanden ist und extension nicht null, enthält path die zurückgegebene Zeichenfolge gefolgt von extension.

Wenn extension dies nicht null der Fall ist und keinen vorangestellten Punkt enthält, wird der Punkt hinzugefügt.

Wenn path eine mehrfache Erweiterung durch mehrere Punkte getrennt ist, enthält die zurückgegebene Zeichenfolge den Inhalt mit path dem letzten Punkt und allen Zeichen, die darauf folgen.extension Wenn beispielsweise path "\Dir1\examples\pathtests.csx.txt" und extension "cs" lautet, lautet der geänderte Pfad "\Dir1\examples\pathtests.csx.cs".

Es ist nicht möglich, zu überprüfen, ob die zurückgegebenen Ergebnisse in allen Szenarien gültig sind. Wenn z. B path . leer ist, extension wird angefügt.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter "Allgemeine E/A-Aufgaben".

Gilt für:

Weitere Informationen