Exporter (0) Imprimer
Développer tout

String.CompareTo, méthode (Object)

Mise à jour : novembre 2007

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 le Objectspécifié.

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

public int CompareTo(
	Object value
)
public final int CompareTo(
	Object value
)
public final function CompareTo(
	value : Object
) : int

Paramètres

value
Type : System.Object
Object dont la valeur est un 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érieure à 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 est null.

Implémentations

IComparable.CompareTo(Object)

ExceptionCondition
ArgumentException

value n'est pas String.

value doit être un objet String.

fkw3h78a.alert_caution(fr-fr,VS.90).gifAttention :

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

L'exemple de code 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());
            }
      }
}


import System.*;

public class MyClass
{
} //MyClass

public class ArgExceptionExample
{
    public static void main(String[] args)
    {
        MyClass my = new MyClass();
        String s = "sometext";
        try {
            int i = s.CompareTo(my);
        }
        catch (System.Exception e) {
            Console.WriteLine("Error: {0}", e.ToString());
        }
    } //main
} //ArgExceptionExample


import System;

public class MyClass {}
public class ArgExceptionExample 
   {
   public static function Main()
      {
      var my : MyClass = new MyClass();
      var s : String = "sometext";
      try 
         {
         var i : int = s.CompareTo(my);
         }
     catch (e : Exception) 
         {
         Console.WriteLine("Error: {0}",e.ToString());
         }
      }
}


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile pour Smartphone, Windows Mobile pour Pocket PC, Xbox 360

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

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Pris en charge dans : 3.5, 2.0, 1.0

XNA Framework

Pris en charge dans : 2.0, 1.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft