<UseRandomizedStringHashAlgorithm> – element

Článek
05/09/2023

Určuje, zda modul CLR (Common Language Runtime) počítá kódy hash řetězců pro každou doménu aplikace.

<Konfigurace>
<Runtime>
<UseRandomizedStringHashAlgorithm>

Syntax

<UseRandomizedStringHashAlgorithm
   enabled=0|1 />

Atributy a elementy

Následující části popisují atributy, podřízené prvky a nadřazené prvky.

Atributy

Atribut	Popis
`enabled`	Požadovaný atribut. Určuje, jestli se kódy hash pro řetězce počítají na základě domény aplikace.

Atribut enabled

Hodnota	Popis
`0`	Modul CLR (Common Language Runtime) nevypočítává kódy hash pro řetězce na základě domény aplikace. Jeden algoritmus se používá k výpočtu řetězcových hash kódů. Tato možnost je výchozí.
`1`	Modul CLR (Common Language Runtime) počítá kódy hash řetězců pro každou doménu aplikace. Identické řetězce v různých doménách aplikace a v různých procesech budou mít různé kódy hash.

Podřízené elementy

Žádné

Nadřazené elementy

Element	Popis
`configuration`	Kořenový prvek v každém konfiguračním souboru, který je používán modulem Common Language Runtime (CLR) a aplikacemi rozhraní .NET Framework.
`runtime`	Obsahuje informace o možnostech inicializace modulu runtime.

Poznámky

Ve výchozím nastavení StringComparer třída a String.GetHashCode metoda používají jeden algoritmus hash, který vytváří konzistentní hashovací kód napříč doménami aplikace. To je ekvivalentem nastavení enabled atributu elementu <UseRandomizedStringHashAlgorithm> na 0. Toto je algoritmus hash používaný v rozhraní .NET Framework 4.

Třída StringComparer a String.GetHashCode metoda mohou také používat jiný hashovací algoritmus, který počítá kódy hash na základě domény aplikace. V důsledku toho se kódy hash ekvivalentních řetězců v jednotlivých doménách aplikace budou lišit. Toto je funkce s výslovným souhlasem; pokud ho chcete využít, musíte nastavit enabled atribut elementu <UseRandomizedStringHashAlgorithm> na 1.

Vyhledávání řetězců v tabulce hash je obvykle operace O(1). Pokud však dojde k velkému počtu kolizí, vyhledávání se může stát operací O(n²). Konfigurační prvek můžete použít <UseRandomizedStringHashAlgorithm> k vygenerování algoritmu náhodného hashování pro každou doménu aplikace, který omezuje počet potenciálních kolizí, zejména pokud klíče, ze kterých se počítají hashové kódy, jsou založeny na datovém vstupu uživatelů.

Příklad

Následující příklad definuje DisplayString třídu, která obsahuje privátní řetězcovou konstantu , sjejíž hodnota je "Toto je řetězec". Obsahuje také metodu ShowStringHashCode , která zobrazuje hodnotu řetězce a jeho hashový kód spolu s názvem domény aplikace, ve které se metoda spouští.

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

Když spustíte příklad bez zadání konfiguračního souboru, zobrazí se výstup podobný následujícímu. Všimněte si, že kódy hash pro řetězec jsou v obou doménách aplikace identické.

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

Pokud ale do adresáře v příkladu přidáte následující konfigurační soubor a pak tento příklad spustíte, budou se kódy hash pro stejný řetězec lišit v závislosti na doméně aplikace.

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

Když je konfigurační soubor k dispozici, příklad zobrazí následující výstup:

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