Personas que lo han encontrado útil: 1 de 1 - Valorar este tema

Path.ChangeExtension (Método)

.NET Framework 2.0

Otras versiones

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

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

Sintaxis

C++

Copiar

public static string ChangeExtension (
	string path,
	string extension
)

Copiar

public static String ChangeExtension (
	String path, 
	String extension
)

JScript

Copiar

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.

Excepciones

Tipo de excepción	Condició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.

Comentarios

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

Ejemplo

En el ejemplo de código siguiente se muestra cómo utilizar el método ChangeExtension.

C++

Copiar

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'

Copiar

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);

JScript

Copiar

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);

Plataformas

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.

Información de versión