String.GetHashCode Método

Definição

Espaço de Nomes:
System
Assemblagens:
netstandard.dll, System.Runtime.dll
Assemblagem:
System.Runtime.dll
Assemblagem:
netstandard.dll
Assemblagens:
mscorlib.dll, System.Runtime.dll
Assemblagem:
mscorlib.dll

Sobrecargas

Name Description
GetHashCode(ReadOnlySpan<Char>, StringComparison)

Devolve o código hash para o espaço de caracteres de apenas leitura fornecido usando as regras especificadas.
GetHashCode(StringComparison)

Devolve o código de hash desta cadeia usando as regras especificadas.
GetHashCode()

Devolve o código de hash desta cadeia.
GetHashCode(ReadOnlySpan<Char>)

Devolve o código de hash para o intervalo de caracteres apenas de leitura fornecido.

GetHashCode(ReadOnlySpan<Char>, StringComparison)

Origem:
String.Comparison.cs
Origem:
String.Comparison.cs
Origem:
String.Comparison.cs
Origem:
String.Comparison.cs
Origem:
String.Comparison.cs

Devolve o código hash para o espaço de caracteres de apenas 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>

Uma extensão de caracteres apenas de leitura.

comparisonType
StringComparison

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

Devoluções

Int32

Um código hash inteiro assinado de 32 bits.

Aplica-se a

GetHashCode(StringComparison)

Origem:
String.Comparison.cs
Origem:
String.Comparison.cs
Origem:
String.Comparison.cs
Origem:
String.Comparison.cs
Origem:
String.Comparison.cs

Devolve o código de hash desta cadeia 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 usar na comparação.

Devoluções

Int32

Um código hash inteiro assinado de 32 bits.

Aplica-se a

GetHashCode()

Origem:
String.Comparison.cs
Origem:
String.Comparison.cs
Origem:
String.Comparison.cs
Origem:
String.Comparison.cs
Origem:
String.Comparison.cs

Devolve o código de hash desta cadeia.

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

Devoluções

Int32

Um código hash inteiro assinado de 32 bits.

Exemplos

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

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

Observações

O comportamento de GetHashCode depende da sua implementação, que pode mudar de uma versão do runtime da linguagem comum para outra. Uma razão para isto acontecer é melhorar o desempenho de GetHashCode.

Importante

Se dois objetos string forem iguais, o GetHashCode método devolve valores idênticos. No entanto, não existe um valor único de código hash para cada valor único de string. Diferentes strings podem devolver o mesmo código de hash.

O próprio código de hash não garante que seja estável. Os códigos de hash para strings idênticas podem diferir entre implementações .NET, entre versões .NET e entre plataformas .NET (como 32 e 64 bits) para uma única versão de .NET. Em alguns casos, podem até diferir consoante o domínio da aplicação. Isto implica que duas execuções subsequentes do mesmo programa podem devolver códigos hash diferentes.

Como resultado, os códigos hash nunca devem ser usados fora do domínio da aplicação em que foram criados, nunca devem ser usados como campos-chave numa coleção e nunca devem ser persistidos.

Por fim, não use o código de hash em vez de um valor devolvido por uma função de hash criptográfica se 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 mais informações sobre códigos hash, veja Object.GetHashCode.

Nas aplicações de ambiente de trabalho .NET Framework, pode usar o elemento <UseRandomizedStringHashAlgorithm> para gerar códigos hash únicos por domínio de aplicação. Isto pode reduzir o número de colisões e melhorar o desempenho global das inserções e consultas que utilizam tabelas hash. O exemplo seguinte mostra como usar o <elemento UseRandomizedStringHashAlgorithm>. Define uma DisplayString classe que inclui uma constante de cadeia privada, s, cujo valor é "Isto é uma cadeia." Inclui também um ShowStringHashCode método que apresenta o valor da cadeia e o seu código de hash, juntamente com o nome do domínio de aplicação onde o método está a ser 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 executa o exemplo sem fornecer um ficheiro de configuração, ele apresenta uma saída semelhante à seguinte. Note-se que os códigos de hash da cadeia são idênticos nos dois domínios de aplicação.

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

No entanto, se adicionar o ficheiro de configuração seguinte ao diretório do exemplo e depois executar o exemplo, os códigos de hash para a mesma cadeia variarão consoante o domínio da aplicação.

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

Quando o ficheiro de configuração está presente, o exemplo apresenta a seguinte saída:

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

Importante

Os códigos de hash são usados para inserir e recuperar objetos com chave de tabelas de hash de forma eficiente. No entanto, os códigos hash não identificam de forma única as cadeias de caracteres. Strings idênticas têm códigos hash iguais, mas o runtime da linguagem comum também pode atribuir o mesmo código hash a cadeias diferentes. Além disso, os códigos de hash podem variar consoante a versão do .NET, a plataforma dentro de uma única versão e o domínio da aplicação. Por isso, não deve serializar nem persistir valores de código hash, nem usá-los como chaves numa tabela hash ou dicionário.

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

Notas para Chamadores

O valor devolvido por GetHashCode() depende da plataforma. Difere nas versões de 32 e 64 bits do .NET Framework. Também pode diferir entre versões do .NET Framework e do .NET Core.

Ver também

Aplica-se a

GetHashCode(ReadOnlySpan<Char>)

Origem:
String.Comparison.cs
Origem:
String.Comparison.cs
Origem:
String.Comparison.cs
Origem:
String.Comparison.cs
Origem:
String.Comparison.cs

Devolve o código de hash para o intervalo de caracteres apenas de 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>

Uma extensão de caracteres apenas de leitura.

Devoluções

Int32

Um código hash inteiro assinado de 32 bits.

Aplica-se a