Path.ChangeExtension(String, String) Methode

  • Referenz

Definition

Namespace:
System.IO
Assembly:
System.Runtime.Extensions.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.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);
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 Erweiterung (mit oder ohne führenden Punkt). Geben Sie null an, um eine vorhandene Erweiterung aus path zu entfernen.

Gibt zurück

String

Die geänderten Pfadinformationen.

Auf Desktopplattformen auf Grundlage von Windows werden die Pfadinformationen unverändert zurückgegeben, wenn path null oder eine leere Zeichenfolge ("") ist. Wenn extensionnull ist, enthält die zurückgegebene Zeichenfolge den angegebenen Pfad ohne die Erweiterung. Wenn path keine Erweiterung besitzt und extension nicht null ist, enthält die zurückgegebene Pfadzeichenfolge extension, angefügt an das Ende von path.

Ausnahmen

ArgumentException

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

Beispiele

Im folgenden Beispiel wird eine Verwendung der ChangeExtension Methode veranschaulicht.

#using <system.dll>

using namespace System;
using namespace System::IO;
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'

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 kein path Punkt (.) enthält, extension ChangeExtension wird der Zeitraum hinzugefügt.

Der extension Parameter kann mehrere Perioden und alle gültigen Pfadzeichen enthalten und kann eine beliebige Länge sein. nullWenn extension es sich um eine zurückgegebene Zeichenfolge handelt, enthält die zurückgegebene Zeichenfolge den Inhalt path der letzten Periode und alle Zeichen, die sie entfernt haben.

Wenn extension es sich um eine leere Zeichenfolge handelt, enthält die zurückgegebene Pfadzeichenfolge den Inhalt path aller 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 es sich nicht null um einen führenden Zeitraum handelt, wird der Zeitraum hinzugefügt.

Wenn path eine mehrere Erweiterung durch mehrere Perioden getrennt ist, enthält die zurückgegebene Zeichenfolge den Inhalt path der letzten Periode und alle Zeichen, die sie ersetzt haben extension. Wenn path es sich beispielsweise um "Dir1examples\pathtests.csx.txt" handelt und extension "cs" lautet, lautet der geänderte Pfad "\\Dir1examplespathtests.csx.cs\\\".

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

Eine Liste allgemeiner I/O-Aufgaben finden Sie unter "Allgemeine I/O-Aufgaben".

Gilt für:

Siehe auch