String.GetHashCode String.GetHashCode String.GetHashCode String.GetHashCode Method

Définition

Surcharges

GetHashCode(ReadOnlySpan<Char>, StringComparison) GetHashCode(ReadOnlySpan<Char>, StringComparison) GetHashCode(ReadOnlySpan<Char>, StringComparison) GetHashCode(ReadOnlySpan<Char>, StringComparison)

Retourne le code de hachage pour l’étendue de caractères en lecture seule fournie, en utilisant les règles spécifiées.Returns the hash code for the provided read-only character span using the specified rules.

GetHashCode(StringComparison) GetHashCode(StringComparison) GetHashCode(StringComparison) GetHashCode(StringComparison)

Retourne le code de hachage pour cette chaîne à l’aide des règles spécifiées.Returns the hash code for this string using the specified rules.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Retourne le code de hachage pour cette chaîne.Returns the hash code for this string.

GetHashCode(ReadOnlySpan<Char>) GetHashCode(ReadOnlySpan<Char>) GetHashCode(ReadOnlySpan<Char>) GetHashCode(ReadOnlySpan<Char>)

Retourne le code de hachage pour l’étendue de caractères en lecture seule fournie.Returns the hash code for the provided read-only character span.

GetHashCode(ReadOnlySpan<Char>, StringComparison) GetHashCode(ReadOnlySpan<Char>, StringComparison) GetHashCode(ReadOnlySpan<Char>, StringComparison) GetHashCode(ReadOnlySpan<Char>, StringComparison)

Retourne le code de hachage pour l’étendue de caractères en lecture seule fournie, en utilisant les règles spécifiées.Returns the hash code for the provided read-only character span using the specified rules.

public:
 static int GetHashCode(ReadOnlySpan<char> value, StringComparison comparisonType);
public static int GetHashCode (ReadOnlySpan<char> value, StringComparison comparisonType);
static member GetHashCode : ReadOnlySpan<char> * StringComparison -> int
Public Shared Function GetHashCode (value As ReadOnlySpan(Of Char), comparisonType As StringComparison) As Integer

Paramètres

value
ReadOnlySpan<Char>

Étendue de caractères en lecture seule.A read-only character span.

comparisonType
StringComparison StringComparison StringComparison StringComparison

Une des valeurs d'énumération qui spécifie les règles à utiliser dans la comparaison.One of the enumeration values that specifies the rules to use in the comparison.

Retours

Code de hachage d'un entier signé 32 bits.A 32-bit signed integer hash code.

GetHashCode(StringComparison) GetHashCode(StringComparison) GetHashCode(StringComparison) GetHashCode(StringComparison)

Retourne le code de hachage pour cette chaîne à l’aide des règles spécifiées.Returns the hash code for this string using the specified rules.

public:
 int GetHashCode(StringComparison comparisonType);
public int GetHashCode (StringComparison comparisonType);
override this.GetHashCode : StringComparison -> int
Public Function GetHashCode (comparisonType As StringComparison) As Integer

Paramètres

comparisonType
StringComparison StringComparison StringComparison StringComparison

Une des valeurs d'énumération qui spécifie les règles à utiliser dans la comparaison.One of the enumeration values that specifies the rules to use in the comparison.

Retours

Code de hachage d'un entier signé 32 bits.A 32-bit signed integer hash code.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Retourne le code de hachage pour cette chaîne.Returns the hash code for this string.

public:
 override int GetHashCode();
public override int GetHashCode ();
override this.GetHashCode : unit -> int
Public Overrides Function GetHashCode () As Integer

Retours

Code de hachage d'un entier signé 32 bits.A 32-bit signed integer hash code.

Exemples

L’exemple suivant illustre la GetHashCode méthode à l’aide de différentes chaînes d’entrée.The following example demonstrates the GetHashCode method using various input strings.

using namespace System;

void DisplayHashCode( String^ Operand )
{
   int HashCode = Operand->GetHashCode();
   Console::WriteLine( "The hash code for \"{0}\" is: 0x{1:X8}, {1}", Operand, HashCode );
}

