String.CompareTo, méthode (Object)

public int CompareTo(
	Object value
)

Implémentations

value doit être un objet String.

Attention
La méthode CompareTo a été conçue à l'origine pour être utilisée dans les opérations de tri et de classement dans l'ordre alphabétique. Elle ne doit pas être utilisée lorsque la principale fonction de l'appel de méthode est de déterminer si deux chaînes sont équivalentes. Pour déterminer si deux chaînes sont équivalentes, faites appel à la méthode Equals.

Cette méthode effectue une comparaison de mots (respectant la casse et spécifique à la culture) à l'aide de la culture en cours. Pour plus d'informations sur le tri des mots, des chaînes et sur le tri ordinal, consultez System.Globalization.CompareOptions.

Pour plus d'informations sur le comportement de cette méthode, consultez la section Notes de la méthode String.Compare(String, String).

Les jeux de caractères incluent des caractères ignorable. La méthode d' CompareTo ne tient pas compte de ces caractères lorsqu'elle effectue une comparaison dépendante de la culture. Par exemple, une comparaison de « animal » par « animal » (à l'aide d'un trait d'union conditionnel, ou U+00AD) indique que les deux chaînes sont équivalentes, comme indiqué dans l'exemple suivant.

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

Pour identifier les caractères ignorable dans une comparaison de chaînes, appelez la méthode d' CompareOrdinal(String, String) .

L'exemple suivant montre comment utiliser la méthode CompareTo avec un Object.

using System;

public class MyClass {}
public class ArgExceptionExample 
   {
   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());
            }
      }
}

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Référence