String.GetHashCode Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Sobrecargas

GetHashCode(ReadOnlySpan<Char>, StringComparison)	Retorna o código hash para o intervalo de caracteres somente leitura fornecido usando as regras especificadas.
GetHashCode(StringComparison)	Retorna o código hash para essa cadeia de caracteres usando as regras especificadas.
GetHashCode(ReadOnlySpan<Char>)	Retorna o código hash para o intervalo de caracteres somente leitura fornecido.
GetHashCode()	Retorna o código hash desta cadeia de caracteres.

GetHashCode(ReadOnlySpan<Char>, StringComparison)

Origem:

String.Comparison.cs

Retorna o código hash para o intervalo de caracteres somente leitura fornecido usando as regras especificadas.

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

Parâmetros

value

ReadOnlySpan<Char>

Um intervalo de caracteres somente leitura.

comparisonType

StringComparison

Um dos valores de enumeração que especifica as regras a serem usadas na comparação.

Retornos

Int32

Um código hash do inteiro com sinal de 32 bits.

GetHashCode(StringComparison)

Origem:

String.Comparison.cs

Retorna o código hash para essa cadeia de caracteres usando as regras especificadas.

public:
 int GetHashCode(StringComparison comparisonType);

public int GetHashCode (StringComparison comparisonType);

override this.GetHashCode : StringComparison -> int

Public Function GetHashCode (comparisonType As StringComparison) As Integer

Parâmetros

comparisonType

StringComparison

Um dos valores de enumeração que especifica as regras a serem usadas na comparação.

Retornos

Int32

Um código hash do inteiro com sinal de 32 bits.

GetHashCode(ReadOnlySpan<Char>)

Origem:

String.Comparison.cs

Retorna o código hash para o intervalo de caracteres somente leitura fornecido.

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

Parâmetros

value

ReadOnlySpan<Char>

Um intervalo de caracteres somente leitura.

Retornos

Int32

Um código hash do inteiro com sinal de 32 bits.

GetHashCode()

Origem:

String.Comparison.cs

Retorna o código hash desta cadeia de caracteres.

public:
 override int GetHashCode();

public override int GetHashCode ();

override this.GetHashCode : unit -> int

Public Overrides Function GetHashCode () As Integer

Retornos

Int32

Um código hash do inteiro com sinal de 32 bits.

Exemplos

O exemplo a seguir demonstra o GetHashCode método usando várias cadeias de caracteres de entrada.

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

Comentários

O comportamento de depende de GetHashCode sua implementação, que pode mudar de uma versão do Common Language Runtime para outra. Um motivo pelo qual isso pode acontecer é melhorar o desempenho de GetHashCode.

Importante

Se dois objetos de cadeia de caracteres forem iguais, o GetHashCode método retornará valores idênticos. No entanto, não há um valor de código hash exclusivo para cada valor de cadeia de caracteres exclusivo. Cadeias de caracteres diferentes podem retornar o mesmo código hash.

Não há garantia de que o código hash em si seja estável. Os códigos de hash para cadeias de caracteres idênticas podem ser diferentes entre implementações do .NET, entre versões do .NET e em plataformas .NET (como 32 bits e 64 bits) para uma única versão do .NET. Em alguns casos, eles podem até ser diferentes pelo domínio do aplicativo. Isso implica que duas execuções subsequentes do mesmo programa podem retornar códigos hash diferentes.

Como resultado, os códigos hash nunca devem ser usados fora do domínio do aplicativo no qual foram criados, nunca devem ser usados como campos de chave em uma coleção e nunca devem ser persistidos.

Por fim, não use o código hash em vez de um valor retornado por uma função de hash criptográfico se você precisar de um hash criptograficamente forte. Para hashes criptográficos, use uma classe derivada da System.Security.Cryptography.HashAlgorithm classe ou System.Security.Cryptography.KeyedHashAlgorithm .

Para obter mais informações sobre códigos hash, consulte Object.GetHashCode.

Em .NET Framework aplicativos da área de trabalho, você pode usar o <elemento UseRandomizedStringHashAlgorithm> para gerar códigos hash exclusivos em uma base de domínio por aplicativo. Isso pode reduzir o número de colisões e melhorar o desempenho geral de inserções e pesquisas que usam tabelas de hash. O exemplo a seguir mostra como usar o <elemento UseRandomizedStringHashAlgorithm>. Ele define uma DisplayString classe que inclui uma constante de cadeia de caracteres privada, s, cujo valor é "This is a string". Ele também inclui um ShowStringHashCode método que exibe o valor da cadeia de caracteres e seu código hash, juntamente com o nome do domínio do aplicativo no qual o método está sendo executado.

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

Quando você executa o exemplo sem fornecer um arquivo de configuração, ele exibe uma saída semelhante à seguinte. Observe que os códigos hash para a cadeia de caracteres são idênticos nos dois domínios de aplicativo.

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

Entretanto, se você adicionar o seguinte arquivo de configuração ao diretório de exemplo e, então, executar o exemplo, os códigos hash da mesma cadeia de caracteres diferirão de acordo com o domínio de aplicativo.

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

Quando o arquivo de configuração estiver presente, o exemplo exibe a saída a seguir:

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

Importante

Os códigos hash são usados para inserir e recuperar objetos com chave de tabelas de hash com eficiência. No entanto, os códigos hash não identificam exclusivamente cadeias de caracteres. Cadeias de caracteres idênticas têm códigos hash iguais, mas o Common Language Runtime também pode atribuir o mesmo código hash a cadeias de caracteres diferentes. Além disso, os códigos hash podem variar de acordo com a versão do .NET, por plataforma em uma única versão e por domínio do aplicativo. Por isso, você não deve serializar nem persistir valores de código hash, nem deve usá-los como chaves em uma tabela ou dicionário de hash.

Para obter informações adicionais sobre o uso de códigos hash e o GetHashCode método , consulte Object.GetHashCode.

Notas aos Chamadores

O valor retornado por GetHashCode() é dependente da plataforma. Ele difere nas versões de 32 bits e 64 bits do .NET Framework. Ele também pode ser diferente entre as versões do .NET Framework e do .NET Core.

Confira também

• GetHashCode()
• <Elemento UseRandomizedStringHashAlgorithm>