Compartir a través de


Solución de problemas de excepciones: System.FormatException

Un método lanza una excepción FormatException que analiza un tipo o le da formato cuando el formato de un argumento no cumple las especificaciones de los parámetros del método.

Provocación de excepciones de formato

Aplicación de formato

Aplicar formato es el proceso de convertir una instancia de una clase, una estructura o un valor de enumeración en su representación de cadena, a menudo para que la cadena resultante se pueda mostrar a los usuarios o se pueda usar para guardar el estado del objeto.

Por ejemplo, Int32.ToString(String) toma un parámetro de cadena que identifica una cadena de formato estándar o personalizada y devuelve la representación de cadena del número. El método lanza una FormatException. Si la cadena de formato no es válida o no se admite, se lanza una.

Formatos compuestos

El formato compuesto toma una lista de objetos y una cadena de formato compuesto como entrada. Una cadena de formato compuesto está formada por texto fijo combinado con marcadores de posición indizados, que reciben el nombre de elementos de formato, y que se corresponden con los objetos de la lista. La operación de formato genera una cadena de resultado compuesta por el texto fijo original combinado con la representación de cadena de los objetos de la lista.

String.Format y Console.WriteLine son ejemplos de métodos que realizan el formato compuesto. Los métodos que utilizan el formato compuesto lanzan una FormatException si la cadena de formato no es válida o el índice de un elemento de formato es menor que cero o mayor o igual que el número de argumentos.

Análisis

El análisis es el proceso de convertir una cadena que representa un tipo base de.NET Framework en ese tipo base. Por ejemplo, se usa una operación de análisis para convertir una cadena en un número de punto flotante o un valor de fecha y hora.

Por ejemplo, Int32.Parse(String) Parse convierte la representación de cadena de una fecha y hora en su equivalente de DateTime con la información de formato específica de la referencia cultural especificada en el parámetro IformatProvider. Si la cadena no está en el formato correcto, se lanza FormatException.

Evitar FormatExceptions

El artículo de referencia de clase FormatException incluye las causas y soluciones comunes de los errores FormatException.

Las secciones de MSDN Library Aplicar formato a tipos en .NET Framework y Analizar cadenas en .NET Framework contienen información sobre cómo aplicar formato a los tipos y analizarlos correctamente.

Formatos compuestos

Formatos compuestos

Tipos numéricos

Cadenas con formato numérico estándar

Cadenas con formato numérico personalizado

Analizar cadenas numéricas en .NET Framework

Tipos de fecha y hora y Timespan

Cadenas con formato de fecha y hora estándar

Cadenas de formato de fecha y hora personalizadas

Cadenas de formato TimeSpan estándar

Cadenas de formato TimeSpan personalizado

Analizar cadenas de fecha y hora en .NET Framework

Otros tipos

Cadenas de formato de enumeración

Analizar otras cadenas en .NET Framework