Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

String.CompareTo, méthode (Object)

Compare cette instance avec un Object spécifié et indique si cette instance précède, suit ou apparaît dans la même position dans l'ordre de tri que l'Object spécifie.

Espace de noms :  System
Assembly :  mscorlib (dans mscorlib.dll)

public int CompareTo(
	Object value
)

Paramètres

value
Type : System.Object
Objet qui prend pour valeur String.

Valeur de retour

Type : System.Int32
Entier signé 32 bits qui indique si cette instance précède, suit ou apparaît dans la même position dans l'ordre de tri que le paramètre value.

Valeur

Condition

Inférieur à zéro

Cette instance précède value.

Zéro

Cette instance a la même position dans l'ordre de tri que value.

Supérieure à zéro

Cette instance suit value.

ou

value a la valeur null.

Implémentations

IComparable.CompareTo(Object)

ExceptionCondition
ArgumentException

value n'est pas un String.

value doit être un objet String.

Mise en gardeAttention

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).

Remarques à l'attention des appelants

Les jeux de caractères incluent les caractères ignorables. La méthode CompareTo ne tient pas compte de ces caractères lorsqu'elle effectue une comparaison dépendante de la culture. Par exemple, si le code suivant est exécuté sur .NET Framework 4 ou version ultérieure, une comparaison de « animal » par « animal » (avec un trait d'union conditionnel, ou U+00AD) indique que les deux chaînes sont équivalentes.


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 pouvant être ignoré dans une comparaison de chaînes, appelez la méthode CompareOrdinal(String, String).

L'exemple suivant montre comment utiliser la méthode CompareTo avec un 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

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

.NET pour les applications Windows Phone

Pris en charge dans : 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 (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)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2015 Microsoft