String.GetHashCode Methode

Definitie

Naamruimte:
System
Assembly's:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll
Assembly's:
mscorlib.dll, System.Runtime.dll
Assembly:
mscorlib.dll

Overloads

Name Description
GetHashCode(ReadOnlySpan<Char>, StringComparison)

Retourneert de hash-code voor het opgegeven tekenbereik met het kenmerk Alleen-lezen met behulp van de opgegeven regels.
GetHashCode(StringComparison)

Retourneert de hashcode voor deze tekenreeks met behulp van de opgegeven regels.
GetHashCode()

Retourneert de hash-code voor deze tekenreeks.
GetHashCode(ReadOnlySpan<Char>)

Retourneert de hash-code voor het opgegeven tekenbereik met het kenmerk Alleen-lezen.

GetHashCode(ReadOnlySpan<Char>, StringComparison)

Bron:
String.Comparison.cs
Bron:
String.Comparison.cs
Bron:
String.Comparison.cs
Bron:
String.Comparison.cs
Bron:
String.Comparison.cs

Retourneert de hash-code voor het opgegeven tekenbereik met het kenmerk Alleen-lezen met behulp van de opgegeven regels.

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

Parameters

value
ReadOnlySpan<Char>

Een alleen-lezen tekenbereik.

comparisonType
StringComparison

Een van de opsommingswaarden die de regels specificeert die in de vergelijking moeten worden gebruikt.

Retouren

Int32

Een 32-bits ondertekende hashcode voor gehele getallen.

Van toepassing op

GetHashCode(StringComparison)

Bron:
String.Comparison.cs
Bron:
String.Comparison.cs
Bron:
String.Comparison.cs
Bron:
String.Comparison.cs
Bron:
String.Comparison.cs

Retourneert de hashcode voor deze tekenreeks met behulp van de opgegeven regels.

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

Parameters

comparisonType
StringComparison

Een van de opsommingswaarden die de regels specificeert die in de vergelijking moeten worden gebruikt.

Retouren

Int32

Een 32-bits ondertekende hashcode voor gehele getallen.

Van toepassing op

GetHashCode()

Bron:
String.Comparison.cs
Bron:
String.Comparison.cs
Bron:
String.Comparison.cs
Bron:
String.Comparison.cs
Bron:
String.Comparison.cs

Retourneert de hash-code voor deze tekenreeks.

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

Retouren

Int32

Een 32-bits ondertekende hashcode voor gehele getallen.

Voorbeelden

In het volgende voorbeeld ziet u de GetHashCode methode met behulp van verschillende invoertekenreeksen.

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
*/

let displayHashCode operand =
    let hashCode = operand.GetHashCode()
    printfn $"The hash code for \"%s{operand}\" is: 0x{1:X8}, {hashCode}"

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

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

Opmerkingen

Het gedrag van is afhankelijk van GetHashCode de implementatie, die kan veranderen van de ene versie van de algemene taalruntime naar een andere. Een reden waarom dit kan gebeuren is om de prestaties van GetHashCode.

Important

Als twee tekenreeksobjecten gelijk zijn, retourneert de GetHashCode methode identieke waarden. Er is echter geen unieke hashcodewaarde voor elke unieke tekenreekswaarde. Verschillende tekenreeksen kunnen dezelfde hash-code retourneren.

De hash-code zelf is niet gegarandeerd stabiel. Hash-codes voor identieke tekenreeksen kunnen verschillen tussen .NET implementaties, in .NET versies en op .NET platforms (zoals 32-bits en 64-bits) voor één versie van .NET. In sommige gevallen kunnen ze zelfs verschillen per toepassingsdomein. Dit impliceert dat twee volgende uitvoeringen van hetzelfde programma verschillende hash-codes kunnen retourneren.

Als gevolg hiervan mogen hashcodes nooit worden gebruikt buiten het toepassingsdomein waarin ze zijn gemaakt, ze mogen nooit worden gebruikt als sleutelvelden in een verzameling en mogen ze nooit worden bewaard.

Gebruik ten slotte niet de hashcode in plaats van een waarde die wordt geretourneerd door een cryptografische hashfunctie als u een cryptografische sterke hash nodig hebt. Gebruik voor cryptografische hashes een klasse die is afgeleid van de System.Security.Cryptography.HashAlgorithm of System.Security.Cryptography.KeyedHashAlgorithm klasse.

