主题
    about_Hash_Tables

简短说明
    说明如何在 Windows PowerShell 中创建、使用和排序哈希表。


详细说明
    哈希表（也称为字典或关联数组）是一种紧凑型数据结构，用于存储一个或多个名称/值对。例如，
    哈希表可能包含一系列姓名与职员 ID、计算机名称与 IP 地址，或消息 ID 与消息文本。
 

    哈希表很常用，这是因为哈希表在查找和检索数据时的效率很高。在 Windows PowerShell 中，哈
    希表可用来存储列表和创建计算属性。此外，Windows PowerShell 具有 cmdlet ConvertFrom-
    StringData，可用于将字符串转换为哈希表。


  创建哈希表
      哈希表中的各项按名称/值对排列，如下所示：


          Msg1="Please enter your password."
          Msg2="The path parameter is required."
          Msg3="The alias of Get-Command is gcm."

      值映射到名称或与名称关联，以便提交名称时 Windows PowerShell 返回相应值。


      在 Windows PowerShell 中，哈希表的语法如下：

 
          @{ <name> = <value>; [<name> = <value> ] ...}


      创建哈希表时，请遵循以下准则：


          - 以 at 符号 (@) 作为哈希表开头。

          - 用大括号 ({}) 将哈希表括起。

          - 输入一个或多个名称/值对作为哈希表的内容。

          - 使用等号 (=) 将每个名称与其值分隔开。

          - 使用分号 (;) 分隔名称/值对。

          - 如果名称或值包含空格，请将其用引号括起。


      例如，上述用户消息的哈希表如下所示：


          @{
          Msg1="Please enter your password.";
          Msg2="The path parameter is required.";
          Msg3="The alias of Get-Command is gcm.";
          }

      若要在脚本和命令中使用哈希表，请将其保存在变量中。该变量的值是一个哈希表对象 
      (System.Collections.Hashtable)，而名称/值对中的每个名称都是该哈希表对象的一个属性。


      以下命令将 user-message 哈希表保存在 $a 变量中，并使用点表示法显示这些值。


          C:\PS> $a = @{
          >> Msg1="Please enter your password.";
          >> Msg2="The path parameter is required.";
          >> Msg3="The alias of Get-Command is gcm.";
          >> }



          C:\PS> $a
          Name                           Value
          ----                           -----
          Msg1                    Please enter your password.
          Msg3                    The alias of Get-Command is gcm.
          Msg2                    The path parameter is required.

          C:\PS> $a.Msg1
          Please enter your password.


      哈希表不限于一种数据类型。可以在哈希表中输入任何数据类型，还可以将不同数据类型
      合并在一个哈希表中。例如，可以生成一个包含整数、cmdlet 调用和字符串的哈希表。


  排序哈希表
      要按键或值的字母顺序对哈希表进行排序，请使用哈希表的 GetEnumerator 方法获取哈希表中的
      键和值，然后使用 Sort-Object cmdlet 对其进行排序。


      例如，以下命令按键的字母顺序对 $a 中的哈希表进行排序。


          C:\PS> $a.getenumerator() | sort-object -property key

          Name                           Value
          ----                           -----
          Msg1                           Please enter your password.
          Msg2                           The path parameter is required.
          Msg3                           The alias of Get-Command is gcm.


      以下命令使用同一方法按降序对哈希值进行排序。


          C:\PS> $a.getenumerator() | sort-object -property value 
          -descending

          Name                           Value
          ----                           -----
          Msg2                           The path parameter is required.
          Msg3                           The alias of Get-Command is gcm.
          Msg1                           Please enter your password.



  ConvertFrom-StringData
      ConvertFrom-StringData cmdlet 将名称/值对的字符串或 here-string 转换为哈希表。可
      以在脚本的 Data 节中安全地使用 ConvertFrom-StringData cmdlet，还可以将该 cmdlet 与 
      Import-LocalizedData cmdlet 一起使用，从而以当前用户的用户界面 (UI) 区域性显示用户
      消息。


      当哈希表中的值包含引号时，Here-string 尤为有用。（有关 here-string 的详细信息，请参
      阅 about_Quoting_Rules。）


      以下示例说明如何为上例中的用户消息创建 here-string，以及如何使用 ConvertFrom-
      StringData 将其从字符串转换为哈希表。


      以下命令创建名称/值对的 here-string，然后将其保存在 $string 变量中。


          C:\PS> $string = @"
          Msg1="Please enter your password."
          Msg2="The path parameter is required."
          Msg3="The alias of Get-Command is gcm."
          "@

   
    以下命令使用 ConvertFrom-StringData cmdlet 将 here-string 转换为哈希表。


        C:\PS> convertfrom-stringdata $string

        Name                           Value
        ----                           -----
        Msg3                           "The alias of Get-Command is gcm."
        Msg2                           "The path parameter is required."
        Msg1                           "Please enter your password."


另请参阅
    about_Arrays
    about_Quoting_Rules
    about_Script_Internationalization 
    ConvertFrom-StringData
    Import-LocalizedData



目录