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

Definicja

Przeciążenia

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

Zwraca kod skrótu dla podanego zakresu znaków tylko do odczytu przy użyciu określonych reguł.Returns the hash code for the provided read-only character span using the specified rules.

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

Zwraca kod skrótu dla tego ciągu przy użyciu określonych reguł.Returns the hash code for this string using the specified rules.

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

Zwraca kod skrótu dla tego ciągu.Returns the hash code for this string.

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

Zwraca kod skrótu dla podanego zakresu znaków tylko do odczytu.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)

Zwraca kod skrótu dla podanego zakresu znaków tylko do odczytu przy użyciu określonych reguł.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

Parametry

value
ReadOnlySpan<Char>

Zakres znaków tylko do odczytu.A read-only character span.

comparisonType
StringComparison StringComparison StringComparison StringComparison

Jedna z wartości wyliczenia, która określa reguły do użycia w porównaniu.One of the enumeration values that specifies the rules to use in the comparison.

Zwraca

Kod skrótu 32-bitowej liczby całkowitej ze znakiem.A 32-bit signed integer hash code.

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

Zwraca kod skrótu dla tego ciągu przy użyciu określonych reguł.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

Parametry

comparisonType
StringComparison StringComparison StringComparison StringComparison

Jedna z wartości wyliczenia, która określa reguły do użycia w porównaniu.One of the enumeration values that specifies the rules to use in the comparison.

Zwraca

Kod skrótu 32-bitowej liczby całkowitej ze znakiem.A 32-bit signed integer hash code.

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

Zwraca kod skrótu dla tego ciągu.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

Zwraca

Kod skrótu 32-bitowej liczby całkowitej ze znakiem.A 32-bit signed integer hash code.

Przykłady

Poniższy przykład demonstruje GetHashCode metodę przy użyciu różnych ciągów wejściowych.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

Uwagi

Zachowanie GetHashCode jest zależne od implementacji, która może ulec zmianie z jednej wersji środowiska uruchomieniowego języka wspólnego na inną.The behavior of GetHashCode is dependent on its implementation, which might change from one version of the common language runtime to another. Przyczyną tego problemu może być poprawa wydajności programu GetHashCode.A reason why this might happen is to improve the performance of GetHashCode.

Ważne

Jeśli dwa obiekty String są równe, GetHashCode Metoda zwraca identyczne wartości.If two string objects are equal, the GetHashCode method returns identical values. Nie istnieje jednak unikatowa wartość kodu skrótu dla każdej unikatowej wartości ciągu.However, there is not a unique hash code value for each unique string value. Różne ciągi mogą zwracać ten sam kod skrótu.Different strings can return the same hash code.

Sam kod skrótu nie jest gwarantowany jako stabilny.The hash code itself is not guaranteed to be stable. Kody skrótów dla identycznych ciągów mogą różnić się między implementacjami platformy .NET, różnymi wersjami .NET i między platformami .NET (takimi jak 32-bitowe i 64-bitowe) dla jednej wersji platformy .NET.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. W niektórych przypadkach mogą one nawet różnić się w zależności od domeny aplikacji.In some cases, they can even differ by application domain. Oznacza to, że dwa kolejne uruchomienia tego samego programu mogą zwracać różne kody skrótów.This implies that two subsequent runs of the same program may return different hash codes.

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.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.

Na koniec nie należy używać kodu skrótu zamiast wartości zwracanej przez kryptograficzną funkcję mieszania, jeśli jest potrzebny kryptograficznie silny skrót.Finally, don't use the hash code instead of a value returned by a cryptographic hashing function if you need a cryptographically strong hash. W przypadku skrótów kryptograficznych Użyj klasy pochodnej System.Security.Cryptography.HashAlgorithm klasy or. System.Security.Cryptography.KeyedHashAlgorithmFor cryptographic hashes, use a class derived from the System.Security.Cryptography.HashAlgorithm or System.Security.Cryptography.KeyedHashAlgorithm class.

Aby uzyskać więcej informacji na temat kodów skrótu Object.GetHashCode, zobacz.For more information about hash codes, see Object.GetHashCode.

W aplikacjach klasycznych można użyć <elementu UseRandomizedStringHashAlgorithm > , aby generować unikatowe kody skrótów dla poszczególnych domen aplikacji.In desktop apps, you can use the <UseRandomizedStringHashAlgorithm> element to generate unique hash codes on a per application domain basis. Może to zmniejszyć liczbę kolizji i zwiększyć ogólną wydajność operacji wstawiania i wyszukiwania, które używają tabel skrótów.This can reduce the number of collisions and improve the overall performance of insertions and lookups that use hash tables. Poniższy przykład pokazuje, <jak używać elementu UseRandomizedStringHashAlgorithm >.The following example shows how to use the <UseRandomizedStringHashAlgorithm> element. Definiuje DisplayString klasę, która zawiera ciąg prywatny, s, którego wartością jest "to jest ciąg".It defines a DisplayString class that includes a private string constant, s, whose value is "This is a string." Zawiera ShowStringHashCode również metodę, która wyświetla wartość ciągu i jego kod skrótu wraz z nazwą domeny aplikacji, w której jest wykonywana metoda.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

W przypadku uruchomienia tego przykładu bez podawania pliku konfiguracji wyświetlane są dane wyjściowe podobne do poniższych.When you run the example without supplying a configuration file, it displays output similar to the following. Należy zauważyć, że kody skrótów dla ciągu są identyczne w obu domenach aplikacji.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

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 różnią się w zależności od domeny aplikacji.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>

Gdy plik konfiguracji jest obecny, w przykładzie są wyświetlane następujące dane wyjściowe: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

Ważne

Kody skrótów służą do wydajnego wstawiania i pobierania z tabel skrótów.Hash codes are used to insert and retrieve keyed objects from hash tables efficiently. Jednak kody skrótów nie identyfikują jednoznacznie ciągów.However, hash codes don't uniquely identify strings. 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.Identical strings have equal hash codes, but the common language runtime can also assign the same hash code to different strings. Ponadto kody skrótów mogą różnić się w zależności od wersji platformy .NET, platformy w ramach jednej wersji i domeny aplikacji.In addition, hash codes can vary by version of .NET, by platform within a single version, and by application domain. W związku z tym nie należy serializować ani utrwalać wartości kodu skrótu ani używać ich jako kluczy w tabeli lub słowniku skrótów.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.

Aby uzyskać dodatkowe informacje o używaniu kodów skrótów i GetHashCode metody, zobacz. Object.GetHashCodeFor additional information about the use of hash codes and the GetHashCode method, see Object.GetHashCode.

Uwagi dotyczące wywoływania

Wartość zwrócona przez GetHashCode() jest zależna od platformy.The value returned by GetHashCode() is platform-dependent. Różni się on od 32-bitowych i 64-bitowych wersji .NET Framework.It differs on the 32-bit and 64-bit versions of the .NET Framework. Może również różnić się między wersjami .NET Framework i .NET Core.It also can differ between versions of the .NET Framework and .NET Core.

Zobacz też

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

Zwraca kod skrótu dla podanego zakresu znaków tylko do odczytu.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

Parametry

value
ReadOnlySpan<Char>

Zakres znaków tylko do odczytu.A read-only character span.

Zwraca

Kod skrótu 32-bitowej liczby całkowitej ze znakiem.A 32-bit signed integer hash code.

Dotyczy