BigInteger.IComparable.CompareTo(Object) Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Numerics

Assembly:: System.Runtime.Numerics.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Confronta questa istanza con un oggetto specificato e restituisce un intero che indica se il valore di questa istanza è minore, uguale o maggiore rispetto al valore dell'oggetto specificato.

 virtual int System.IComparable.CompareTo(System::Object ^ obj) = IComparable::CompareTo;

int IComparable.CompareTo (object obj);

abstract member System.IComparable.CompareTo : obj -> int
override this.System.IComparable.CompareTo : obj -> int

Function CompareTo (obj As Object) As Integer Implements IComparable.CompareTo

Parametri

obj: Object

Oggetto da confrontare.

Restituisce

Int32

Signed Integer che indica la relazione dell'istanza corrente con il parametro obj, come illustrato nella tabella seguente.

Valore restituito	Descrizione
Minore di zero	L'istanza corrente è minore di `obj`.
Zero	L'istanza corrente è uguale a `obj`.
Maggiore di zero	L'istanza corrente è maggiore di `obj`, oppure il parametro `obj` è `null`.

Implementazioni

CompareTo(Object)

Eccezioni

ArgumentException

obj non è un oggetto BigInteger.

Esempio

Nell'esempio seguente viene chiamato il CompareTo(Object) metodo per confrontare un BigInteger valore con ogni elemento in una matrice di oggetti:

object[] values = { BigInteger.Pow(Int64.MaxValue, 10), null,
                    12.534, Int64.MaxValue, BigInteger.One };
BigInteger number = UInt64.MaxValue;

foreach (object value in values)
{
   try {
      Console.WriteLine("Comparing {0} with '{1}': {2}", number, value,
                        number.CompareTo(value));
   }
   catch (ArgumentException) {
      Console.WriteLine("Unable to compare the {0} value {1} with a BigInteger.",
                        value.GetType().Name, value);
   }
}
// The example displays the following output:
//    Comparing 18446744073709551615 with '4.4555084156466750133735972424E+189': -1
//    Comparing 18446744073709551615 with '': 1
//    Unable to compare the Double value 12.534 with a BigInteger.
//    Unable to compare the Int64 value 9223372036854775807 with a BigInteger.
//    Comparing 18446744073709551615 with '1': 1

Dim values() As Object = { BigInteger.Pow(Int64.MaxValue, 10), Nothing, 
                           12.534, Int64.MaxValue, BigInteger.One }
Dim number As BigInteger = UInt64.MaxValue

For Each value As Object In values
   Try
      Console.WriteLine("Comparing {0} with '{1}': {2}", number, value, 
                        number.CompareTo(value))
   Catch e As ArgumentException
      Console.WriteLine("Unable to compare the {0} value {1} with a BigInteger.",
                        value.GetType().Name, value)
   End Try                     
Next                                 
' The example displays the following output:
'    Comparing 18446744073709551615 with '4.4555084156466750133735972424E+189': -1
'    Comparing 18446744073709551615 with '': 1
'    Unable to compare the Double value 12.534 with a BigInteger.
'    Unable to compare the Int64 value 9223372036854775807 with a BigInteger.
'    Comparing 18446744073709551615 with '1': 1

Commenti

Il obj parametro deve essere uno dei seguenti:

Oggetto il cui tipo di runtime è BigInteger.
Variabile Object il cui valore è null. Se il valore del obj parametro è null, il metodo restituisce 1, che indica che l'istanza corrente è maggiore di obj.

Si applica a

Vedi anche

CompareTo(Object)