Zie voor meer informatie over hash-codes Object.GetHashCode.

In .NET Framework-bureaublad-apps kunt u het <UseRandomizedStringHashAlgorithm> element gebruiken om unieke hash-codes per toepassingsdomein te genereren. Dit kan het aantal conflicten verminderen en de algehele prestaties van invoegingen en zoekacties die gebruikmaken van hashtabellen verbeteren. In het volgende voorbeeld ziet u hoe u het <element UseRandomizedStringHashAlgorithm> gebruikt. Hiermee wordt een DisplayString klasse gedefinieerd die een persoonlijke tekenreeksconstante bevat, swaarvan de waarde 'Dit is een tekenreeks' is. Het bevat ook een ShowStringHashCode methode waarmee de tekenreekswaarde en de hashcode worden weergegeven, samen met de naam van het toepassingsdomein waarin de methode wordt uitgevoerd.

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());
   }
}

open System

type DisplayString() =
    inherit MarshalByRefObject()
    let s = "This is a string."
   
    override _.Equals(obj) =
        match obj with
        | :? string as s2 -> s = s2
        | _ -> false

    member _.Equals(str) =
        s = str
   
    override _.GetHashCode() =
        s.GetHashCode()
   
    override _.ToString() = 
        s

    member _.ShowStringHashCode() =
        printfn $"String '{s}' in domain '{AppDomain.CurrentDomain.FriendlyName}': {s.GetHashCode():X8}"

// Show hash code in current domain.
let display = DisplayString()
display.ShowStringHashCode()

// Create a new app domain and show string hash code.
let domain = AppDomain.CreateDomain "NewDomain"
let display2 = domain.CreateInstanceAndUnwrap(typeof<DisplayString>.Assembly.FullName, "DisplayString") :?> DisplayString   
display2.ShowStringHashCode()

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

Wanneer u het voorbeeld uitvoert zonder een configuratiebestand op te geven, wordt uitvoer weergegeven die vergelijkbaar is met het volgende. Houd er rekening mee dat de hashcodes voor de tekenreeks identiek zijn in de twee toepassingsdomeinen.

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

Als u echter het volgende configuratiebestand toevoegt aan de map van het voorbeeld en vervolgens het voorbeeld uitvoert, verschillen de hashcodes voor dezelfde tekenreeks per toepassingsdomein.

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

Wanneer het configuratiebestand aanwezig is, wordt in het voorbeeld de volgende uitvoer weergegeven:

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

Important

Hash-codes worden gebruikt om sleutelobjecten efficiënt in te voegen en op te halen uit hashtabellen. Hash-codes identificeren echter geen tekenreeksen op unieke wijze. Identieke tekenreeksen hebben gelijke hash-codes, maar de algemene taalruntime kan ook dezelfde hash-code toewijzen aan verschillende tekenreeksen. Bovendien kunnen hashcodes variëren per versie van .NET, per platform binnen één versie en per toepassingsdomein. Daarom moet u geen hashcodewaarden serialiseren of behouden, en moet u ze ook niet gebruiken als sleutels in een hash-tabel of -woordenlijst.

Zie GetHashCodevoor meer informatie over het gebruik van hash-codes en de Object.GetHashCode methode.

Notities voor bellers

De waarde die wordt geretourneerd door GetHashCode() is platformafhankelijk. Het verschilt van de 32-bits en 64-bits versies van .NET Framework. Het kan ook verschillen tussen versies van .NET Framework en .NET Core.

Zie ook

Van toepassing op

GetHashCode(ReadOnlySpan<Char>)

Bron:
String.Comparison.cs
Bron:
String.Comparison.cs
Bron:
String.Comparison.cs
Bron:
String.Comparison.cs
Bron:
String.Comparison.cs

Retourneert de hash-code voor het opgegeven tekenbereik met het kenmerk Alleen-lezen.

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

Parameters

value
ReadOnlySpan<Char>

Een alleen-lezen tekenbereik.

Retouren

Int32

Een 32-bits ondertekende hashcode voor gehele getallen.

Van toepassing op