Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método Int32.CompareTo (Int32)

 

Publicado: octubre de 2016

Compara esta instancia con un entero de 32 bits con signo y devuelve una indicación de los valores relativos.

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

public int CompareTo(
	int value
)

Parámetros

value
Type: System.Int32

Entero que se va a comparar.

Valor devuelto

Type: System.Int32

Número con signo que indica los valores relativos de esta instancia y value.

Valor devuelto

Descripción

Menor que cero

Esta instancia es menor que value.

Cero

Esta instancia es igual a value.

Mayor que cero

Esta instancia es mayor que value.

Este método implementa el System.IComparable<T> interfaz y realiza ligeramente mejor que la Int32.CompareTo método porque no tiene que convertir el value parámetro a un objeto.

Dependiendo del lenguaje de programación, es posible al código un CompareTo método donde el tipo de parámetro tiene menos bits (es más estrecho) que el tipo de instancia. Esto es posible porque algunos lenguajes de programación realizan una conversión de ampliación implícita que representa el parámetro como un tipo con tantos bits como la instancia.

Por ejemplo, suponga que el tipo de instancia es Int32 y el tipo de parámetro es Byte. El compilador de Microsoft C# genera instrucciones para representar el valor del parámetro como un Int32, a continuación, genera un Int32.CompareTo método que compara los valores de la Int32 instancia y el Int32 representación del parámetro.

Consulte la documentación de su lenguaje de programación para determinar si el compilador realiza las conversiones de ampliación implícitas en tipos numéricos.

En el ejemplo siguiente se muestra el Int32.CompareTo(Int32) método. Además de mostrar el valor devuelto por el método para cuatro comparaciones diferentes, convierte el valor devuelto a un miembro de la opción de instalación Comparison , cuyo valor también muestra la enumeración.

using System;

enum Comparison {
   LessThan=-1, Equal=0, GreaterThan=1};

public class ValueComparison
{
   public static void Main()
   {
      int mainValue = 16325;
      int zeroValue = 0;
      int negativeValue = -1934;
      int positiveValue = 903624;
      int sameValue = 16325;

      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).",  
                        mainValue, zeroValue, 
                        mainValue.CompareTo(zeroValue), 
                        (Comparison) mainValue.CompareTo(zeroValue));

      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).",
                        mainValue, sameValue, 
                        mainValue.CompareTo(sameValue), 
                        (Comparison) mainValue.CompareTo(sameValue));

      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).", 
                        mainValue, negativeValue, 
                        mainValue.CompareTo(negativeValue), 
                        (Comparison) mainValue.CompareTo(negativeValue));

      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).", 
                        mainValue, positiveValue, 
                        mainValue.CompareTo(positiveValue), 
                        (Comparison) mainValue.CompareTo(positiveValue));
   }
}
// The example displays the following output:
//       Comparing 16325 and 0: 1 (GreaterThan).
//       Comparing 16325 and 16325: 0 (Equal).
//       Comparing 16325 and -1934: 1 (GreaterThan).
//       Comparing 16325 and 903624: -1 (LessThan).

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 2.0
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1
Volver al principio
Mostrar: