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

Definition

Überlädt

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

Gibt den Hashcode für die angegebene schreibgeschützte Zeichenspanne gemäß der festgelegten Regeln zurück.Returns the hash code for the provided read-only character span using the specified rules.

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

Gibt den Hashcode für diese Zeichenfolge gemäß der festgelegten Regeln zurück.Returns the hash code for this string using the specified rules.

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

Gibt den Hashcode für diese Zeichenfolge zurück.Returns the hash code for this string.

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

Gibt den Hashcode für die angegebene schreibgeschützte Zeichenspanne zurück.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)

Gibt den Hashcode für die angegebene schreibgeschützte Zeichenspanne gemäß der festgelegten Regeln zurück.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

Parameter

value
ReadOnlySpan<Char>

Eine schreibgeschützte Zeichenspanne.A read-only character span.

comparisonType
StringComparison StringComparison StringComparison StringComparison

Einer der Enumerationswerte, der die für den Vergleich zu verwendenden Regeln angibt.One of the enumeration values that specifies the rules to use in the comparison.

Gibt zurück

Ein 32-Bit-Hashcode als ganze Zahl mit Vorzeichen.A 32-bit signed integer hash code.

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

Gibt den Hashcode für diese Zeichenfolge gemäß der festgelegten Regeln zurück.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

Parameter

comparisonType
StringComparison StringComparison StringComparison StringComparison

Einer der Enumerationswerte, der die für den Vergleich zu verwendenden Regeln angibt.One of the enumeration values that specifies the rules to use in the comparison.

Gibt zurück

Ein 32-Bit-Hashcode als ganze Zahl mit Vorzeichen.A 32-bit signed integer hash code.

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

Gibt den Hashcode für diese Zeichenfolge zurück.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

Gibt zurück

Ein 32-Bit-Hashcode als ganze Zahl mit Vorzeichen.A 32-bit signed integer hash code.

Beispiele

Im folgenden Beispiel wird die GetHashCode -Methode mithilfe verschiedener Eingabe Zeichenfolgen veranschaulicht.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

Hinweise

Das Verhalten von GetHashCode hängt von der Implementierung ab, die sich von einer Version der Common Language Runtime in eine andere ändern kann.The behavior of GetHashCode is dependent on its implementation, which might change from one version of the common language runtime to another. Ein Grund, warum dies passieren kann, ist die Verbesserung der GetHashCodeLeistung von.A reason why this might happen is to improve the performance of GetHashCode.

Wichtig

Wenn zwei Zeichen folgen Objekte gleich sind, GetHashCode gibt die Methode identische Werte zurück.If two string objects are equal, the GetHashCode method returns identical values. Es gibt jedoch keinen eindeutigen Hashcodewert für jeden eindeutigen Zeichen folgen Wert.However, there is not a unique hash code value for each unique string value. Verschiedene Zeichen folgen können den gleichen Hashcode zurückgeben.Different strings can return the same hash code.

Der Hashcode selbst ist nicht garantiert stabil.The hash code itself is not guaranteed to be stable. Hashcodes für identische Zeichen folgen können in .net-Implementierungen, über .NET-Versionen und über .net-Plattformen (z. b. 32-Bit und 64-Bit) für eine einzelne Version von .net abweichen.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. In einigen Fällen können Sie sich sogar je nach Anwendungsdomäne unterscheiden.In some cases, they can even differ by application domain. Dies bedeutet, dass zwei nachfolgende Ausführungen desselben Programms möglicherweise andere Hashcodes zurückgeben.This implies that two subsequent runs of the same program may return different hash codes.

Daher sollten Hashcodes nie außerhalb der Anwendungsdomäne verwendet werden, in der Sie erstellt wurden. Sie sollten nie als Schlüsselfelder in einer Auflistung verwendet werden, und Sie sollten niemals persistent gespeichert werden.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.

Verwenden Sie zum Schluss nicht den Hashcode anstelle eines Werts, der von einer kryptografischen Hash Funktion zurückgegeben wird, wenn Sie einen kryptografisch starken Hash benötigen.Finally, don't use the hash code instead of a value returned by a cryptographic hashing function if you need a cryptographically strong hash. Verwenden Sie für kryptografische Hashes eine Klasse, die von System.Security.Cryptography.HashAlgorithm der System.Security.Cryptography.KeyedHashAlgorithm -Klasse oder der-Klasse abgeleitet ist.For cryptographic hashes, use a class derived from the System.Security.Cryptography.HashAlgorithm or System.Security.Cryptography.KeyedHashAlgorithm class.

Weitere Informationen zu Hashcodes finden Object.GetHashCodeSie unter.For more information about hash codes, see Object.GetHashCode.

In Desktop-Apps können Sie das <userandomizedstringhashalgorithm->-Element verwenden, um eindeutige Hashcodes pro Anwendungsdomäne zu generieren.In desktop apps, you can use the <UseRandomizedStringHashAlgorithm> element to generate unique hash codes on a per application domain basis. Dadurch kann die Anzahl von Kollisionen reduziert und die Gesamtleistung von Einfügungen und Such Vorgängen, die Hash Tabellen verwenden, verbessert werden.This can reduce the number of collisions and improve the overall performance of insertions and lookups that use hash tables. Im folgenden Beispiel wird gezeigt, wie das <userandomizedstringhashalgorithm-> Elementverwendet wird.The following example shows how to use the <UseRandomizedStringHashAlgorithm> element. Es wird eine DisplayString Klasse definiert, die eine private Zeichen folgen sKonstante enthält, deren Wert "This is a String" ist.It defines a DisplayString class that includes a private string constant, s, whose value is "This is a string." Außerdem enthält sie eine ShowStringHashCode-Methode, die den Zeichenfolgenwert und dessen Hashcode zusammen mit dem Namen der Anwendungsdomäne anzeigt, in der die Methode ausgeführt wird.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

Wenn Sie das Beispiel ausführen, ohne eine Konfigurationsdatei anzugeben, wird die folgende Ausgabe angezeigt.When you run the example without supplying a configuration file, it displays output similar to the following. Beachten Sie, dass die Hashcodes für die Zeichenfolge in den zwei Anwendungsdomänen identisch sind.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

Wenn Sie jedoch die folgende Konfigurationsdatei im Verzeichnis des Beispiels hinzufügen und dann das Beispiel ausführen, unterscheiden sich die Hashcodes je nach Anwendungsdomäne.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>

Wenn die Konfigurationsdatei vorhanden ist, zeigt das Beispiel die folgende Ausgabe an: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

Wichtig

Hashcodes werden verwendet, um Schlüssel gebundene Objekte effizient aus Hash Tabellen einzufügen und abzurufen.Hash codes are used to insert and retrieve keyed objects from hash tables efficiently. Mit Hashcodes werden Zeichen folgen jedoch nicht eindeutig identifiziert.However, hash codes don't uniquely identify strings. Identische Zeichen folgen haben gleiche Hashcodes, aber die Common Language Runtime können auch den gleichen Hashcode anderen Zeichen folgen zuweisen.Identical strings have equal hash codes, but the common language runtime can also assign the same hash code to different strings. Außerdem können Hashcodes je nach Version von .net, nach Plattform innerhalb einer einzelnen Version und nach Anwendungsdomäne variieren.In addition, hash codes can vary by version of .NET, by platform within a single version, and by application domain. Aus diesem Grund sollten Sie Hash Code Werte weder serialisieren noch persistent speichern, auch wenn Sie nicht als Schlüssel in einer Hash Tabelle oder einem Wörterbuch verwendet werden.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.

Weitere Informationen zur Verwendung von Hashcodes und der GetHashCode -Methode finden Object.GetHashCodeSie unter.For additional information about the use of hash codes and the GetHashCode method, see Object.GetHashCode.

Hinweise für Aufrufer

Der von GetHashCode() zurückgegebene Wert ist plattformabhängig.The value returned by GetHashCode() is platform-dependent. Dies unterscheidet sich von der 32-Bit-Version und der 64-Bit-Version der .NET Framework.It differs on the 32-bit and 64-bit versions of the .NET Framework. Sie kann sich auch zwischen den Versionen der .NET Framework und .net Core unterscheiden.It also can differ between versions of the .NET Framework and .NET Core.

Siehe auch

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

Gibt den Hashcode für die angegebene schreibgeschützte Zeichenspanne zurück.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

Parameter

value
ReadOnlySpan<Char>

Eine schreibgeschützte Zeichenspanne.A read-only character span.

Gibt zurück

Ein 32-Bit-Hashcode als ganze Zahl mit Vorzeichen.A 32-bit signed integer hash code.

Gilt für: