Exporter (0) Imprimer
Développer tout
Développer Réduire
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.GetHashCode, méthode

Retourne le code de hachage pour cette chaîne.

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

public override int GetHashCode()

Valeur de retour

Type : System.Int32
Code de hachage d'un entier signé 32 bits.

Le comportement de GetHashCode est fonction de son implémentation, cette dernière pouvant changer d'une version à l'autre du Common Language Runtime. Dans certains cas, cela permet d'améliorer les performances de GetHashCode.

Remarque importanteImportant

Si deux objets String sont égaux, la méthode GetHashCode retourne des valeurs identiques. Cependant, il n'existe pas une valeur de code de hachage unique pour chaque valeur de chaîne unique. Différentes chaînes peuvent retourner le même code de hachage.

Il n'est pas garanti que le code de hachage est unique lui-même soit stable. Les codes de hachage pour les chaînes identiques peuvent différer entre les versions de .NET Framework et sur les plateformes (telles que 32 bits et 64 bits) pour une seule version du .NET Framework. Dans certains cas, il peut même différer par domaine d'application.

Par conséquent, les codes de hachage ne doivent jamais être utilisés en dehors du domaine d'application dans lequel ils ont été créés, ils ne doivent jamais être utilisés comme champs clés dans une collection, et ils ne doivent jamais être persistants.

Enfin, n'utilisez pas le code de hachage au lieu d'une valeur retournée par une fonction de hachage de chiffrement si vous avez besoin d'un hachage de chiffrement fort. Pour les hachages de chiffrement, utilisez une classe dérivée de System.Security.Cryptography.HashAlgorithm ou de la classe System.Security.Cryptography.KeyedHashAlgorithm.

Pour plus d'informations sur les codes de hachage, consultez Object.GetHashCode.

Dans les applications de bureau, vous pouvez utiliser l'élément<UseRandomizedStringHashAlgorithm> pour générer codes de hachage uniques par domaine d'application. Cela peut réduire le nombre de collisions et améliorer les performances globales des insertions et des recherches qui utilisent des tables de hachage. L'exemple suivant montre comment utiliser l'élément <UseRandomizedStringHashAlgorithm> . Il définit une classe DisplayString qui inclut une constante de chaîne privée, s, dont la valeur est « Ceci est une chaîne ». Il inclut également une méthode ShowStringHashCode qui affiche la valeur de chaîne et son code de hachage avec le nom du domaine d'application dans lequel la méthode est exécutée.


using System;

public class Example
{
   public static void Main()
   {
      // Show hash code in current domain.
      DisplayString display = new DisplayString();
      display.ShowStringHashCode();

      // Create a new app domain and show string hash code.
      AppDomain domain = AppDomain.CreateDomain("NewDomain");
      var display2 = (DisplayString) domain.CreateInstanceAndUnwrap(typeof(Example).Assembly.FullName, 
                                                          "DisplayString");   
      display2.ShowStringHashCode();
   }
}

public class DisplayString : MarshalByRefObject
{
   private String s = "This is a string.";

   public override bool Equals(Object obj)
   {
      String s2 = obj as String; 
      if (s2 == null)
         return false;
      else
         return s == s2; 
   }

   public bool Equals(String str)
   {
      return s == str;
   }    

   public override int GetHashCode()
   {
      return s.GetHashCode();
   }

   public override String ToString() 
   {
      return s;
   }

   public void ShowStringHashCode()
   {
      Console.WriteLine("String '{0}' in domain '{1}': {2:X8}",
                        s, AppDomain.CurrentDomain.FriendlyName, 
                        s.GetHashCode());
   }
}


Lorsque vous exécutez l'exemple sans fournir un fichier de configuration, il affiche une sortie similaire à la suivante. Notez que les codes de hachage pour la chaîne sont identiques dans les deux domaines d'application.


String 'This is a string.' in domain 'PerDomain.exe': 941BCEAC
String 'This is a string.' in domain 'NewDomain': 941BCEAC

Toutefois, si vous ajoutez le fichier de configuration suivant au répertoire de l'exemple, puis exécutez l'exemple, les codes de hachage pour la même chaîne diffèrent par domaine d'application.


<?xml version ="1.0"?>
<configuration>
   <runtime>
      <UseRandomizedStringHashAlgorithm enabled="1" />
   </runtime>
</configuration>

Lorsque le fichier de configuration est présent, l'exemple affiche la sortie suivante :


