Esporta (0) Stampa
Espandi tutto
Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.
Traduzione
Originale

Metodo String.CompareTo (Object)

Confronta questa istanza con Object o un oggetto specificato e indica se questa istanza precede, segue o si trova nella stessa posizione dell'oggetto Object specificato all'interno dei criteri di ordinamento.

Spazio dei nomi:  System
Assembly:  mscorlib (in mscorlib.dll)

public int CompareTo(
	Object value
)

Parametri

value
Tipo: System.Object
Oggetto che restituisce un oggetto String.

Valore restituito

Tipo: System.Int32
Valore intero con segno a 32 bit che indica se questa istanza precede, segue o si trova nella stessa posizione del parametro value all'interno dei criteri di ordinamento.

Valore

Condizione

Minore di zero

Questa istanza precede value.

Zero

Questa istanza si trova nella stessa posizione di value nei criteri di ordinamento.

Maggiore di zero

L'istanza segue value.

-oppure-

value è null.

Implementa

IComparable.CompareTo(Object)

EccezioneCondizione
ArgumentException

value non è un oggetto String.

Il parametro value deve essere un oggetto String.

Nota di avvisoAttenzione

Il metodo CompareTo è stato progettato principalmente per l'utilizzo nelle operazioni di ordinamento, anche di tipo alfabetico. Non deve essere utilizzato nei casi in cui lo scopo primario della chiamata al metodo sia determinare l'equivalenza di due stringhe. Per stabilire se due stringhe sono equivalenti, chiamare il metodo Equals.

Il metodo consente di eseguire un confronto per parola, con distinzione tra maiuscole e minuscole e in base alle impostazioni cultura, utilizzando le impostazioni cultura correnti. Per ulteriori informazioni sulle regole di ordinamento per parola, per stringa e ordinale, vedere System.Globalization.CompareOptions.

Per ulteriori informazioni sul comportamento di questo metodo, vedere la sezione Note relativa al metodo String.Compare(String, String).

Note per i chiamanti

I set di caratteri includono caratteri ignorabili. Il metodo CompareTo non considera tali caratteri quando viene eseguito un confronto dipendente dalle impostazioni cultura. Ad esempio, un confronto di "animale" con "ani-male" (utilizzando un trattino, oppure U+00AD) indica che le due stringhe sono equivalenti, come mostra l'esempio seguente:


using System;

public class Example
{
   public static void Main()
   {
      string s1 = "ani\u00ADmal";
      object o1 = "animal";

      Console.WriteLine("Comparison of '{0}' and '{1}': {2}", 
                        s1, o1, s1.CompareTo(o1));
   }
}
// The example displays the following output:
//       Comparison of 'ani-mal' and 'animal': 0


Per riconoscere i caratteri ignorabili in un confronto di stringhe, chiamare il metodo CompareOrdinal(String, String).

Nell'esempio riportato di seguito viene illustrato come utilizzare il metodo CompareTo con un oggetto Object.


using System;

public class MyClass {}

public class Example 
{
   public static void Main()
   {
      MyClass my = new MyClass();
      string s = "sometext";
      try 
      {
         int i = s.CompareTo(my);
      }
      catch (Exception e) 
      {
         Console.WriteLine("Error: {0}",e.ToString());
      }
   }
}
// The example displays the following output:
//    Error: System.ArgumentException: Object must be of type String.
//       at System.String.CompareTo(Object value)
//       at Example.Main()


.NET Framework

Supportato in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1

.NET per applicazioni Windows Phone

Supportato in: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Aggiunte alla community

AGGIUNGI
Mostra:
© 2015 Microsoft