Esta documentación está archivada y no tiene mantenimiento.

Int32.TryParse (Método) (String, Int32%)

Actualización: Julio de 2008

Convierte la representación en forma de cadena de un número en el entero de 32 bits con signo equivalente. Un valor devuelto indica si la conversión tuvo éxito.

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

public static bool TryParse(
	string s,
	out int result
)
public static boolean TryParse(
	String s,
	/** @attribute OutAttribute */ /** @ref */int result
)
public static function TryParse(
	s : String, 
	result : int
) : boolean

Parámetros

s
Tipo: System.String
Cadena que contiene un número que se va a convertir.
result
Tipo: System.Int32%
Cuando este método devuelve un valor, contiene el valor entero con signo de 32 bits equivalente al número contenido en s, si la conversión se realizó correctamente, o cero si se produjo un error de conversión. La conversión no se realiza correctamente si el parámetro s es null, no tiene el formato correcto o representa un número menor que MinValue o mayor que MaxValue. Este parámetro se pasa sin inicializar.

Valor devuelto

Tipo: System.Boolean
true si s se convirtió correctamente; en caso contrario, false.

El método TryParse es como el método Parse, con la diferencia de que el método TryParse no produce ninguna excepción si se produce un error de conversión. Elimina la necesidad de usar el control de excepciones para probar una FormatException en caso de que el parámetro s no sea válido y no pueda analizarse correctamente.

El parámetro s contiene un número con la estructura:

[eb][signo]dígitos[eb]

Los elementos entre corchetes ([ y ]) son opcionales. En la tabla siguiente se describe cada elemento.

Elemento

Description

eb

Espacio en blanco opcional.

signo

Signo opcional.

dígitos

Secuencia de dígitos comprendidos entre el 0 y el 9.

El parámetro s se interpreta utilizando el estilo NumberStyles.Integer. Además de dígitos decimales, solo se permiten espacios iniciales y finales junto con un signo inicial. Para definir explícitamente los elementos de estilo junto con la información de formato específica de la referencia cultural que puede estar presente en s, use el método Int32.TryParse(String, NumberStyles, IFormatProvider, Int32).

El parámetro s se analiza utilizando la información de formato de un objeto NumberFormatInfo que se inicializa para la referencia cultural del sistema actual. Para obtener más información, vea CurrentInfo.

Esta sobrecarga del método TryParse interpreta todos los dígitos del parámetro s como dígitos decimales. Para analizar la representación en forma de cadena de un número hexadecimal, llame a la sobrecarga Int32.TryParse(String, NumberStyles, IFormatProvider, Int32).

En el ejemplo siguiente se llama al método Int32.TryParse(String, Int32) con varios valores de cadena diferentes.

using System;

public class StringParsing
{
   public static void Main()
   {
      TryToParse(null);
      TryToParse("160519");
      TryToParse("9432.0");
      TryToParse("16,667");
      TryToParse("   -322   ");
      TryToParse("+4302");
      TryToParse("(100);");
      TryToParse("01FA");
   }

   private static void TryToParse(string value)
   {
      int number;
      bool result = Int32.TryParse(value, out number);
      if (result)
      {
         Console.WriteLine("Converted '{0}' to {1}.", value, number);         
      }
      else
      {
         if (value == null) value = ""; 
         Console.WriteLine("Attempted conversion of '{0}' failed.", value);
      }
   }
}
// The example displays the following output to the console:
//       Attempted conversion of '' failed.
//       Converted '160519' to 160519.
//       Attempted conversion of '9432.0' failed.
//       Attempted conversion of '16,667' failed.
//       Converted '   -322   ' to -322.
//       Converted '+4302' to 4302.
//       Attempted conversion of '(100);' failed.
//       Attempted conversion of '01FA' failed.


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0

Fecha

Historial

Motivo

Julio de 2008

Se ha agregado información detallada y se ha revisado el ejemplo.

Mejora de la información.

Mostrar: