String.GetHashCode Metoda

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

Přetížení

Name	Description
GetHashCode(ReadOnlySpan<Char>, StringComparison)	Vrátí kód hash pro zadané rozsahy znaků jen pro čtení pomocí zadaných pravidel.
GetHashCode(StringComparison)	Vrátí kód hash pro tento řetězec pomocí zadaných pravidel.
GetHashCode()	Vrátí kód hash pro tento řetězec.
GetHashCode(ReadOnlySpan<Char>)	Vrátí kód hash zadaného rozsahu znaků jen pro čtení.

GetHashCode(ReadOnlySpan<Char>, StringComparison)

Zdroj:

String.Comparison.cs

Vrátí kód hash pro zadané rozsahy znaků jen pro čtení pomocí zadaných pravidel.

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

Parametry

value

ReadOnlySpan<Char>

Rozsah znaků jen pro čtení.

comparisonType

StringComparison

Jedna z hodnot výčtu, která určuje pravidla, která se mají použít při porovnání.

Návraty

Int32

32bitový celočíselná hodnota hash kódu.

GetHashCode(StringComparison)

Zdroj:

String.Comparison.cs

Vrátí kód hash pro tento řetězec pomocí zadaných pravidel.

public:
 int GetHashCode(StringComparison comparisonType);

public int GetHashCode(StringComparison comparisonType);

override this.GetHashCode : StringComparison -> int

Public Function GetHashCode (comparisonType As StringComparison) As Integer

Parametry

comparisonType

StringComparison

Jedna z hodnot výčtu, která určuje pravidla, která se mají použít při porovnání.

Návraty

Int32

32bitový celočíselná hodnota hash kódu.

GetHashCode()

Zdroj:

String.Comparison.cs

Vrátí kód hash pro tento řetězec.

public:
 override int GetHashCode();

public override int GetHashCode();

override this.GetHashCode : unit -> int

Public Overrides Function GetHashCode () As Integer

Návraty

Int32

32bitový celočíselná hodnota hash kódu.

Příklady

Následující příklad ukazuje metodu GetHashCode pomocí různých vstupních řetězců.

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

Poznámky

Chování GetHashCode závisí na implementaci, která se může změnit z jedné verze modulu CLR (Common Language Runtime) na jinou. Důvodem, proč k tomu může dojít, je zlepšit výkon GetHashCode.

Důležité

Pokud jsou dva řetězcové objekty stejné, GetHashCode metoda vrátí identické hodnoty. Neexistuje však jedinečná hodnota kódu hash pro každou jedinečnou řetězcovou hodnotu. Různé řetězce můžou vrátit stejný kód hash.

Samotný hashový kód není zaručen stabilní. Kódy hash pro identické řetězce se můžou lišit v implementacích .NET, ve verzích .NET a napříč platformami .NET (například 32bitovou a 64bitovou) pro jednu verzi .NET. V některých případech se můžou dokonce lišit podle domény aplikace. To znamená, že dvě následná spuštění stejného programu můžou vracet různé hashovací kódy.

V důsledku toho by se kódy hash nikdy neměly používat mimo doménu aplikace, ve které byly vytvořeny, nikdy by se neměly používat jako pole klíčů v kolekci a nikdy by neměly být trvalé.

Nakonec nepoužívejte kód hash místo hodnoty vrácené kryptografickou hashovací funkcí, pokud potřebujete kryptograficky silnou hodnotu hash. Pro kryptografické hodnoty hash použijte třídu odvozenou z System.Security.Cryptography.HashAlgorithm třídy nebo System.Security.Cryptography.KeyedHashAlgorithm třídy.

Další informace o kódech hash naleznete v tématu Object.GetHashCode.

V desktopových aplikacích .NET Framework můžete použít <element UseRandomizedStringHashAlgorithm> k vygenerování jedinečných hash kódů na základě domény pro jednotlivé aplikace. To může snížit počet kolizí a zlepšit celkový výkon vkládání a vyhledávání, které používají tabulky hash. Následující příklad ukazuje, jak použít <UseRandomizedStringHashAlgorithm> element. DisplayString Definuje třídu, která obsahuje soukromou řetězcovou konstantu, sjejíž hodnota je "Toto je řetězec". Obsahuje také metoduShowStringHashCode, která zobrazuje řetězcovou hodnotu a kód hash spolu s názvem domény aplikace, ve které se metoda spouští.

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

Při spuštění příkladu bez zadání konfiguračního souboru se zobrazí výstup podobný následujícímu. Všimněte si, že kódy hash řetězce jsou identické ve dvou doménách aplikace.

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

Pokud však do adresáře příkladu přidáte následující konfigurační soubor a pak tento příklad spustíte, kódy hash pro stejný řetězec se budou lišit podle domény aplikace.

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

Když je konfigurační soubor k dispozici, zobrazí se v příkladu následující výstup:

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

Důležité

Kódy hash se používají k efektivnímu vkládání a načítání klíčových objektů z tabulek hash. Kódy hash ale neidentifikují řetězce jedinečně. Identické řetězce mají stejné hashovací kódy, ale modul CLR (Common Language Runtime) může také přiřadit stejný kód hash různým řetězcům. Kromě toho se kódy hash můžou lišit podle verze .NET, podle platformy v rámci jedné verze a podle domény aplikace. Z tohoto důvodu byste neměli serializovat ani uchovávat hodnoty hash kódu, ani byste je neměli používat jako klíče v tabulce hash nebo slovníku.

Další informace o použití kódů hash a GetHashCode metody naleznete v tématu Object.GetHashCode.

Poznámky pro volající

Hodnota vrácená platformou GetHashCode() je závislá na platformě. Liší se v 32bitové a 64bitové verzi rozhraní .NET Framework. Může se také lišit mezi verzemi rozhraní .NET Framework a .NET Core.

Viz také

• GetHashCode()
• <UseRandomizedStringHashAlgorithm> – element

GetHashCode(ReadOnlySpan<Char>)

Zdroj:

String.Comparison.cs

Vrátí kód hash zadaného rozsahu znaků jen pro čtení.

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

Parametry

value

ReadOnlySpan<Char>

Rozsah znaků jen pro čtení.

Návraty

Int32

32bitový celočíselná hodnota hash kódu.