String.GetHashCode String.GetHashCode String.GetHashCode String.GetHashCode Method

Definición

Sobrecargas

GetHashCode(ReadOnlySpan<Char>, StringComparison) GetHashCode(ReadOnlySpan<Char>, StringComparison) GetHashCode(ReadOnlySpan<Char>, StringComparison) GetHashCode(ReadOnlySpan<Char>, StringComparison)

Devuelve el código hash del intervalo de caracteres de solo lectura proporcionado mediante las reglas especificadas.Returns the hash code for the provided read-only character span using the specified rules.

GetHashCode(StringComparison) GetHashCode(StringComparison) GetHashCode(StringComparison) GetHashCode(StringComparison)

Devuelve el código hash de esta cadena mediante las reglas especificadas.Returns the hash code for this string using the specified rules.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Devuelve el código hash para esta cadena.Returns the hash code for this string.

GetHashCode(ReadOnlySpan<Char>) GetHashCode(ReadOnlySpan<Char>) GetHashCode(ReadOnlySpan<Char>) GetHashCode(ReadOnlySpan<Char>)

Devuelve el código hash del intervalo de caracteres de solo lectura proporcionado.Returns the hash code for the provided read-only character span.

GetHashCode(ReadOnlySpan<Char>, StringComparison) GetHashCode(ReadOnlySpan<Char>, StringComparison) GetHashCode(ReadOnlySpan<Char>, StringComparison) GetHashCode(ReadOnlySpan<Char>, StringComparison)

Devuelve el código hash del intervalo de caracteres de solo lectura proporcionado mediante las reglas especificadas.Returns the hash code for the provided read-only character span using the specified rules.

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>

Intervalo de caracteres de solo lectura.A read-only character span.

comparisonType
StringComparison StringComparison StringComparison StringComparison

Uno de los valores de enumeración que especifica las reglas que se van a usar en la comparación.One of the enumeration values that specifies the rules to use in the comparison.

Devoluciones

Código hash de un entero de 32 bits con signo.A 32-bit signed integer hash code.

GetHashCode(StringComparison) GetHashCode(StringComparison) GetHashCode(StringComparison) GetHashCode(StringComparison)

Devuelve el código hash de esta cadena mediante las reglas especificadas.Returns the hash code for this string using the specified rules.

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 StringComparison StringComparison StringComparison

Uno de los valores de enumeración que especifica las reglas que se van a usar en la comparación.One of the enumeration values that specifies the rules to use in the comparison.

Devoluciones

Código hash de un entero de 32 bits con signo.A 32-bit signed integer hash code.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Devuelve el código hash para esta cadena.Returns the hash code for this string.

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

Devoluciones

Código hash de un entero de 32 bits con signo.A 32-bit signed integer hash code.

Ejemplos

En el ejemplo siguiente se GetHashCode muestra el método con varias cadenas de entrada.The following example demonstrates the GetHashCode method using various input strings.

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

Comentarios

El comportamiento de GetHashCode depende de su implementación, que podría cambiar de una versión de la Common Language Runtime a otra.The behavior of GetHashCode is dependent on its implementation, which might change from one version of the common language runtime to another. Una razón por la que esto puede ocurrir es mejorar el rendimiento GetHashCodede.A reason why this might happen is to improve the performance of GetHashCode.

Importante

Si dos objetos de cadena son iguales, GetHashCode el método devuelve valores idénticos.If two string objects are equal, the GetHashCode method returns identical values. Sin embargo, no hay ningún valor de código hash único para cada valor de cadena único.However, there is not a unique hash code value for each unique string value. Cadenas diferentes pueden devolver el mismo código hash.Different strings can return the same hash code.

No se garantiza que el propio código hash sea estable.The hash code itself is not guaranteed to be stable. Los códigos hash para cadenas idénticas pueden diferir en las implementaciones de .NET, en las versiones de .NET y en las plataformas .NET (como 32 bits y 64 bits) para una única versión de .NET.Hash codes for identical strings can differ across .NET implementations, across .NET versions, and across .NET platforms (such as 32-bit and 64-bit) for a single version of .NET. En algunos casos, incluso pueden variar según el dominio de aplicación.In some cases, they can even differ by application domain. Esto implica que dos ejecuciones posteriores del mismo programa pueden devolver códigos hash diferentes.This implies that two subsequent runs of the same program may return different hash codes.

Como resultado, los códigos hash nunca deben usarse fuera del dominio de aplicación en el que se crearon, nunca deben usarse como campos de clave en una colección y nunca deben persistir.As a result, hash codes should never be used outside of the application domain in which they were created, they should never be used as key fields in a collection, and they should never be persisted.

