Objekt Dictionary

Tento objekt je určen pro ukládání pojmenovaných hodnot. Tyto hodnoty jsou přístupné přes svůj název (tzv. klíč). Objekt Dictionary se liší od kolekcí zejména v tom, že poskytuje také metodu pro přidávání hodnot.

Protože se nejedná a vnitřní objekt ASP, je nutné před jeho použitím vytvořit jeho instanci. V dalším textu budeme předpokládat, že máme instanci objektu Dictionary pojmenovanou objDictionary.

ProgID, které potřebujeme znát pro vytvoření instance je "Scripting.Dictionary".

Metody

Metoda Add

Metoda Add přidá do objektu Dictionary zadanou hodnotu se zadaným klíčem. Metoda se volá:

objDictionary.Add("klíč","hodnota")

Metoda Exists

Metoda Exists vrací true pokud objekt obsahuje hodnotu se zadaným klíčem, v opačném případě vrací hodnotu false.

Příklad:

If objDictionary.Exists("jmeno") Then
  Response.Write "Hodnota s klíčem ""jmeno"" se v objektu vyskytuje."

Metoda Items

Metoda Items vrací pole obsahující všechny hodnoty z objektu Dictionary.

Metoda Keys

Metoda Keys vrací pole všech klíčů z objektu Dictionary.

Příklad vypsání celého obsahu objektu Dictionary s využitím metod Items a Keys:

klice = objDictionary.Keys
polozky = objDictionary.Items
For i = 0 To objDictionary.Count - 1
  Response.Write klice(i) & " = " & polozky(i) & "<BR>"

Metoda Remove

Metoda Remove odstraní z objektu Dictionary hodnotu se zadaným klíčem. Pokud se hodnota se zadaným klíčem v objektu nevyskytuje, dojde k chybě.

Metoda RemoveAll

Metoda RemoveAll odstraní z objektu Dictionary všechny hodnoty.

Atributy

Atribut CompareMode

Hodnota tohoto atributu určuje způsob porovnávání klíčů. Hodnota 0 (BinaryCompare) znamená, že klíče budou porovnávány binárně (tzn. bude brán ohled na velikost písmen). Hodnota 1 (TextCompare) znamená, že při porovnávání klíčů nebude brán ohled na velikost písmen.

Aby bylo možné použít místo hodnot 0 a 1 konstanty, musí stránka (nebo příslušný soubor global.asa) obsahovat následující direktivu.

<!-- METADATA TYPE="TypeLib" FILE="C:\WinNT\System32\scrrun.dll" -->

Tato cesta platí např. pro Windows NT a 2000, ve Windows 9x bude nutné tuto cestu mírně pozměnit. Z tohoto důvodu je lepší si tyto konstanty nadefinovat přímo ve stránce, v níž je chceme použít, případně v samostatném souboru, který pak budeme vkládat do ostatních stránek.

Pokud změníte hodnotu tohoto atributu v době, kdy již objekt Dictionary obsahuje nějaká data, dojde k chybě.

Atribut Count

Atribut Count obsahuje počet hodnot uložených v objektu Dictionary.

Atribut Item

Atribut Item slouží pro přístup k hodnotám uloženým v objektu Dictionary. K hodnotám se přistupuje prostřednictvím klíče. Příklad:

hodnota = objDictionary.Item(klic)
objDictionary.Item(klic) = hodnota

Pokud budeme nastavovat hodnotu položky, jejíž klíč ještě v objektu Dictionary neexistuje, vytvoří se v objektu nová dvojice klíč/hodnota.

Atribut Key

Atribut Key je přístupný pouze pro zápis a slouží pro přejmenování klíče v objektu Dictionary.

Příklad:

objDictionary.Key("stary_nazev") = "novy_nazev"

Hlavní stránka