Sdílet prostřednictvím

<UseRandomizedStringHashAlgorithm> Element

Určuje, zda modul CLR (Common Language Runtime) vypočítá kódy hash pro řetězce na základě domény aplikace.

<konfigurace>
   <runtime>
     <UseRandomizedStringHashAlgorithm>

Syntaxe

<UseRandomizedStringHashAlgorithm
   enabled=0|1 />

Atributy a prvky

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

Attributes

Vlastnost Description
enabled Povinný atribut.

Určuje, jestli se kódy hash pro řetězce počítají na základě domény aplikace.

enabled – atribut

Hodnota Description
0 Modul CLR (Common Language Runtime) nevypočítává kódy hash řetězců pro každou doménu aplikace; K výpočtu hodnot hash řetězců se používá jeden algoritmus. Toto je výchozí hodnota.
1 Modul CLR (Common Language Runtime) vypočítá kódy hash pro řetězce na základě domény aplikace. Identické řetězce v různých doménách aplikace a v různých procesech budou mít různé hashovací kódy.

Podřízené prvky

Žádné.

Nadřazené prvky

prvek Description
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 ekvivalent k nastavení enabled atributu <UseRandomizedStringHashAlgorithm> prvku na 0. Toto je algoritmus hash používaný v rozhraní .NET Framework 4.

Třída StringComparer a String.GetHashCode metoda mohou také použít jiný algoritmus hash, který počítá kódy hash pro každou doménu aplikace. V důsledku toho se kódy hash pro ekvivalentní řetězce budou lišit v různých doménách aplikace. Jedná se o funkci výslovného souhlasu; chcete-li využít výhod, je nutné nastavit enabled atribut <UseRandomizedStringHashAlgorithm> prvku na 1.

Vyhledávání řetězců v tabulce hash je obvykle operace O(1). Pokud ale dojde k velkému počtu kolizí, může se vyhledávání stát operací O(n2). Pomocí konfiguračního <UseRandomizedStringHashAlgorithm> prvku můžete vygenerovat náhodný algoritmus hash pro každou doménu aplikace, který zase omezuje počet potenciálních kolizí, zejména v případě, že klíče, ze kterých se kódy hash počítají, vycházejí ze vstupních dat uživateli.

Example

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 řetězcovou hodnotu a kód hash 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 '{s}' in domain '{AppDomain.CurrentDomain.FriendlyName}': {s.GetHashCode():X8}");
   }
}

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

Při spuštění příkladu bez zadání konfiguračního souboru se zobrazí výstup podobný následujícímu. Všimněte si, že kódy hash řetězce jsou identické ve dvou doménách aplikace.

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

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

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

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

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

Viz také

  • Last updated on