String.GetHashCode Metódus

Definíció

Névtér:

System

Szerelvények:

netstandard.dll, System.Runtime.dll

Túlterhelések

Name	Description
GetHashCode(ReadOnlySpan<Char>, StringComparison)	A megadott írásvédett karaktertartomány kivonatkódját adja vissza a megadott szabályok használatával.
GetHashCode(StringComparison)	A megadott szabályokkal adja vissza a sztring kivonatkódját.
GetHashCode()	A sztring kivonatkódját adja vissza.
GetHashCode(ReadOnlySpan<Char>)	A megadott írásvédett karaktertartomány kivonatkódját adja vissza.

GetHashCode(ReadOnlySpan<Char>, StringComparison)

Forrás:

String.Comparison.cs

A megadott írásvédett karaktertartomány kivonatkódját adja vissza a megadott szabályok használatával.

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

Paraméterek

value

ReadOnlySpan<Char>

Írásvédett karaktertartomány.

comparisonType

StringComparison

Az összehasonlításban használandó szabályokat meghatározó számbavételi értékek egyike.

Válaszok

Int32

32 bites aláírt egész számkivonatkód.

GetHashCode(StringComparison)

Forrás:

String.Comparison.cs

A megadott szabályokkal adja vissza a sztring kivonatkódját.

public:
 int GetHashCode(StringComparison comparisonType);

public int GetHashCode(StringComparison comparisonType);

override this.GetHashCode : StringComparison -> int

Public Function GetHashCode (comparisonType As StringComparison) As Integer

Paraméterek

comparisonType

StringComparison

Az összehasonlításban használandó szabályokat meghatározó számbavételi értékek egyike.

Válaszok

Int32

32 bites aláírt egész számkivonatkód.

GetHashCode()

Forrás:

String.Comparison.cs

A sztring kivonatkódját adja vissza.

public:
 override int GetHashCode();

public override int GetHashCode();

override this.GetHashCode : unit -> int

Public Overrides Function GetHashCode () As Integer

Válaszok

Int32

32 bites aláírt egész számkivonatkód.

Példák

Az alábbi példa a különböző bemeneti sztringeket GetHashCode használó metódust mutatja be.

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

Megjegyzések

A viselkedés a GetHashCode megvalósítástól függ, ami a közös nyelvi futtatókörnyezet egyik verziójáról a másikra változhat. Ennek egyik oka az , hogy javítja a teljesítmény .GetHashCode

Important

Ha két sztringobjektum egyenlő, a GetHashCode metódus azonos értékeket ad vissza. Az egyes egyedi sztringértékekhez azonban nincs egyedi kivonatkódérték. A különböző sztringek ugyanazt a kivonatkódot adhatják vissza.

Maga a kivonatkód nem garantáltan stabil. Az azonos sztringek kivonatkódjai különbözőek lehetnek .NET implementációkban, .NET verziókban és .NET platformokon (például 32 bites és 64 bites) az .NET egyetlen verziójában. Bizonyos esetekben alkalmazástartományonként is eltérhetnek. Ez azt jelenti, hogy ugyanazon program két későbbi futtatása eltérő kivonatkódokat adhat vissza.

Ennek eredményeképpen a kivonatkódokat soha nem szabad azon az alkalmazástartományon kívül használni, amelyben létrehozták őket, soha nem szabad kulcsmezőként használni őket egy gyűjteményben, és soha nem szabad őket megőrizni.

Végül ne használja a kivonatkódot a titkosítási kivonatoló függvény által visszaadott érték helyett, ha kriptográfiailag erős kivonatra van szüksége. Titkosítási kivonatok esetén használjon egy osztályt, amely a System.Security.Cryptography.HashAlgorithm vagy a System.Security.Cryptography.KeyedHashAlgorithm osztályból származik.

A kivonatkódokkal kapcsolatos további információkért lásd: Object.GetHashCode.

A .NET-keretrendszer asztali alkalmazásaiban a <UseRandomizedStringHashAlgorithm> elem használatával alkalmazásonkénti tartományonként hozhat létre egyedi kivonatkódokat. Ez csökkentheti az ütközések számát, és javíthatja a kivonattáblákat használó beszúrások és keresések általános teljesítményét. Az alábbi példa a <UseRandomizedStringHashAlgorithm> elem használatát mutatja be. Egy privát sztringállandót DisplayString tartalmazó osztályt definiál, samelynek értéke "Ez egy sztring". Tartalmaz egy metódust ShowStringHashCode is, amely megjeleníti a sztring értékét és kivonatkódját, valamint annak az alkalmazástartománynak a nevét, amelyben a metódust végrehajtja.

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

Ha konfigurációs fájl nélkül futtatja a példát, az a következőhöz hasonló kimenetet jelenít meg. Vegye figyelembe, hogy a sztring kivonatkódjai megegyeznek a két alkalmazástartományban.

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

Ha azonban hozzáadja a következő konfigurációs fájlt a példa könyvtárához, majd futtatja a példát, az ugyanahhoz a sztringhez tartozó kivonatkódok alkalmazástartományonként eltérőek lesznek.

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

Ha a konfigurációs fájl jelen van, a példa a következő kimenetet jeleníti meg:

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

Important

A kivonatkódokkal hatékonyan szúrhat be és kérdezhet le kulcsos objektumokat a kivonattáblákból. A kivonatkódok azonban nem azonosítják egyedileg a sztringeket. Az azonos sztringek azonos kivonatkódokkal rendelkeznek, de a közös nyelvi futtatókörnyezet ugyanazt a kivonatkódot is hozzárendelheti a különböző sztringekhez. Emellett a kivonatkódok az .NET verziója, az egyetlen verzión belüli platform és az alkalmazástartomány szerint is változhatnak. Emiatt nem szabad szerializálnia vagy megőriznie a kivonatkód értékeit, és nem szabad kulcsként használnia őket egy kivonattáblában vagy szótárban.

A kivonatkódok és a GetHashCode metódus használatával kapcsolatos további információkért lásd: Object.GetHashCode.

Megjegyzések a hívókhoz

A visszaadott GetHashCode() érték platformfüggő. A .NET Framework 32 bites és 64 bites verzióiban különbözik. A .NET Framework és a .NET Core verziói között is eltérhet.

Lásd még

• GetHashCode()
• <UseRandomizedStringHashAlgorithm> elem

GetHashCode(ReadOnlySpan<Char>)

Forrás:

String.Comparison.cs

A megadott írásvédett karaktertartomány kivonatkódját adja vissza.

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

Paraméterek

value

ReadOnlySpan<Char>

Írásvédett karaktertartomány.

Válaszok

Int32

32 bites aláírt egész számkivonatkód.