int 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" );
}

/*
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
*/
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
*/
Module GetHashCode
    Sub 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")
    End Sub
       
    Sub DisplayHashCode(Operand As String)
        Dim HashCode As Integer = Operand.GetHashCode()
        Console.WriteLine("The hash code for ""{0}"" is: 0x{1:X8}, {1}", 
                          Operand, HashCode)
    End Sub 
End Module 
' 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

Remarques

Le comportement de GetHashCode dépend de son implémentation, qui peut changer d’une version de la Common Language Runtime à une autre.The behavior of GetHashCode is dependent on its implementation, which might change from one version of the common language runtime to another. Cela peut être dû à l’amélioration des performances de GetHashCode.A reason why this might happen is to improve the performance of GetHashCode.

Important

Si deux objets String sont égaux, la GetHashCode méthode retourne des valeurs identiques.If two string objects are equal, the GetHashCode method returns identical values. Toutefois, il n’existe pas de valeur de code de hachage unique pour chaque valeur de chaîne unique.However, there is not a unique hash code value for each unique string value. Des chaînes différentes peuvent retourner le même code de hachage.Different strings can return the same hash code.

La stabilité du code de hachage lui-même n’est pas garantie.The hash code itself is not guaranteed to be stable. Les codes de hachage pour les chaînes identiques peuvent différer entre les implémentations de .NET, entre les versions .NET et entre les plateformes .NET (par exemple, 32 bits et 64 bits) pour une version unique de .NET.Hash codes for identical strings can differ across .NET implementations, across .NET versions, and across .NET platforms (such as 32-bit and 64-bit) for a single version of .NET. Dans certains cas, ils peuvent même varier par domaine d’application.In some cases, they can even differ by application domain. Cela implique que deux exécutions ultérieures du même programme peuvent retourner des codes de hachage différents.This implies that two subsequent runs of the same program may return different hash codes.

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 en tant que champs clés dans une collection et ne doivent jamais être rendus persistants.As a result, hash codes should never be used outside of the application domain in which they were created, they should never be used as key fields in a collection, and they should never be persisted.

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 fort par chiffrement.Finally, don't use the hash code instead of a value returned by a cryptographic hashing function if you need a cryptographically strong hash. Pour les hachages de chiffrement, utilisez une classe System.Security.Cryptography.HashAlgorithm dérivée de la classe ou System.Security.Cryptography.KeyedHashAlgorithm .For cryptographic hashes, use a class derived from the System.Security.Cryptography.HashAlgorithm or System.Security.Cryptography.KeyedHashAlgorithm class.

Pour plus d’informations sur les codes de Object.GetHashCodehachage, consultez.For more information about hash codes, see Object.GetHashCode.

Dans les applications de bureau, vous pouvez utiliser l' <élément UseRandomizedStringHashAlgorithm > pour générer des codes de hachage uniques pour chaque domaine d’application.In desktop apps, you can use the <UseRandomizedStringHashAlgorithm> element to generate unique hash codes on a per application domain basis. 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.This can reduce the number of collisions and improve the overall performance of insertions and lookups that use hash tables. L’exemple suivant montre comment utiliser l' <élément UseRandomizedStringHashAlgorithm >.The following example shows how to use the <UseRandomizedStringHashAlgorithm> element. Il définit une DisplayString classe qui comprend une constante de chaîne privée s,, dont la valeur est « This is a String ».It defines a DisplayString class that includes a private string constant, s, whose value is "This is a string." 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.It also includes a ShowStringHashCode method that displays the string value and its hash code along with the name of the application domain in which the method is executing.

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());
   }
}
Module Example
   Public Sub Main()
      ' Show hash code in current domain.
      Dim display As New DisplayString()
      display.ShowStringHashCode()
      
      ' Create a new app domain and show string hash code.
      Dim domain As AppDomain = AppDomain.CreateDomain("NewDomain")
      Dim display2 = CType(domain.CreateInstanceAndUnwrap(GetType(Example).Assembly.FullName, 
                                                          "DisplayString"), DisplayString)   
      display2.ShowStringHashCode()
   End Sub
End Module

Public Class DisplayString : Inherits MarshalByRefObject

   Private s As String = "This is a string."
   
   Public Overrides Function Equals(obj As Object) As Boolean
      Dim s2 As String = TryCast(obj, String)
      If s2 Is Nothing Then
         Return False
      Else
         Return s = s2 
      End If
   End Function

   Public Overloads Function Equals(str As String) As Boolean
      Return s = str
   End Function    
   
   Public Overrides Function GetHashCode() As Integer
      Return s.GetHashCode()
   End Function
   
   Public Overrides Function ToString() As String
      Return s
   End Function

   Public Sub ShowStringHashCode()
      Console.WriteLine("String '{0}' in domain '{1}': {2:X8}",
                        s, AppDomain.CurrentDomain.FriendlyName, 
                        s.GetHashCode())
   End Sub
End Class

Lorsque vous exécutez l'exemple sans fournir un fichier de configuration, il affiche une sortie similaire à la suivante.When you run the example without supplying a configuration file, it displays output similar to the following. Notez que les codes de hachage pour la chaîne sont identiques dans les deux domaines d'application.Note that the hash codes for the string are identical in the two application domains.

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.However, if you add the following configuration file to the example's directory and then run the example, the hash codes for the same string will differ by application domain.

<?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 :When the configuration file is present, the example displays the following output:

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

Important

Les codes de hachage sont utilisés pour insérer et récupérer efficacement des objets indexés à partir de tables de hachage.Hash codes are used to insert and retrieve keyed objects from hash tables efficiently. Toutefois, les codes de hachage n’identifient pas de façon unique les chaînes.However, hash codes don't uniquely identify strings. Les chaînes identiques ont des codes de hachage égaux, mais le common language runtime peut également assigner le même code de hachage à différentes chaînes.Identical strings have equal hash codes, but the common language runtime can also assign the same hash code to different strings. En outre, les codes de hachage peuvent varier selon la version de .NET, par plateforme au sein d’une version unique et par domaine d’application.In addition, hash codes can vary by version of .NET, by platform within a single version, and by application domain. Pour cette raison, vous ne devez pas sérialiser ou conserver les valeurs de code de hachage, ni les utiliser en tant que clés dans une table de hachage ou un dictionnaire.Because of this, you should not serialize or persist hash code values, nor should you use them as keys in a hash table or dictionary.

Pour plus d’informations sur l’utilisation des codes de hachage GetHashCode et de la Object.GetHashCodeméthode, consultez.For additional information about the use of hash codes and the GetHashCode method, see Object.GetHashCode.

Notes pour les appelants

La valeur retournée GetHashCode() par dépend de la plateforme.The value returned by GetHashCode() is platform-dependent. Il diffère sur les versions 32 bits et 64 bits du .NET Framework.It differs on the 32-bit and 64-bit versions of the .NET Framework. Il peut également être différent entre les versions du .NET Framework et .NET Core.It also can differ between versions of the .NET Framework and .NET Core.

Voir aussi

GetHashCode(ReadOnlySpan<Char>) GetHashCode(ReadOnlySpan<Char>) GetHashCode(ReadOnlySpan<Char>) GetHashCode(ReadOnlySpan<Char>)

Retourne le code de hachage pour l’étendue de caractères en lecture seule fournie.Returns the hash code for the provided read-only character span.

public:
 static int GetHashCode(ReadOnlySpan<char> value);
public static int GetHashCode (ReadOnlySpan<char> value);
static member GetHashCode : ReadOnlySpan<char> -> int
Public Shared Function GetHashCode (value As ReadOnlySpan(Of Char)) As Integer

Paramètres

value
ReadOnlySpan<Char>

Étendue de caractères en lecture seule.A read-only character span.

Retours

Code de hachage d'un entier signé 32 bits.A 32-bit signed integer hash code.

S’applique à