String.GetHashCode Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přetížení
GetHashCode(ReadOnlySpan<Char>, StringComparison) |
Vrátí kód hash pro zadaný rozsah znaků jen pro čtení pomocí zadaných pravidel. |
GetHashCode(StringComparison) |
Vrátí kód hash pro tento řetězec pomocí zadaných pravidel. |
GetHashCode(ReadOnlySpan<Char>) |
Vrátí kód hash pro zadaný rozsah znaků jen pro čtení. |
GetHashCode() |
Vrátí kód hash pro tento řetězec. |
GetHashCode(ReadOnlySpan<Char>, StringComparison)
- Zdroj:
- String.Comparison.cs
- Zdroj:
- String.Comparison.cs
- Zdroj:
- String.Comparison.cs
Vrátí kód hash pro zadaný rozsah 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 v porovnání.
Návraty
Kód hash v podobě 32bitového čísla se znaménkem.
Platí pro
GetHashCode(StringComparison)
- Zdroj:
- String.Comparison.cs
- Zdroj:
- String.Comparison.cs
- 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 v porovnání.
Návraty
Kód hash v podobě 32bitového čísla se znaménkem.
Platí pro
GetHashCode(ReadOnlySpan<Char>)
- Zdroj:
- String.Comparison.cs
- Zdroj:
- String.Comparison.cs
- Zdroj:
- String.Comparison.cs
Vrátí kód hash pro zadaný rozsah 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
Kód hash v podobě 32bitového čísla se znaménkem.
Platí pro
GetHashCode()
- Zdroj:
- String.Comparison.cs
- Zdroj:
- String.Comparison.cs
- 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
Kód hash v podobě 32bitového čísla se znaménkem.
Příklady
Následující příklad ukazuje metodu GetHashCode pomocí různých vstupních řetězců.
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
*/
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 jeho 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šení výkonu nástroje GetHashCode.
Důležité
Pokud jsou dva řetězcové objekty stejné, GetHashCode vrátí metoda identické hodnoty. Neexistuje však jedinečná hodnota hash kódu pro každou jedinečnou hodnotu řetězce. Různé řetězce můžou vrátit stejný kód hash.
Není zaručeno, že samotný hashovací kód bude stabilní. Kódy hash pro identické řetězce se můžou lišit v implementacích .NET, ve verzích .NET a na platformách .NET (například 32bitové a 64bitové) pro jednu verzi .NET. V některých případech se můžou dokonce lišit podle domény aplikace. To znamená, že dvě další spuštění stejného programu mohou vrátit různé hash 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é.
Pokud potřebujete kryptograficky silnou hodnotu hash, nepoužívejte místo hodnoty vrácené kryptografickou hashovací funkcí hash kód hash. Pro kryptografické hodnoty hash použijte třídu odvozenou z System.Security.Cryptography.HashAlgorithm třídy nebo System.Security.Cryptography.KeyedHashAlgorithm .
Další informace o kódech hash najdete v tématu Object.GetHashCode.
V desktopových aplikacích .NET Framework můžete použít <element UseRandomizedStringHashAlgorithm> ke generování jedinečných hash kódů pro jednotlivé domény 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í zatřiďovací tabulky. Následující příklad ukazuje, jak použít <UseRandomizedStringHashAlgorithm> element. Definuje DisplayString
třídu, která obsahuje privátní řetězcovou konstantu , s
jejíž hodnota je "This is a string" (Tento řetězec je řetězec). Obsahuje také metodu ShowStringHashCode
, která zobrazuje hodnotu řetězce a jeho hashový kód 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
Když spustíte příklad bez zadání konfiguračního souboru, zobrazí se výstup podobný následujícímu. Všimněte si, že kódy hash pro řetězec jsou v obou doménách aplikace identické.
String 'This is a string.' in domain 'PerDomain.exe': 941BCEAC
String 'This is a string.' in domain 'NewDomain': 941BCEAC
Pokud ale do adresáře v příkladu přidáte následující konfigurační soubor a pak tento příklad spustíte, budou se kódy hash pro stejný řetězec lišit v závislosti na doméně aplikace.
<?xml version ="1.0"?>
<configuration>
<runtime>
<UseRandomizedStringHashAlgorithm enabled="1" />
</runtime>
</configuration>
Když je konfigurační soubor k dispozici, příklad zobrazí 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 jednoznačně. Identické řetězce mají stejné kódy hash, 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 je používat jako klíče v tabulce hash nebo slovníku.
Další informace o použití kódů hash a metody najdete v GetHashCode
tématu Object.GetHashCode.
Poznámky pro volající
Hodnota vrácená nástrojem GetHashCode() je závislá na platformě. Liší se u 32bitové a 64bitové verze rozhraní .NET Framework. Může se také lišit mezi verzemi rozhraní .NET Framework a .NET Core.