Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original
Este tema aún no ha recibido ninguna valoración - Valorar este tema

Path.ChangeExtension (Método)

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

Espacio de nombres:  System.IO
Ensamblado:  mscorlib (en mscorlib.dll)
public static string ChangeExtension(
	string path,
	string extension
)

Parámetros

path
Tipo: 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
Tipo: System.String
Nueva extensión (con o sin un punto inicial). Especifique null para quitar una extensión existente de path.

Valor devuelto

Tipo: 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.
ExcepciónCondición
ArgumentException

path contiene uno o varios de los caracteres no válidos definidos en GetInvalidPathChars.

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

El parámetro extension puede contener múltiples puntos y cualquier carácter válido para la ruta de acceso y puede tener cualquier longitud. Si extension es null, la cadena devuelta contiene el contenido de path, del que se eliminan el último punto y todos los caracteres siguientes.

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

Si path no tiene extensión y extension no es null, la cadena devuelta contiene path seguida por extension.

Si extension no es 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 reemplazados 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 si los resultados devueltos son válidos en todos los escenarios. Por ejemplo, si path está vacío, se agrega extension.

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

En el ejemplo de código siguiente se muestra cómo utilizar el método 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'


.NET Framework

Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

.NET para aplicaciones de la Tienda Windows

Compatible con: Windows 8

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
¿Te ha resultado útil?
(Caracteres restantes: 1500)
Gracias por sus comentarios

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft. Reservados todos los derechos.