Exportar (0) Imprimir
Expandir todo

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
)
public static String ChangeExtension (
	String path, 
	String extension
)
public static function ChangeExtension (
	path : String, 
	extension : String
) : String

Parámetros

path

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 InvalidPathChars.

extension

La nueva extensión (con un punto inicial). Especifique referencia de objeto null (Nothing en Visual Basic) para quitar una extensión existente de path.

Valor devuelto

Cadena que contiene la información de ruta de acceso modificada. En plataformas de escritorio basadas en Windows, si path es referencia de objeto null (Nothing en Visual Basic) o una cadena vacía (""), la información de ruta de acceso se devuelve sin modificar. Si extension es referencia de objeto null (Nothing en Visual Basic), 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 referencia de objeto null (Nothing en Visual Basic), la cadena de ruta de acceso devuelta contiene extension anexado al final de path.

Tipo de excepciónCondición

ArgumentException

La ruta de acceso contiene uno o varios caracteres no válidos de los definidos en InvalidPathChars o contiene un carácter comodín.

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 referencia de objeto null (Nothing en Visual Basic), 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 referencia de objeto null (Nothing en Visual Basic), la cadena devuelta contiene path seguida por extension.

Si extension no es referencia de objeto null (Nothing en Visual Basic) 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 un ejemplo de cómo utilizar este método, vea la sección Ejemplo que figura a continuación. En la siguiente tabla se muestran ejemplos de otras tareas de E/S típicas o relacionadas.

Para realizar esta operación...

Vea el ejemplo de este tema...

Crear un archivo de texto

Cómo: Escribir texto en un archivo

Escribir en un archivo de texto.

Cómo: Escribir texto en un archivo

Leer de un archivo de texto.

Cómo: Leer texto de un archivo

Recuperar una extensión de archivo

GetExtension

Recuperar la ruta de acceso completa de un archivo

GetFullPath

Recuperar sólo el nombre de archivo de una ruta de acceso

GetFileNameWithoutExtension

Recuperar sólo el nombre de directorio de una ruta de acceso

GetDirectoryName

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'

import System.*;
import 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);

var goodFileName : String = "C:\\mydir\\myfile.com.extension";
var badFileName : String = "C:\\mydir\\";
var result : 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); 

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

.NET Framework

Compatible con: 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 2.0, 1.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft