Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método Path.ChangeExtension (String, String)

 

Publicado: octubre de 2016

Cambia la extensión de una cadena de ruta de acceso.

Espacio de nombres:   System.IO
Ensamblado:  mscorlib (en mscorlib.dll)

Public Shared Function ChangeExtension (
	path As String,
	extension As String
) As String

Parámetros

path
Type: System.String

La información de ruta de acceso que se va a modificar. La ruta de acceso no puede contener ninguno de los caracteres definidos en GetInvalidPathChars.

extension
Type: System.String

Nueva extensión (con o sin un punto inicial). Especifique null para quitar una extensión existente de path.

Valor devuelto

Type: System.String

Información de la ruta de acceso modificada.

En plataformas de escritorio basadas en Windows, si path es null o una cadena vacía (""), la información de ruta de acceso se devuelve sin modificar. Si extension es null, la cadena devuelta contiene la ruta de acceso especificada, de la que se elimina la extensión. Si path no tiene extensión y extension no es null, la cadena de ruta de acceso devuelta contiene extension anexado al final de path.

Exception Condition
ArgumentException

path contiene uno o más caracteres no válidos definidos en GetInvalidPathChars.

Si no path ni extension contiene un punto (.), ChangeExtension agrega el punto.

El parámetro extension puede contener varios puntos y caracteres de ruta de acceso válida y puede tener cualquier longitud. Si extension es null, la cadena devuelta contiene el contenido de path con el último período y todos los caracteres siguientes eliminan.

Si extension es una cadena vacía, la cadena de ruta de acceso devuelta contiene el contenido de path con los caracteres siguientes al último punto quitado.

Si path no tiene una extensión y extension no es null, la cadena devuelta contiene path seguido de extension.

Si extension no null y no contiene un punto inicial, se agrega el punto.

Si path contiene una extensión múltiple separada por múltiples puntos, la cadena devuelta contiene el contenido de path con el último punto y todos los caracteres siguientes reemplazan por extension. Por ejemplo, si path es "\Dir1\examples\pathtests.csx.txt" y extension es "cs", la ruta de acceso modificada es "\Dir1\examples\pathtests.csx.cs".

No es posible comprobar que los resultados devueltos son válidos en todos los escenarios. Por ejemplo, si path está vacía, extension se anexa.

Para obtener una lista de tareas de E/S comunes, consulte Tareas de E/S comunes.

En el ejemplo de código siguiente se muestra un uso de la ChangeExtension (método).

Imports System
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'

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 1.1
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1
Volver al principio
Mostrar: