HybridDictionary Osztály
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
IDictionary A gyűjtemény kis ListDictionary méretű, majd a gyűjtemény nagy méretűre váltásával Hashtable valósítja meg.
public ref class HybridDictionary : System::Collections::IDictionarypublic class HybridDictionary : System.Collections.IDictionary[System.Serializable]
public class HybridDictionary : System.Collections.IDictionarytype HybridDictionary = class
interface ICollection
interface IEnumerable
interface IDictionary[<System.Serializable>]
type HybridDictionary = class
interface IDictionary
interface ICollection
interface IEnumerablePublic Class HybridDictionary
Implements IDictionary- Öröklődés
-
HybridDictionary
- Származtatott
- Attribútumok
- Megvalósítás
Példák
Az alábbi példakód a számos tulajdonságát és metódusát HybridDictionarymutatja be.
using System;
using System.Collections;
using System.Collections.Specialized;
public class SamplesHybridDictionary {
public static void Main() {
// Creates and initializes a new HybridDictionary.
HybridDictionary myCol = new HybridDictionary();
myCol.Add( "Braeburn Apples", "1.49" );
myCol.Add( "Fuji Apples", "1.29" );
myCol.Add( "Gala Apples", "1.49" );
myCol.Add( "Golden Delicious Apples", "1.29" );
myCol.Add( "Granny Smith Apples", "0.89" );
myCol.Add( "Red Delicious Apples", "0.99" );
myCol.Add( "Plantain Bananas", "1.49" );
myCol.Add( "Yellow Bananas", "0.79" );
myCol.Add( "Strawberries", "3.33" );
myCol.Add( "Cranberries", "5.98" );
myCol.Add( "Navel Oranges", "1.29" );
myCol.Add( "Grapes", "1.99" );
myCol.Add( "Honeydew Melon", "0.59" );
myCol.Add( "Seedless Watermelon", "0.49" );
myCol.Add( "Pineapple", "1.49" );
myCol.Add( "Nectarine", "1.99" );
myCol.Add( "Plums", "1.69" );
myCol.Add( "Peaches", "1.99" );
// Display the contents of the collection using foreach. This is the preferred method.
Console.WriteLine( "Displays the elements using foreach:" );
PrintKeysAndValues1( myCol );
// Display the contents of the collection using the enumerator.
Console.WriteLine( "Displays the elements using the IDictionaryEnumerator:" );
PrintKeysAndValues2( myCol );
// Display the contents of the collection using the Keys, Values, Count, and Item properties.
Console.WriteLine( "Displays the elements using the Keys, Values, Count, and Item properties:" );
PrintKeysAndValues3( myCol );
// Copies the HybridDictionary to an array with DictionaryEntry elements.
DictionaryEntry[] myArr = new DictionaryEntry[myCol.Count];
myCol.CopyTo( myArr, 0 );
// Displays the values in the array.
Console.WriteLine( "Displays the elements in the array:" );
Console.WriteLine( " KEY VALUE" );
for ( int i = 0; i < myArr.Length; i++ )
Console.WriteLine( " {0,-25} {1}", myArr[i].Key, myArr[i].Value );
Console.WriteLine();
// Searches for a key.
if ( myCol.Contains( "Kiwis" ) )
Console.WriteLine( "The collection contains the key \"Kiwis\"." );
else
Console.WriteLine( "The collection does not contain the key \"Kiwis\"." );
Console.WriteLine();
// Deletes a key.
myCol.Remove( "Plums" );
Console.WriteLine( "The collection contains the following elements after removing \"Plums\":" );
PrintKeysAndValues1( myCol );
// Clears the entire collection.
myCol.Clear();
Console.WriteLine( "The collection contains the following elements after it is cleared:" );
PrintKeysAndValues1( myCol );
}
// Uses the foreach statement which hides the complexity of the enumerator.
// NOTE: The foreach statement is the preferred way of enumerating the contents of a collection.
public static void PrintKeysAndValues1( IDictionary myCol ) {
Console.WriteLine( " KEY VALUE" );
foreach ( DictionaryEntry de in myCol )
Console.WriteLine( " {0,-25} {1}", de.Key, de.Value );
Console.WriteLine();
}
// Uses the enumerator.
// NOTE: The foreach statement is the preferred way of enumerating the contents of a collection.
public static void PrintKeysAndValues2( IDictionary myCol ) {
IDictionaryEnumerator myEnumerator = myCol.GetEnumerator();
Console.WriteLine( " KEY VALUE" );
while ( myEnumerator.MoveNext() )
Console.WriteLine( " {0,-25} {1}", myEnumerator.Key, myEnumerator.Value );
Console.WriteLine();
}
// Uses the Keys, Values, Count, and Item properties.
public static void PrintKeysAndValues3( HybridDictionary myCol ) {
String[] myKeys = new String[myCol.Count];
myCol.Keys.CopyTo( myKeys, 0 );
Console.WriteLine( " INDEX KEY VALUE" );
for ( int i = 0; i < myCol.Count; i++ )
Console.WriteLine( " {0,-5} {1,-25} {2}", i, myKeys[i], myCol[myKeys[i]] );
Console.WriteLine();
}
}
/*
This code produces output similar to the following:
Displays the elements using foreach:
KEY VALUE
Strawberries 3.33
Yellow Bananas 0.79
Cranberries 5.98
Grapes 1.99
Granny Smith Apples 0.89
Seedless Watermelon 0.49
Honeydew Melon 0.59
Red Delicious Apples 0.99
Navel Oranges 1.29
Fuji Apples 1.29
Plantain Bananas 1.49
Gala Apples 1.49
Pineapple 1.49
Plums 1.69
Braeburn Apples 1.49
Peaches 1.99
Golden Delicious Apples 1.29
Nectarine 1.99
Displays the elements using the IDictionaryEnumerator:
KEY VALUE
Strawberries 3.33
Yellow Bananas 0.79
Cranberries 5.98
Grapes 1.99
Granny Smith Apples 0.89
Seedless Watermelon 0.49
Honeydew Melon 0.59
Red Delicious Apples 0.99
Navel Oranges 1.29
Fuji Apples 1.29
Plantain Bananas 1.49
Gala Apples 1.49
Pineapple 1.49
Plums 1.69
Braeburn Apples 1.49
Peaches 1.99
Golden Delicious Apples 1.29
Nectarine 1.99
Displays the elements using the Keys, Values, Count, and Item properties:
INDEX KEY VALUE
0 Strawberries 3.33
1 Yellow Bananas 0.79
2 Cranberries 5.98
3 Grapes 1.99
4 Granny Smith Apples 0.89
5 Seedless Watermelon 0.49
6 Honeydew Melon 0.59
7 Red Delicious Apples 0.99
8 Navel Oranges 1.29
9 Fuji Apples 1.29
10 Plantain Bananas 1.49
11 Gala Apples 1.49
12 Pineapple 1.49
13 Plums 1.69
14 Braeburn Apples 1.49
15 Peaches 1.99
16 Golden Delicious Apples 1.29
17 Nectarine 1.99
Displays the elements in the array:
KEY VALUE
Strawberries 3.33
Yellow Bananas 0.79
Cranberries 5.98
Grapes 1.99
Granny Smith Apples 0.89
Seedless Watermelon 0.49
Honeydew Melon 0.59
Red Delicious Apples 0.99
Navel Oranges 1.29
Fuji Apples 1.29
Plantain Bananas 1.49
Gala Apples 1.49
Pineapple 1.49
Plums 1.69
Braeburn Apples 1.49
Peaches 1.99
Golden Delicious Apples 1.29
Nectarine 1.99
The collection does not contain the key "Kiwis".
The collection contains the following elements after removing "Plums":
KEY VALUE
Strawberries 3.33
Yellow Bananas 0.79
Cranberries 5.98
Grapes 1.99
Granny Smith Apples 0.89
Seedless Watermelon 0.49
Honeydew Melon 0.59
Red Delicious Apples 0.99
Navel Oranges 1.29
Fuji Apples 1.29
Plantain Bananas 1.49
Gala Apples 1.49
Pineapple 1.49
Braeburn Apples 1.49
Peaches 1.99
Golden Delicious Apples 1.29
Nectarine 1.99
The collection contains the following elements after it is cleared:
KEY VALUE
*/
Imports System.Collections
Imports System.Collections.Specialized
Public Class SamplesHybridDictionary
Public Shared Sub Main()
' Creates and initializes a new HybridDictionary.
Dim myCol As New HybridDictionary()
myCol.Add("Braeburn Apples", "1.49")
myCol.Add("Fuji Apples", "1.29")
myCol.Add("Gala Apples", "1.49")
myCol.Add("Golden Delicious Apples", "1.29")
myCol.Add("Granny Smith Apples", "0.89")
myCol.Add("Red Delicious Apples", "0.99")
myCol.Add("Plantain Bananas", "1.49")
myCol.Add("Yellow Bananas", "0.79")
myCol.Add("Strawberries", "3.33")
myCol.Add("Cranberries", "5.98")
myCol.Add("Navel Oranges", "1.29")
myCol.Add("Grapes", "1.99")
myCol.Add("Honeydew Melon", "0.59")
myCol.Add("Seedless Watermelon", "0.49")
myCol.Add("Pineapple", "1.49")
myCol.Add("Nectarine", "1.99")
myCol.Add("Plums", "1.69")
myCol.Add("Peaches", "1.99")
' Display the contents of the collection using For Each. This is the preferred method.
Console.WriteLine("Displays the elements using For Each:")
PrintKeysAndValues1(myCol)
' Display the contents of the collection using the enumerator.
Console.WriteLine("Displays the elements using the IDictionaryEnumerator:")
PrintKeysAndValues2(myCol)
' Display the contents of the collection using the Keys, Values, Count, and Item properties.
Console.WriteLine("Displays the elements using the Keys, Values, Count, and Item properties:")
PrintKeysAndValues3(myCol)
' Copies the HybridDictionary to an array with DictionaryEntry elements.
Dim myArr(myCol.Count) As DictionaryEntry
myCol.CopyTo(myArr, 0)
' Displays the values in the array.
Console.WriteLine("Displays the elements in the array:")
Console.WriteLine(" KEY VALUE")
Dim i As Integer
For i = 0 To myArr.Length - 1
Console.WriteLine(" {0,-25} {1}", myArr(i).Key, myArr(i).Value)
Next i
Console.WriteLine()
' Searches for a key.
If myCol.Contains("Kiwis") Then
Console.WriteLine("The collection contains the key ""Kiwis"".")
Else
Console.WriteLine("The collection does not contain the key ""Kiwis"".")
End If
Console.WriteLine()
' Deletes a key.
myCol.Remove("Plums")
Console.WriteLine("The collection contains the following elements after removing ""Plums"":")
PrintKeysAndValues1(myCol)
' Clears the entire collection.
myCol.Clear()
Console.WriteLine("The collection contains the following elements after it is cleared:")
PrintKeysAndValues1(myCol)
End Sub
' Uses the For Each statement which hides the complexity of the enumerator.
' NOTE: The For Each statement is the preferred way of enumerating the contents of a collection.
Public Shared Sub PrintKeysAndValues1(myCol As IDictionary)
Console.WriteLine(" KEY VALUE")
Dim de As DictionaryEntry
For Each de In myCol
Console.WriteLine(" {0,-25} {1}", de.Key, de.Value)
Next de
Console.WriteLine()
End Sub
' Uses the enumerator.
' NOTE: The For Each statement is the preferred way of enumerating the contents of a collection.
Public Shared Sub PrintKeysAndValues2(myCol As IDictionary)
Dim myEnumerator As IDictionaryEnumerator = myCol.GetEnumerator()
Console.WriteLine(" KEY VALUE")
While myEnumerator.MoveNext()
Console.WriteLine(" {0,-25} {1}", myEnumerator.Key, myEnumerator.Value)
End While
Console.WriteLine()
End Sub
' Uses the Keys, Values, Count, and Item properties.
Public Shared Sub PrintKeysAndValues3(myCol As HybridDictionary)
Dim myKeys(myCol.Count) As [String]
myCol.Keys.CopyTo(myKeys, 0)
Console.WriteLine(" INDEX KEY VALUE")
Dim i As Integer
For i = 0 To myCol.Count - 1
Console.WriteLine(" {0,-5} {1,-25} {2}", i, myKeys(i), myCol(myKeys(i)))
Next i
Console.WriteLine()
End Sub
End Class
'This code produces output similar to the following:
'
'Displays the elements using For Each:
' KEY VALUE
' Strawberries 3.33
' Yellow Bananas 0.79
' Cranberries 5.98
' Grapes 1.99
' Granny Smith Apples 0.89
' Seedless Watermelon 0.49
' Honeydew Melon 0.59
' Red Delicious Apples 0.99
' Navel Oranges 1.29
' Fuji Apples 1.29
' Plantain Bananas 1.49
' Gala Apples 1.49
' Pineapple 1.49
' Plums 1.69
' Braeburn Apples 1.49
' Peaches 1.99
' Golden Delicious Apples 1.29
' Nectarine 1.99
'
'Displays the elements using the IDictionaryEnumerator:
' KEY VALUE
' Strawberries 3.33
' Yellow Bananas 0.79
' Cranberries 5.98
' Grapes 1.99
' Granny Smith Apples 0.89
' Seedless Watermelon 0.49
' Honeydew Melon 0.59
' Red Delicious Apples 0.99
' Navel Oranges 1.29
' Fuji Apples 1.29
' Plantain Bananas 1.49
' Gala Apples 1.49
' Pineapple 1.49
' Plums 1.69
' Braeburn Apples 1.49
' Peaches 1.99
' Golden Delicious Apples 1.29
' Nectarine 1.99
'
'Displays the elements using the Keys, Values, Count, and Item properties:
' INDEX KEY VALUE
' 0 Strawberries 3.33
' 1 Yellow Bananas 0.79
' 2 Cranberries 5.98
' 3 Grapes 1.99
' 4 Granny Smith Apples 0.89
' 5 Seedless Watermelon 0.49
' 6 Honeydew Melon 0.59
' 7 Red Delicious Apples 0.99
' 8 Navel Oranges 1.29
' 9 Fuji Apples 1.29
' 10 Plantain Bananas 1.49
' 11 Gala Apples 1.49
' 12 Pineapple 1.49
' 13 Plums 1.69
' 14 Braeburn Apples 1.49
' 15 Peaches 1.99
' 16 Golden Delicious Apples 1.29
' 17 Nectarine 1.99
'
'Displays the elements in the array:
' KEY VALUE
' Strawberries 3.33
' Yellow Bananas 0.79
' Cranberries 5.98
' Grapes 1.99
' Granny Smith Apples 0.89
' Seedless Watermelon 0.49
' Honeydew Melon 0.59
' Red Delicious Apples 0.99
' Navel Oranges 1.29
' Fuji Apples 1.29
' Plantain Bananas 1.49
' Gala Apples 1.49
' Pineapple 1.49
' Plums 1.69
' Braeburn Apples 1.49
' Peaches 1.99
' Golden Delicious Apples 1.29
' Nectarine 1.99
'
'The collection does not contain the key "Kiwis".
'
'The collection contains the following elements after removing "Plums":
' KEY VALUE
' Strawberries 3.33
' Yellow Bananas 0.79
' Cranberries 5.98
' Grapes 1.99
' Granny Smith Apples 0.89
' Seedless Watermelon 0.49
' Honeydew Melon 0.59
' Red Delicious Apples 0.99
' Navel Oranges 1.29
' Fuji Apples 1.29
' Plantain Bananas 1.49
' Gala Apples 1.49
' Pineapple 1.49
' Braeburn Apples 1.49
' Peaches 1.99
' Golden Delicious Apples 1.29
' Nectarine 1.99
'
'The collection contains the following elements after it is cleared:
' KEY VALUE
Megjegyzések
Ez az osztály olyan esetekben ajánlott, amikor a szótár elemeinek száma ismeretlen. Kihasználja a kisebb gyűjtemények jobb teljesítményét ListDictionary , és rugalmasan válthat a Hashtablenagyobb gyűjteményeket jobban ListDictionarykezelő gyűjteményekre.
Ha a gyűjtemény kezdeti mérete nagyobb, mint egy ListDictionaryadott gyűjtemény optimális mérete, a gyűjteményt a rendszer tároljaHashtable, hogy elkerülje az elemek átmásolásának többletterhelését.ListDictionaryHashtable
A konstruktor elfogad egy logikai paramétert, amely lehetővé teszi a felhasználó számára annak megadását, hogy a gyűjtemény figyelmen kívül hagyja-e az esetet a sztringek összehasonlítása során. Ha a gyűjtemény megkülönbözteti a kis- és Object.GetHashCodenagybetűketObject.Equals, a kulcs implementációit használja. Ha a gyűjtemény kis- és nagybetűket nem érzékelyítő, egyszerű, a kis- és nagybetűket megkülönböztető összehasonlítást hajt végre, amely csak az invariáns kultúra casing szabályait követi. Alapértelmezés szerint a gyűjtemény megkülönbözteti a kis- és nagybetűk értékét. További információ az invariáns kultúráról: System.Globalization.CultureInfo.
A kulcs nem lehet null értékű, de egy érték igen.
A C# nyelv foreach utasítása (For Each Visual Basic) a gyűjtemény elemeinek típusát adja vissza. Mivel a HybridDictionary kulcs minden eleme kulcs/érték pár, az elem típusa nem a kulcs típusa vagy az érték típusa. Ehelyett az elem típusa .DictionaryEntry Például:
foreach (DictionaryEntry de in myHybridDictionary)
{
//...
}
For Each de In myHybridDictionary
'...
Next
Az foreach utasítás egy burkoló az enumerátor körül, amely csak a gyűjteményből való olvasást teszi lehetővé, nem pedig a gyűjteménybe való írást.
Konstruktorok
| Name | Description |
|---|---|
| HybridDictionary() |
Üres kis- és nagybetűk megkülönböztetése HybridDictionary. |
| HybridDictionary(Boolean) |
Létrehoz egy üreset HybridDictionary a megadott kis- és nagybetűk érzékenységével. |
| HybridDictionary(Int32, Boolean) |
Létrehoz egy HybridDictionary megadott kezdeti méretet és kis- és nagybetűk érzékenységét. |
| HybridDictionary(Int32) |
Egy kis- és nagybetűk megkülönböztetése HybridDictionary a megadott kezdeti mérettel. |
Tulajdonságok
| Name | Description |
|---|---|
| Count |
Lekéri a kulcs/érték párok számát a HybridDictionary. |
| IsFixedSize |
Egy értéket kap, amely jelzi, hogy a HybridDictionary méret rögzített-e. |
| IsReadOnly |
Beolvas egy értéket, amely jelzi, hogy az HybridDictionary írásvédett-e. |
| IsSynchronized |
Lekéri a szinkronizált HybridDictionary (szálbiztos) értéket. |
| Item[Object] |
Lekéri vagy beállítja a megadott kulccsal társított értéket. |
| Keys |
ICollection Lekéri a kulcsokat HybridDictionarya . |
| SyncRoot |
Lekéri az objektumot, amely a hozzáférés szinkronizálására használható.HybridDictionary |
| Values |
A beolvas egy ICollection olyan értéket, amely tartalmazza a . HybridDictionaryértékét. |
Metódusok
| Name | Description |
|---|---|
| Add(Object, Object) |
A megadott kulccsal és értékkel rendelkező bejegyzést ad hozzá a HybridDictionary. |
| Clear() |
Eltávolítja az összes bejegyzést a HybridDictionaryprogramból. |
| Contains(Object) |
Meghatározza, hogy a HybridDictionary kulcs tartalmaz-e egy adott kulcsot. |
| CopyTo(Array, Int32) |
A bejegyzéseket egy egydimenziós HybridDictionary példányba másolja Array a megadott indexben. |
| Equals(Object) |
Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object) |
| GetEnumerator() |
Egy olyan értéket IDictionaryEnumerator ad vissza, amely a HybridDictionary. |
| GetHashCode() |
Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object) |
| GetType() |
Lekéri az Type aktuális példányt. (Öröklődés forrása Object) |
| MemberwiseClone() |
Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object) |
| Remove(Object) |
Eltávolítja a megadott kulccsal rendelkező bejegyzést a HybridDictionary. |
| ToString() |
Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object) |
Explicit interfész-implementációk
| Name | Description |
|---|---|
| IEnumerable.GetEnumerator() |
Egy olyan értéket IEnumerator ad vissza, amely a HybridDictionary. |
Bővítő metódusok
| Name | Description |
|---|---|
| AsParallel(IEnumerable) |
Lehetővé teszi a lekérdezés párhuzamosítását. |
| AsQueryable(IEnumerable) |
Átalakítja az egyiket IEnumerableIQueryable. |
| Cast<TResult>(IEnumerable) |
Egy elem elemeit IEnumerable a megadott típusra veti. |
| OfType<TResult>(IEnumerable) |
Egy adott típus alapján szűri IEnumerable egy adott elem elemeit. |
A következőre érvényes:
Szálbiztonság
A nyilvános statikus (Shared Visual Basic) ilyen típusú tagjai szálbiztosak. A példánytagok nem garantáltan szálbiztosak.
Ez az implementáció nem biztosít szinkronizált (szálbiztos) burkolót egy HybridDictionary, de a származtatott osztályok létrehozhatják a saját szinkronizált verzióikat a HybridDictionarySyncRoot tulajdonság használatával.
A gyűjteményen keresztüli számbavétel alapvetően nem szálbiztos eljárás. A gyűjtemény szinkronizálása esetén is más szálak módosíthatják a gyűjteményt, ami miatt az enumerátor kivételt okoz. Az enumerálás során a szálbiztonság garantálása érdekében zárolhatja a gyűjteményt a teljes enumerálás során, vagy elkaphatja a más szálak által végrehajtott módosításokból eredő kivételeket.
