String.GetHashCode Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

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

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

C#

public static int GetHashCode (ReadOnlySpan<char> value, StringComparison comparisonType);

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

Int32

32-bit imzalı tamsayı karma kodu.

GetHashCode(StringComparison)

Kaynak:

String.Comparison.cs

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

C#

public int GetHashCode (StringComparison comparisonType);

Parametreler

comparisonType

StringComparison

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

Döndürülenler

Int32

32-bit imzalı tamsayı karma kodu.

GetHashCode(ReadOnlySpan<Char>)

Kaynak:

String.Comparison.cs

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

C#

public static int GetHashCode (ReadOnlySpan<char> value);

Parametreler

value

ReadOnlySpan<Char>

Salt okunur karakter aralığı.

Döndürülenler

Int32

32-bit imzalı tamsayı karma kodu.

GetHashCode()

Kaynak:

String.Comparison.cs

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

C#

public override int GetHashCode ();

Döndürülenler

Int32

32-bit imzalı tamsayı karma kodu.

Örnekler

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

C#

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
*/

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.

C#

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());
   }
}

Ö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

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

• GetHashCode()
• <UseRandomizedStringHashAlgorithm> Öğesi