Path.ChangeExtension(String, String) Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Kaynak:

Path.cs

Yol dizesinin uzantısını değiştirir.

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

Parametreler

path

String

Değiştirebileceğiniz yol bilgileri.

extension

String

Yeni uzantı (başında nokta olan veya olmayan). mevcut bir uzantıyı 'den nullkaldırmak için belirtinpath.

Döndürülenler

String

Değiştirilen yol bilgileri.

Windows tabanlı masaüstü platformlarında pathnull veya boş bir dize ("") ise, yol bilgileri değiştirilmeden döndürülür. ise extensionnull, döndürülen dize, uzantısı kaldırılmış olarak belirtilen yolu içerir. path Uzantısı yoksa ve extension değilsenull, döndürülen yol dizesi extension sonuna eklenirpath.

Özel durumlar

ArgumentException

2.1'den eski .NET Framework ve .NET Core sürümleri: path içinde GetInvalidPathChars()tanımlanan geçersiz karakterlerden birini veya daha fazlasını içerir.

Örnekler

Aşağıdaki örnekte yönteminin kullanımı gösterilmektedir 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'

Açıklamalar

path Nokta (.) yoksa veya extension yoksa, ChangeExtension dönemi ekler.

extension parametresi birden çok nokta ve geçerli yol karakteri içerebilir ve herhangi bir uzunlukta olabilir. ise extensionnull, döndürülen dize son nokta ve onu izleyen tüm karakterlerin kaldırıldığı içeriğini path içerir.

Boş bir dizeyse extension , döndürülen yol dizesi son dönemi izleyen karakterlerin kaldırıldığı içeriğini path içerir.

Uzantısı yoksa path ve extension değilsenull, döndürülen dizeyi ve ardından pathöğesini içerirextension.

extension Değilse ve baştaki bir dönemi içermiyorsanull, dönem eklenir.

Birden çok noktayla ayrılmış birden çok uzantı içeriyorsa path , döndürülen dize son nokta ile içeriğini path ve onu izleyen tüm karakterleri ile extensiondeğiştirir. Örneğin, path "\Dir1\examples\pathtests.csx.txt" ve extension "cs" ise, değiştirilen yol "\Dir1\examples\pathtests.csx.cs" olur.

Döndürülen sonuçların tüm senaryolarda geçerli olduğunu doğrulamak mümkün değildir. Örneğin, boşsa path eklenir extension .

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

Ayrıca bkz.

• Windows sistemlerinde Dosya yolu biçimleri
• Dosya ve Akış G/Ç'si
• Nasıl yapılır: Dosyadan Metin Okuma
• Nasıl yapılır: Dosyaya Metin Yazma