Por último, no use el código hash en lugar de un valor devuelto por una función de hash criptográfica si necesita un hash criptográficamente seguro.Finally, don't use the hash code instead of a value returned by a cryptographic hashing function if you need a cryptographically strong hash. En el caso de los hashes criptográficos, utilice una System.Security.Cryptography.HashAlgorithm clase System.Security.Cryptography.KeyedHashAlgorithm derivada de la clase o.For cryptographic hashes, use a class derived from the System.Security.Cryptography.HashAlgorithm or System.Security.Cryptography.KeyedHashAlgorithm class.

Para obtener más información acerca de los códigos Object.GetHashCodehash, vea.For more information about hash codes, see Object.GetHashCode.

En aplicaciones de escritorio, puede usar el <elemento > de UseRandomizedStringHashAlgorithm para generar códigos hash únicos en cada dominio de aplicación.In desktop apps, you can use the <UseRandomizedStringHashAlgorithm> element to generate unique hash codes on a per application domain basis. Esto puede reducir el número de colisiones y mejorar el rendimiento general de las inserciones y las búsquedas que usan las tablas hash.This can reduce the number of collisions and improve the overall performance of insertions and lookups that use hash tables. En el ejemplo siguiente se muestra cómo usar el <elemento > de UseRandomizedStringHashAlgorithm.The following example shows how to use the <UseRandomizedStringHashAlgorithm> element. Define una DisplayString clase que incluye una constante de cadena privada, s, cuyo valor es "This is a String".It defines a DisplayString class that includes a private string constant, s, whose value is "This is a string." También incluye un método ShowStringHashCode que presenta el valor de cadena y su código hash junto con el nombre del dominio de aplicación en el que se ejecuta el método.It also includes a ShowStringHashCode method that displays the string value and its hash code along with the name of the application domain in which the method is executing.

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

Cuando ejecute el ejemplo sin proporcionar un archivo de configuración, mostrará un resultado similar al siguiente.When you run the example without supplying a configuration file, it displays output similar to the following. Observe que los códigos hash de la cadena son idénticos en los dos dominios de aplicación.Note that the hash codes for the string are identical in the two application domains.

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

Sin embargo, si agrega el archivo de configuración siguiente al directorio de ejemplo y, a continuación, ejecuta el ejemplo, los códigos hash para la misma cadena diferirán en función del dominio de aplicación.However, if you add the following configuration file to the example's directory and then run the example, the hash codes for the same string will differ by application domain.

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

Cuando el archivo de configuración está presente, el ejemplo muestra el siguiente resultado:When the configuration file is present, the example displays the following output:

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

Importante

Los códigos hash se utilizan para insertar y recuperar objetos con clave de las tablas hash de forma eficaz.Hash codes are used to insert and retrieve keyed objects from hash tables efficiently. Sin embargo, los códigos hash no identifican cadenas de forma exclusiva.However, hash codes don't uniquely identify strings. Las cadenas idénticas tienen códigos hash iguales, pero el Common Language Runtime también puede asignar el mismo código hash a cadenas diferentes.Identical strings have equal hash codes, but the common language runtime can also assign the same hash code to different strings. Además, los códigos hash pueden variar según la versión de .NET, la plataforma en una sola versión y el dominio de aplicación.In addition, hash codes can vary by version of .NET, by platform within a single version, and by application domain. Por este motivo, no debe serializar ni conservar los valores de código hash ni debe usarlos como claves en una tabla hash o un diccionario.Because of this, you should not serialize or persist hash code values, nor should you use them as keys in a hash table or dictionary.

Para obtener información adicional sobre el uso de códigos hash y GetHashCode el método, Object.GetHashCodevea.For additional information about the use of hash codes and the GetHashCode method, see Object.GetHashCode.

Notas a los autores de las llamadas

El valor devuelto GetHashCode() por depende de la plataforma.The value returned by GetHashCode() is platform-dependent. Difiere en las versiones de 32 bits y 64 bits de la .NET Framework.It differs on the 32-bit and 64-bit versions of the .NET Framework. También puede diferir entre las versiones de .NET Framework y .NET Core.It also can differ between versions of the .NET Framework and .NET Core.

Consulte también:

GetHashCode(ReadOnlySpan<Char>) GetHashCode(ReadOnlySpan<Char>) GetHashCode(ReadOnlySpan<Char>) GetHashCode(ReadOnlySpan<Char>)

Devuelve el código hash del intervalo de caracteres de solo lectura proporcionado.Returns the hash code for the provided read-only character span.

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>

Intervalo de caracteres de solo lectura.A read-only character span.

Devoluciones

Código hash de un entero de 32 bits con signo.A 32-bit signed integer hash code.

Se aplica a