Neste artigo vou apresentar os conceitos básicos sobre a classe HashTable da linguagem C#.

Nota : As classes básicas de coleções aceitam, mantém e retornam seus elementos como objetos, isto é, o tipo de elemento de uma classe de coleção é um objeto. Para entender as implicações disto, é útil para contrastar um array de variáveis int (int é um tipo de valor) com um array de objetos (object é um tipo de referência). Como int é um tipo de valor, uma série de variáveis int detém seus valores int diretamente, como mostrado na figura a seguir:

Agora, considere o caso quando o array é uma matriz de objetos. Você ainda pode adicionar valores inteiros a essa matriz. (Na verdade, você pode adicionar valores de qualquer tipo a ele.) Quando você adiciona um valor inteiro, ele é 'embalado' automaticamente, e o elemento da matriz (uma referência de objeto) refere-se à cópia em caixa do valor inteiro. Isto é ilustrado na figura abaixo seguinte:

O tipo de elemento de todas as classes de coleções é um objeto. isso significa que quando você inserir um valor em uma coleção, ele é embalado/encaixotado, e quando você remover um valor de uma coleção, você deve desencaixotá-lo, ou seja retornar ao seu tipo original, usando um cast.

using System;
using System.Collections;

namespace HashTable
{
    class Program
    {
        static void Main(string[] args)
        {
            Hashtable idades = new Hashtable();
            //preenche uma HashTable
            idades["Macoratti"] = 48;
            idades["Miriam"] = 39;
            idades["Janice"] = 21;
            idades["Jefferson"] = 23;
            idades["Yuri"] = 21;
            idades["Bianca"] = 21;

            // iterando usando a instrução foreach 
            // O iterador gera um objeto DictionaryEntry contendo o par key/value
            foreach (DictionaryEntry element in idades)
            {
               //obtém os valores da HashTable usando Key e Value
                string nome = (string)element.Key;
                int idade = (int)element.Value;
                //exibe os valores da HashTable
                Console.WriteLine("Nome: {0}, Idade: {1}", nome, idade);
            }
        }
    }
}

using System;
using System.Collections;

namespace Exemplo2
{
    class Program
    {
        static void Main(string[] args)
        {
            Hashtable hashtable = new Hashtable();
            hashtable.Add(100, "Santos");
            hashtable.Add(200, "Campinas");
            hashtable.Add(300, "Americana");
            hashtable.Add(400, "Lins");
            hashtable.Add(500, "Catanduva");

            // Exibe as chaves
            foreach (int key in hashtable.Keys)
            {
               Console.WriteLine("Chaves : " + key);
            }

            // Exibe os valores
            foreach (string value in hashtable.Values)
            {
               Console.WriteLine("Valores : "  + value);
            }
            Console.ReadKey();
        }
    }
}

using System;
using System.Collections;

namespace Exemplo3
{
    class Program
    {
        static Hashtable GetHashtable()
        {
            // Cria a retorna um novo Hashtable.
            Hashtable hashtable = new Hashtable();
            hashtable.Add("Despesas", 1000);
            hashtable.Add("Receitas", 1550);
            hashtable.Add("Alimentos", 190);
            hashtable.Add("Viagens", 440);
            hashtable.Add("Pagamentos", 27);
            return hashtable;
        }

        static void Main(string[] args)
        {
            Hashtable hashtable = GetHashtable();

            // Verifica se a Hashtable contém esta chave
            Console.WriteLine(hashtable.ContainsKey("Alimentos"));

            // Testa o método Contains p/ver funciona igual a ContainsKey
            Console.WriteLine(hashtable.Contains("Viagens"));

            // Pega o valor da Area como o indice
            int value = (int)hashtable["Viagens"];

            // Escreve o valor da área
            Console.WriteLine(value);

            Console.ReadKey();
        }
    }
}

HashTable

Dictionary