Path.ChangeExtension(String, String) Metod

Definition

Namnområde:
System.IO
Sammansättningar:
mscorlib.dll, System.Runtime.Extensions.dll
Sammansättning:
mscorlib.dll
Sammansättning:
System.Runtime.Extensions.dll
Sammansättning:
netstandard.dll

Ändrar tillägget för en sökvägssträng.

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

Parametrar

path
String

Sökvägsinformationen som ska ändras.

extension
String

Det nya tillägget (med eller utan inledande period). Ange null för att ta bort ett befintligt tillägg från path.

Returer

String

Den ändrade sökvägen.

Om path är null eller en tom sträng (") på Windows-baserade skrivbordsplattformar returneras sökvägsinformationen oförändrad. Om extension är nullinnehåller den returnerade strängen den angivna sökvägen med tillägget borttaget. Om path det inte finns något tillägg och extension inte nullär innehåller den returnerade sökvägssträngen extension tillagd i slutet av path.

Undantag

ArgumentException

.NET Framework- och .NET Core-versioner som är äldre än 2.1: path innehåller ett eller flera av de ogiltiga tecken som definierats i GetInvalidPathChars().

Exempel

I följande exempel visas hur metoden används ChangeExtension .

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'

Kommentarer

Om varken path eller extension innehåller en punkt (.), ChangeExtension lägger till perioden.

Parametern extension kan innehålla flera perioder och giltiga sökvägstecken och kan vara valfri längd. Om extension är nullinnehåller den returnerade strängen innehållet i path med den sista perioden och alla tecken efter att den har tagits bort.

Om extension är en tom sträng innehåller den returnerade sökvägssträngen innehållet i path med alla tecken efter den senaste perioden som tagits bort.

Om path inte har ett tillägg och extension inte nullär innehåller den returnerade strängen path följt av extension.

Om extension inte null och inte innehåller en inledande period läggs perioden till.

Om path innehåller ett flera tillägg avgränsat med flera perioder, innehåller den returnerade strängen innehållet i path med den sista perioden och alla tecken efter den ersätts av extension. Om path till exempel är "\Dir1\examples\pathtests.csx.txt" och extension är "cs" är den ändrade sökvägen "\Dir1\examples\pathtests.csx.cs".

Det går inte att kontrollera att de returnerade resultaten är giltiga i alla scenarier. Om det till exempel path är tomt extension läggs det till.

En lista över vanliga I/O-uppgifter finns i Vanliga I/O-uppgifter.

Gäller för

Se även