String.GetHashCode Metoda

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Przeciążenia

GetHashCode(ReadOnlySpan<Char>, StringComparison)	Zwraca kod skrótu dla podanego zakresu znaków tylko do odczytu przy użyciu określonych reguł.
GetHashCode(StringComparison)	Zwraca kod skrótu dla tego ciągu przy użyciu określonych reguł.
GetHashCode(ReadOnlySpan<Char>)	Zwraca kod skrótu dla podanego zakresu znaków tylko do odczytu.
GetHashCode()	Zwraca kod skrótu dla tego ciągu.

GetHashCode(ReadOnlySpan<Char>, StringComparison)

Źródło:

String.Comparison.cs

Zwraca kod skrótu dla podanego zakresu znaków tylko do odczytu przy użyciu określonych reguł.

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>

Zakres znaków tylko do odczytu.

comparisonType

StringComparison

Jedna z wartości wyliczenia, która określa reguły do użycia w porównaniu.

Zwraca

Int32

Kod skrótu 32-bitowej liczby całkowitej ze znakiem.

GetHashCode(StringComparison)

Źródło:

String.Comparison.cs

Zwraca kod skrótu dla tego ciągu przy użyciu określonych reguł.

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 wartości wyliczenia, która określa reguły do użycia w porównaniu.

Zwraca

Int32

Kod skrótu 32-bitowej liczby całkowitej ze znakiem.

GetHashCode(ReadOnlySpan<Char>)

Źródło:

String.Comparison.cs

Zwraca kod skrótu dla podanego zakresu znaków tylko do odczytu.

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>

Zakres znaków tylko do odczytu.

Zwraca

Int32

Kod skrótu 32-bitowej liczby całkowitej ze znakiem.

GetHashCode()

Źródło:

String.Comparison.cs

Zwraca kod skrótu dla tego ciągu.

public:
 override int GetHashCode();

public override int GetHashCode ();

override this.GetHashCode : unit -> int

Public Overrides Function GetHashCode () As Integer

Zwraca

Int32

Kod skrótu 32-bitowej liczby całkowitej ze znakiem.

Przykłady

W poniższym przykładzie pokazano metodę GetHashCode przy użyciu różnych ciągów wejściowych.

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

Uwagi

Zachowanie jest GetHashCode zależne od implementacji, która może ulec zmianie z jednej wersji środowiska uruchomieniowego języka wspólnego na inną. Powodem, dla którego może się to zdarzyć, jest zwiększenie wydajności programu GetHashCode.

Ważne

Jeśli dwa obiekty ciągów są równe, GetHashCode metoda zwraca identyczne wartości. Nie ma jednak unikatowej wartości kodu skrótu dla każdej unikatowej wartości ciągu. Różne ciągi mogą zwracać ten sam kod skrótu.

Sam kod skrótu nie jest gwarantowany jako stabilny. Kody skrótów dla identycznych ciągów mogą różnić się między implementacjami platformy .NET, wersjami platformy .NET i platformami .NET (takimi jak 32-bitowe i 64-bitowe) dla pojedynczej wersji platformy .NET. W niektórych przypadkach mogą nawet różnić się od domeny aplikacji. Oznacza to, że dwa kolejne uruchomienia tego samego programu mogą zwracać różne kody skrótów.

W związku z tym kody skrótów nigdy nie powinny być używane poza domeną aplikacji, w której zostały utworzone, nigdy nie powinny być używane jako pola kluczy w kolekcji i nigdy nie powinny być utrwalane.

Na koniec nie używaj kodu skrótu zamiast wartości zwracanej przez funkcję skrótu kryptograficznego, jeśli potrzebujesz kryptograficznie silnego skrótu. W przypadku skrótów kryptograficznych użyj klasy pochodnej System.Security.Cryptography.HashAlgorithm z klasy lub System.Security.Cryptography.KeyedHashAlgorithm .

Aby uzyskać więcej informacji na temat kodów skrótów, zobacz Object.GetHashCode.

W .NET Framework aplikacjach klasycznych można użyć elementu< UseRandomizedStringHashAlgorithm> w celu wygenerowania unikatowych kodów skrótów na podstawie domeny aplikacji. Może to zmniejszyć liczbę kolizji i poprawić ogólną wydajność wstawiania i odnośników korzystających z tabel skrótów. W poniższym przykładzie pokazano, jak użyć elementu< UseRandomizedStringHashAlgorithm>. Definiuje klasę zawierającą stałą DisplayString ciągu prywatnego, sktórej wartość to "To jest ciąg". Zawiera również metodę ShowStringHashCode , która wyświetla wartość ciągu i jego kod skrótu wraz z nazwą domeny aplikacji, w której jest wykonywane metoda.

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

Po uruchomieniu przykładu bez podawania pliku konfiguracji zostaną wyświetlone dane wyjściowe podobne do poniższych. Należy pamiętać, że kody skrótów dla ciągu są identyczne w dwóch domenach aplikacji.

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

Jeśli jednak dodasz następujący plik konfiguracji do katalogu przykładu, a następnie uruchomisz przykład, kody skrótów dla tego samego ciągu będą różnić się od domeny aplikacji.

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

Gdy plik konfiguracji jest obecny, w przykładzie zostaną wyświetlone następujące dane wyjściowe:

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

Ważne

Kody skrótów są używane do wydajnego wstawiania i pobierania obiektów kluczy z tabel skrótów. Jednak kody skrótów nie identyfikują unikatowych ciągów. Identyczne ciągi mają równe kody skrótów, ale środowisko uruchomieniowe języka wspólnego może również przypisać ten sam kod skrótu do różnych ciągów. Ponadto kody skrótów mogą różnić się w zależności od wersji platformy .NET w ramach jednej wersji i domeny aplikacji. W związku z tym nie należy serializować ani utrwalać wartości kodu skrótu ani używać ich jako kluczy w tabeli skrótu lub słowniku.

Aby uzyskać dodatkowe informacje na temat używania kodów skrótów i GetHashCode metody, zobacz Object.GetHashCode.

Uwagi dotyczące wywoływania

Wartość zwracana przez GetHashCode() wartość jest zależna od platformy. Różni się on w 32-bitowych i 64-bitowych wersjach .NET Framework. Może również różnić się między wersjami .NET Framework i .NET Core.

Zobacz też

• GetHashCode()
• <UseRandomizedStringHashAlgorithm> , element