Bagikan melalui

String.GetHashCode Metode

  • Referensi

Definisi

Ruang nama:
System
Rakitan:
System.Runtime.dll
Rakitan:
netstandard.dll
Rakitan:
mscorlib.dll

Overload

GetHashCode(ReadOnlySpan<Char>, StringComparison)

Mengembalikan kode hash untuk rentang karakter baca-saja yang disediakan menggunakan aturan yang ditentukan.
GetHashCode(StringComparison)

Mengembalikan kode hash untuk string ini menggunakan aturan yang ditentukan.
GetHashCode(ReadOnlySpan<Char>)

Mengembalikan kode hash untuk rentang karakter baca-saja yang disediakan.
GetHashCode()

Mengembalikan kode hash untuk string ini.

GetHashCode(ReadOnlySpan<Char>, StringComparison)

Sumber:
String.Comparison.cs
Sumber:
String.Comparison.cs
Sumber:
String.Comparison.cs

Mengembalikan kode hash untuk rentang karakter baca-saja yang disediakan menggunakan aturan yang ditentukan.

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

Parameter

value
ReadOnlySpan<Char>

Rentang karakter baca-saja.

comparisonType
StringComparison

Salah satu nilai enumerasi yang menentukan aturan yang akan digunakan dalam perbandingan.

Mengembalikan

Int32

Kode hash bilangan bulat bertanda tangan 32-bit.

Berlaku untuk

GetHashCode(StringComparison)

Sumber:
String.Comparison.cs
Sumber:
String.Comparison.cs
Sumber:
String.Comparison.cs

Mengembalikan kode hash untuk string ini menggunakan aturan yang ditentukan.

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

Parameter

comparisonType
StringComparison

Salah satu nilai enumerasi yang menentukan aturan yang akan digunakan dalam perbandingan.

Mengembalikan

Int32

Kode hash bilangan bulat bertanda tangan 32-bit.

Berlaku untuk

GetHashCode(ReadOnlySpan<Char>)

Sumber:
String.Comparison.cs
Sumber:
String.Comparison.cs
Sumber:
String.Comparison.cs

Mengembalikan kode hash untuk rentang karakter baca-saja yang disediakan.

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

Parameter

value
ReadOnlySpan<Char>

Rentang karakter baca-saja.

Mengembalikan

Int32

Kode hash bilangan bulat bertanda tangan 32-bit.

Berlaku untuk

GetHashCode()

Sumber:
String.Comparison.cs
Sumber:
String.Comparison.cs
Sumber:
String.Comparison.cs

Mengembalikan kode hash untuk string ini.

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

Mengembalikan

Int32

Kode hash bilangan bulat bertanda tangan 32-bit.

Contoh

Contoh berikut menunjukkan GetHashCode metode menggunakan berbagai string input.

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

Keterangan

Perilaku GetHashCode tergantung pada implementasinya, yang mungkin berubah dari satu versi runtime bahasa umum ke versi runtime bahasa umum lainnya. Alasan mengapa hal ini mungkin terjadi adalah untuk meningkatkan performa GetHashCode.

Penting

Jika dua objek string sama, GetHashCode metode mengembalikan nilai yang identik. Namun, tidak ada nilai kode hash unik untuk setiap nilai string unik. String yang berbeda dapat mengembalikan kode hash yang sama.

Kode hash itu sendiri tidak dijamin stabil. Kode hash untuk string identik dapat berbeda di seluruh implementasi .NET, di seluruh versi .NET, dan di seluruh platform .NET (seperti 32-bit dan 64-bit) untuk satu versi .NET. Dalam beberapa kasus, mereka bahkan dapat berbeda dengan domain aplikasi. Ini menyiratkan bahwa dua eksekusi berikutnya dari program yang sama dapat mengembalikan kode hash yang berbeda.

Akibatnya, kode hash tidak boleh digunakan di luar domain aplikasi tempat kode tersebut dibuat, kode tersebut tidak boleh digunakan sebagai bidang kunci dalam koleksi, dan tidak boleh dipertahankan.

Terakhir, jangan gunakan kode hash alih-alih nilai yang dikembalikan oleh fungsi hash kriptografi jika Anda memerlukan hash yang kuat secara kriptografis. Untuk hash kriptografi, gunakan kelas yang berasal dari System.Security.Cryptography.HashAlgorithm kelas atau System.Security.Cryptography.KeyedHashAlgorithm .

Untuk informasi selengkapnya tentang kode hash, lihat Object.GetHashCode.

Dalam aplikasi desktop .NET Framework, Anda dapat menggunakan <elemen UseRandomizedStringHashAlgorithm> untuk menghasilkan kode hash unik berdasarkan domain per aplikasi. Ini dapat mengurangi jumlah tabrakan dan meningkatkan performa keseluruhan penyisipan dan pencarian yang menggunakan tabel hash. Contoh berikut menunjukkan cara menggunakan <elemen UseRandomizedStringHashAlgorithm>. Ini mendefinisikan kelas yang menyertakan konstanta DisplayString string privat, s, yang nilainya adalah "Ini adalah string." Ini juga mencakup ShowStringHashCode metode yang menampilkan nilai string dan kode hashnya bersama dengan nama domain aplikasi tempat metode dijalankan.

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

Saat Anda menjalankan contoh tanpa memberikan file konfigurasi, hal tersebut akan menampilkan output yang mirip dengan berikut ini. Perhatikan bahwa kode hash untuk string identik dengan dua domain aplikasi.

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

Namun, jika Anda menambahkan file konfigurasi berikut ke direktori contoh lalu menjalankan contohnya, kode hash untuk string yang sama akan berbeda berdasarkan domain aplikasi.

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

Ketika file konfigurasi muncul, contoh akan menampilkan output berikut:

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

Penting

Kode hash digunakan untuk menyisipkan dan mengambil objek kunci dari tabel hash secara efisien. Namun, kode hash tidak mengidentifikasi string secara unik. String identik memiliki kode hash yang sama, tetapi runtime bahasa umum juga dapat menetapkan kode hash yang sama ke string yang berbeda. Selain itu, kode hash dapat bervariasi menurut versi .NET, berdasarkan platform dalam satu versi, dan berdasarkan domain aplikasi. Karena itu, Anda tidak boleh membuat serialisasi atau mempertahankan nilai kode hash, anda juga tidak boleh menggunakannya sebagai kunci dalam tabel hash atau kamus.

Untuk informasi tambahan tentang penggunaan kode hash dan GetHashCode metode , lihat Object.GetHashCode.

Catatan Bagi Pemanggil

Nilai yang dikembalikan oleh GetHashCode() bergantung pada platform. Ini berbeda pada versi 32-bit dan 64-bit .NET Framework. Ini juga dapat berbeda antara versi .NET Framework dan .NET Core.

Lihat juga

Berlaku untuk