Path.ChangeExtension(String, String) Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kod:

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ştireceğiniz yol bilgileri.

extension

String

Yeni uzantı (başında nokta olan veya olmayan). mevcut bir uzantıyı 'dan pathkaldırmak için belirtinnull.

Döndürülenler

String

Değiştirilen yol bilgileri.

Windows tabanlı masaüstü platformlarında ise pathnull veya boş bir dize (""), 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 patheklenir.

Ö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.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'

Açıklamalar

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

extension parametresi birden çok nokta ve geçerli herhangi bir 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 extensionöğesini içerirpath.

null Değilse extension ve başında nokta yoksa, dönem eklenir.

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

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 pathextension eklenir.

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

Ayrıca bkz.

• Windows sistemlerinde dosya yolu biçimleri
• Dosya ve Stream G/Ç
• Nasıl yapılır: Dosyadan Metin Okuma
• Nasıl yapılır: Bir Dosyaya Metin Yazma