String 'This is a string.' in domain 'PerDomain.exe': 5435776D
String 'This is a string.' in domain 'NewDomain': 75CC8236

Remarque importanteImportant

Les codes de hachage sont utilisés pour insérer et récupérer les objets de clé à partir des tables de hachage efficacement. Toutefois, les codes de hachage ne reconnaissent pas uniquement les chaînes. Les chaînes identiques ont des codes de hachage égaux, mais Common Langage Runtime peut également assigner le même code de hachage à différentes chaînes. En outre, les codes de hachage peuvent varier selon la version du .NET Framework, selon la plateforme dans une seule version, et selon le domaine d'application. En raison de cela, vous ne devez pas sérialiser ou conserver des valeurs de code de hachage, vous ne devez pas non plus les utiliser en tant que clés dans une table de hachage ou un dictionnaire.

Pour plus d'informations sur l'utilisation de codes de hachage et de la méthode GetHashCode, consultez l'Object.GetHashCode.

Remarques à l'attention des appelants

La valeur retournée par GetHashCode dépend de la plateforme. Il diffère sur les versions 32 bits et 64 bits du .NET Framework. Elle peut également différer selon les versions du .NET Framework.

Mise en gardeAttention

Un code de hachage est prévu pour l'insertion efficace et la recherche dans les collections basées sur une table de hachage. Un code de hachage n'est pas une valeur définitive. C'est pourquoi :

  • Ne sérialisez pas les valeurs de code de hachage ou ne les enregistrez pas dans les bases de données.

  • N'utilisez pas le code de hachage comme clé pour récupérer un objet d'une collection comportant des clés.

  • N'utilisez pas le code de hachage en lieu et place d'une valeur retournée par une fonction de hachage de chiffrement. Pour les hachages de chiffrement, utilisez une classe dérivée de System.Security.Cryptography.HashAlgorithm ou de la classe System.Security.Cryptography.KeyedHashAlgorithm.

  • Ne testez pas l'égalité des codes de hachage pour déterminer si deux objets sont égaux. (Des objets différents peuvent avoir des codes de hachage identiques.) Pour tester l'égalité, appelez ReferenceEquals ou la méthode Equals.

L'exemple suivant illustre le fonctionnement de la méthode GetHashCode à l'aide de différentes chaînes d'entrée.


using System;

class GetHashCode 
{
    public static void Main() 
    {
        DisplayHashCode( "" );
        DisplayHashCode( "a" );
        DisplayHashCode( "ab" );
        DisplayHashCode( "abc" );
        DisplayHashCode( "abd" );
        DisplayHashCode( "abe" );
        DisplayHashCode( "abcdef" );
        DisplayHashCode( "abcdeg" );
        DisplayHashCode( "abcdeh" );
        DisplayHashCode( "abcdei" );
        DisplayHashCode( "Abcdeg" );
        DisplayHashCode( "Abcdeh" );
        DisplayHashCode( "Abcdei" );
    }

    static void DisplayHashCode( String Operand )
    {
        int     HashCode = Operand.GetHashCode( );
        Console.WriteLine("The hash code for \"{0}\" is: 0x{1:X8}, {1}",
                          Operand, HashCode );
    }
}
/*
      This example displays output like the following:
      The hash code for "" is: 0x2D2816FE, 757602046
      The hash code for "a" is: 0xCDCAB7BF, -842352705
      The hash code for "ab" is: 0xCDE8B7BF, -840386625
      The hash code for "abc" is: 0x2001D81A, 536991770
      The hash code for "abd" is: 0xC2A94CB5, -1029092171
      The hash code for "abe" is: 0x6550C150, 1699791184
      The hash code for "abcdef" is: 0x1762906D, 392335469
      The hash code for "abcdeg" is: 0x1763906D, 392401005
      The hash code for "abcdeh" is: 0x175C906D, 391942253
      The hash code for "abcdei" is: 0x175D906D, 392007789
      The hash code for "Abcdeg" is: 0x1763954D, 392402253
      The hash code for "Abcdeh" is: 0x175C954D, 391943501
      The hash code for "Abcdei" is: 0x175D954D, 392009037
*/


.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

Bibliothèque de classes portable

Pris en charge dans : Bibliothèque de classes portable

.NET pour les applications du Windows Store

Pris en charge dans : Windows 8

.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
Afficher:
© 2014 Microsoft