String.GetHashCode Yöntem

Tanım

Aşırı Yüklemeler

GetHashCode(ReadOnlySpan<Char>, StringComparison)

Belirtilen kuralları kullanarak sağlanan salt okunur karakter aralığı için karma kodu döndürür.

GetHashCode(StringComparison)

Belirtilen kuralları kullanarak bu dizenin karma kodunu döndürür.

GetHashCode(ReadOnlySpan<Char>)

Sağlanan salt okunur karakter aralığı için karma kodu döndürür.

GetHashCode()

Bu dizenin karma kodunu döndürür.

GetHashCode(ReadOnlySpan<Char>, StringComparison)

Kaynak:
String.Comparison.cs
Kaynak:
String.Comparison.cs
Kaynak:
String.Comparison.cs

Belirtilen kuralları kullanarak sağlanan salt okunur karakter aralığı için karma kodu döndürür.

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

Parametreler

value
ReadOnlySpan<Char>

Salt okunur karakter aralığı.

comparisonType
StringComparison

Karşılaştırmada kullanılacak kuralları belirten numaralandırma değerlerinden biri.

Döndürülenler

32-bit imzalı tamsayı karma kodu.

Şunlara uygulanır

GetHashCode(StringComparison)

Kaynak:
String.Comparison.cs
Kaynak:
String.Comparison.cs
Kaynak:
String.Comparison.cs

Belirtilen kuralları kullanarak bu dizenin karma kodunu döndürür.

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

Parametreler

comparisonType
StringComparison

Karşılaştırmada kullanılacak kuralları belirten numaralandırma değerlerinden biri.

Döndürülenler

32-bit imzalı tamsayı karma kodu.

Şunlara uygulanır

GetHashCode(ReadOnlySpan<Char>)

Kaynak:
String.Comparison.cs
Kaynak:
String.Comparison.cs
Kaynak:
String.Comparison.cs

Sağlanan salt okunur karakter aralığı için karma kodu döndürür.

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

Parametreler

value
ReadOnlySpan<Char>

Salt okunur karakter aralığı.

Döndürülenler

32-bit imzalı tamsayı karma kodu.

Şunlara uygulanır

GetHashCode()

Kaynak:
String.Comparison.cs
Kaynak:
String.Comparison.cs
Kaynak:
String.Comparison.cs

Bu dizenin karma kodunu döndürür.

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

Döndürülenler

32-bit imzalı tamsayı karma kodu.

Örnekler

Aşağıdaki örnekte, çeşitli giriş dizelerinin GetHashCode kullanıldığı yöntem gösterilmektedir.

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

Açıklamalar

davranışı GetHashCode , ortak dil çalışma zamanının bir sürümünden diğerine değişebilen uygulamasına bağlıdır. Bunun olmasının bir nedeni, performansını GetHashCodegeliştirmektir.

Önemli

İki dize nesnesi eşitse, GetHashCode yöntemi aynı değerleri döndürür. Ancak, her benzersiz dize değeri için benzersiz bir karma kod değeri yoktur. Farklı dizeler aynı karma kodu döndürebilir.

Karma kodun kararlı olması garanti edilmez. Aynı dizeler için karma kodları .NET uygulamaları arasında, .NET sürümleri arasında ve .NET platformlarında (32 bit ve 64 bit gibi) tek bir .NET sürümü için farklılık gösterebilir. Bazı durumlarda, uygulama etki alanına göre bile farklılık gösterebilirler. Bu, aynı programın sonraki iki çalıştırmasının farklı karma kodları döndürebileceği anlamına gelir.

Sonuç olarak, karma kodları hiçbir zaman oluşturuldukları uygulama etki alanının dışında kullanılmamalıdır, hiçbir zaman bir koleksiyonda anahtar alanları olarak kullanılmamalıdır ve hiçbir zaman kalıcı olmamalıdır.

Son olarak, şifreleme açısından güçlü bir karmaya ihtiyacınız varsa şifreleme karma işlevi tarafından döndürülen bir değer yerine karma kodunu kullanmayın. Şifreleme karmaları için veya System.Security.Cryptography.KeyedHashAlgorithm sınıfından System.Security.Cryptography.HashAlgorithm türetilmiş bir sınıf kullanın.

Karma kodlar hakkında daha fazla bilgi için bkz Object.GetHashCode. .

.NET Framework masaüstü uygulamalarında UseRandomizedStringHashAlgorithm> öğesini kullanarak< uygulama başına etki alanı temelinde benzersiz karma kodları oluşturabilirsiniz. Bu, çakışma sayısını azaltabilir ve karma tabloları kullanan eklemelerin ve aramaların genel performansını artırabilir. Aşağıdaki örnekte UseRandomizedStringHashAlgorithm> öğesinin nasıl kullanılacağı< gösterilmektedir. Değeri "Bu bir DisplayString dizedir" olan özel dize sabiti siçeren bir sınıf tanımlar. Ayrıca, dize değerini ve karma kodunu, yöntemin yürütülmekte olduğu uygulama etki alanının adıyla birlikte görüntüleyen bir ShowStringHashCode yöntemi de içerir.

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

Örneği bir yapılandırma dosyası sağlamadan çalıştırdığınızda, aşağıdakine benzer bir çıktı görüntüler. Dizenin karma kodlarının iki uygulama etki alanında aynı olduğunu unutmayın.

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

Ancak, aşağıdaki yapılandırma dosyasını örneğin dizinine ekleyip örneği çalıştırırsanız, aynı dizenin karma kodları uygulama etki alanına göre farklılık gösterir.

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

Yapılandırma dosyası mevcut olduğunda örnekte aşağıdaki çıkış görüntülenir:

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

Önemli

Karma kodları, karma tablolardan anahtarlı nesneleri verimli bir şekilde eklemek ve almak için kullanılır. Ancak karma kodlar dizeleri benzersiz olarak tanımlamaz. Aynı dizeler eşit karma kodlara sahiptir, ancak ortak dil çalışma zamanı aynı karma kodu farklı dizelere de atayabilir. Buna ek olarak, karma kodları .NET sürümüne göre, platforma göre tek bir sürümde ve uygulama etki alanına göre farklılık gösterebilir. Bu nedenle, karma kod değerlerini serileştirmemeli veya kalıcı hale getirmemelisiniz ya da bunları karma tablo veya sözlükte anahtar olarak kullanmamalısınız.

Karma kodların ve GetHashCode yönteminin kullanımı hakkında ek bilgi için bkz Object.GetHashCode. .

Arayanlara Notlar

tarafından GetHashCode() döndürülen değer platforma bağımlıdır. .NET Framework 32 bit ve 64 bit sürümlerinde farklılık gösterir. Ayrıca .NET Framework ve .NET Core sürümleri arasında da farklılık gösterebilir.

Ayrıca bkz.

Şunlara uygulanır