Dictionary<TKey,TValue> Konstruktoren

Definition

Initialisiert eine neue Instanz der Dictionary<TKey,TValue>-Klasse.Initializes a new instance of the Dictionary<TKey,TValue> class.

Überlädt

Dictionary<TKey,TValue>()

Initialisiert eine neue, leere Instanz der Dictionary<TKey,TValue>-Klasse mit der Standardanfangskapazität, wobei der Standardgleichheitsvergleich für den Schlüsseltyp verwendet wird.Initializes a new instance of the Dictionary<TKey,TValue> class that is empty, has the default initial capacity, and uses the default equality comparer for the key type.

Dictionary<TKey,TValue>(IDictionary<TKey,TValue>)

Initialisiert eine neue Instanz der Dictionary<TKey,TValue>-Klasse, die aus dem angegebenen IDictionary<TKey,TValue> kopierte Elemente enthält und den Standardgleichheitsvergleich für den Schlüsseltyp verwendet.Initializes a new instance of the Dictionary<TKey,TValue> class that contains elements copied from the specified IDictionary<TKey,TValue> and uses the default equality comparer for the key type.

Dictionary<TKey,TValue>(IEnumerable<KeyValuePair<TKey,TValue>>)

Initialisiert eine neue Instanz der- Dictionary<TKey,TValue> Klasse, die aus dem angegebenen kopierte Elemente enthält IEnumerable<T> .Initializes a new instance of the Dictionary<TKey,TValue> class that contains elements copied from the specified IEnumerable<T>.

Dictionary<TKey,TValue>(IEqualityComparer<TKey>)

Initialisiert eine neue, leere Instanz der Dictionary<TKey,TValue>-Klasse mit der Standardanfangskapazität und dem angegebenen IEqualityComparer<T>.Initializes a new instance of the Dictionary<TKey,TValue> class that is empty, has the default initial capacity, and uses the specified IEqualityComparer<T>.

Dictionary<TKey,TValue>(Int32)

Initialisiert eine neue, leere Instanz der Dictionary<TKey,TValue>-Klasse mit der Standardanfangskapazität, wobei der Standardgleichheitsvergleich für den Schlüsseltyp verwendet wird.Initializes a new instance of the Dictionary<TKey,TValue> class that is empty, has the specified initial capacity, and uses the default equality comparer for the key type.

Dictionary<TKey,TValue>(IDictionary<TKey,TValue>, IEqualityComparer<TKey>)

Initialisiert eine neue Instanz der Dictionary<TKey,TValue>-Klasse, die aus dem angegebenen IDictionary<TKey,TValue> kopierte Elemente enthält und den angegebenen IEqualityComparer<T> verwendet.Initializes a new instance of the Dictionary<TKey,TValue> class that contains elements copied from the specified IDictionary<TKey,TValue> and uses the specified IEqualityComparer<T>.

Dictionary<TKey,TValue>(IEnumerable<KeyValuePair<TKey,TValue>>, IEqualityComparer<TKey>)

Initialisiert eine neue Instanz der Dictionary<TKey,TValue>-Klasse, die aus dem angegebenen IEnumerable<T> kopierte Elemente enthält und den angegebenen IEqualityComparer<T> verwendet.Initializes a new instance of the Dictionary<TKey,TValue> class that contains elements copied from the specified IEnumerable<T> and uses the specified IEqualityComparer<T>.

Dictionary<TKey,TValue>(Int32, IEqualityComparer<TKey>)

Initialisiert eine neue, leere Instanz der Dictionary<TKey,TValue>-Klasse mit der angegebenen Anfangskapazität und dem angegebenen IEqualityComparer<T>.Initializes a new instance of the Dictionary<TKey,TValue> class that is empty, has the specified initial capacity, and uses the specified IEqualityComparer<T>.

Dictionary<TKey,TValue>(SerializationInfo, StreamingContext)

Initialisiert eine neue Instanz der Dictionary<TKey,TValue>-Klasse mit serialisierten Daten.Initializes a new instance of the Dictionary<TKey,TValue> class with serialized data.

Dictionary<TKey,TValue>()

Initialisiert eine neue, leere Instanz der Dictionary<TKey,TValue>-Klasse mit der Standardanfangskapazität, wobei der Standardgleichheitsvergleich für den Schlüsseltyp verwendet wird.Initializes a new instance of the Dictionary<TKey,TValue> class that is empty, has the default initial capacity, and uses the default equality comparer for the key type.

public:
 Dictionary();
public Dictionary ();
Public Sub New ()

Beispiele

Im folgenden Codebeispiel wird eine leere Dictionary<TKey,TValue> Zeichenfolge mit Zeichen folgen Schlüsseln erstellt, und die-Methode wird verwendet Add , um einige Elemente hinzuzufügen.The following code example creates an empty Dictionary<TKey,TValue> of strings with string keys and uses the Add method to add some elements. Das Beispiel zeigt, dass die- Add Methode eine auslöst, ArgumentException Wenn versucht wird, einen doppelten Schlüssel hinzuzufügen.The example demonstrates that the Add method throws an ArgumentException when attempting to add a duplicate key.

Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die-Klasse bereitgestellt wird Dictionary<TKey,TValue> .This code example is part of a larger example provided for the Dictionary<TKey,TValue> class.

// Create a new dictionary of strings, with string keys.
//
Dictionary<String^, String^>^ openWith =
    gcnew Dictionary<String^, String^>();

// Add some elements to the dictionary. There are no
// duplicate keys, but some of the values are duplicates.
openWith->Add("txt", "notepad.exe");
openWith->Add("bmp", "paint.exe");
openWith->Add("dib", "paint.exe");
openWith->Add("rtf", "wordpad.exe");

// The Add method throws an exception if the new key is
// already in the dictionary.
try
{
    openWith->Add("txt", "winword.exe");
}
catch (ArgumentException^)
{
    Console::WriteLine("An element with Key = \"txt\" already exists.");
}
// Create a new dictionary of strings, with string keys.
//
Dictionary<string, string> openWith =
    new Dictionary<string, string>();

// Add some elements to the dictionary. There are no
// duplicate keys, but some of the values are duplicates.
openWith.Add("txt", "notepad.exe");
openWith.Add("bmp", "paint.exe");
openWith.Add("dib", "paint.exe");
openWith.Add("rtf", "wordpad.exe");

// The Add method throws an exception if the new key is
// already in the dictionary.
try
{
    openWith.Add("txt", "winword.exe");
}
catch (ArgumentException)
{
    Console.WriteLine("An element with Key = \"txt\" already exists.");
}
' Create a new dictionary of strings, with string keys.
'
Dim openWith As New Dictionary(Of String, String)

' Add some elements to the dictionary. There are no 
' duplicate keys, but some of the values are duplicates.
openWith.Add("txt", "notepad.exe")
openWith.Add("bmp", "paint.exe")
openWith.Add("dib", "paint.exe")
openWith.Add("rtf", "wordpad.exe")

' The Add method throws an exception if the new key is 
' already in the dictionary.
Try
    openWith.Add("txt", "winword.exe")
Catch 
    Console.WriteLine("An element with Key = ""txt"" already exists.")
End Try

Hinweise

Jeder Schlüssel in einem Dictionary<TKey,TValue> muss gemäß dem Standard Gleichheits Vergleich eindeutig sein.Every key in a Dictionary<TKey,TValue> must be unique according to the default equality comparer.

Dictionary<TKey,TValue>erfordert eine Gleichheits Implementierung, um zu bestimmen, ob Schlüssel gleich sind.Dictionary<TKey,TValue> requires an equality implementation to determine whether keys are equal. Dieser Konstruktor verwendet den generischen Standard Gleichheits Vergleich EqualityComparer<T>.Default .This constructor uses the default generic equality comparer, EqualityComparer<T>.Default. Wenn TKey der Typ die System.IEquatable<T> generische Schnittstelle implementiert, verwendet der Standard Gleichheits Vergleich diese Implementierung.If type TKey implements the System.IEquatable<T> generic interface, the default equality comparer uses that implementation. Alternativ können Sie eine Implementierung der IEqualityComparer<T> generischen-Schnittstelle angeben, indem Sie einen Konstruktor verwenden, der einen- comparer Parameter akzeptiert.Alternatively, you can specify an implementation of the IEqualityComparer<T> generic interface by using a constructor that accepts a comparer parameter.

Hinweis

Wenn Sie die Größe der Auflistung schätzen können, ist es bei der Verwendung eines Konstruktors, der die anfängliche Kapazität angibt, nicht mehr erforderlich, beim Hinzufügen von Elementen zur Größenänderung auszuführen Dictionary<TKey,TValue> .If you can estimate the size of the collection, using a constructor that specifies the initial capacity eliminates the need to perform a number of resizing operations while adding elements to the Dictionary<TKey,TValue>.

Dieser Konstruktor ist ein O (1)-Vorgang.This constructor is an O(1) operation.

Weitere Informationen

Dictionary<TKey,TValue>(IDictionary<TKey,TValue>)

Initialisiert eine neue Instanz der Dictionary<TKey,TValue>-Klasse, die aus dem angegebenen IDictionary<TKey,TValue> kopierte Elemente enthält und den Standardgleichheitsvergleich für den Schlüsseltyp verwendet.Initializes a new instance of the Dictionary<TKey,TValue> class that contains elements copied from the specified IDictionary<TKey,TValue> and uses the default equality comparer for the key type.

public:
 Dictionary(System::Collections::Generic::IDictionary<TKey, TValue> ^ dictionary);
public Dictionary (System.Collections.Generic.IDictionary<TKey,TValue> dictionary);
new System.Collections.Generic.Dictionary<'Key, 'Value> : System.Collections.Generic.IDictionary<'Key, 'Value> -> System.Collections.Generic.Dictionary<'Key, 'Value>
Public Sub New (dictionary As IDictionary(Of TKey, TValue))

Parameter

dictionary
IDictionary<TKey,TValue>

Das IDictionary<TKey,TValue>, dessen Elemente in das neue Dictionary<TKey,TValue> kopiert werden.The IDictionary<TKey,TValue> whose elements are copied to the new Dictionary<TKey,TValue>.

Ausnahmen

dictionary ist null.dictionary is null.

dictionary enthält mindestens einen doppelten Schlüssel.dictionary contains one or more duplicate keys.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie der- Dictionary<TKey,TValue>(IEqualityComparer<TKey>) Konstruktor verwendet wird, um eine Dictionary<TKey,TValue> mit sortiertem Inhalt aus einem anderen Wörterbuch zu initialisierenThe following code example shows how to use the Dictionary<TKey,TValue>(IEqualityComparer<TKey>) constructor to initialize a Dictionary<TKey,TValue> with sorted content from another dictionary. Im Codebeispiel wird ein erstellt SortedDictionary<TKey,TValue> und mit Daten in zufälliger Reihenfolge aufgefüllt. Anschließend wird der SortedDictionary<TKey,TValue> an den- Dictionary<TKey,TValue>(IEqualityComparer<TKey>) Konstruktor übergeben, wodurch eine Dictionary<TKey,TValue> sortiert wird.The code example creates a SortedDictionary<TKey,TValue> and populates it with data in random order, then passes the SortedDictionary<TKey,TValue> to the Dictionary<TKey,TValue>(IEqualityComparer<TKey>) constructor, creating a Dictionary<TKey,TValue> that is sorted. Dies ist hilfreich, wenn Sie ein sortiertes Wörterbuch erstellen müssen, das zu einem bestimmten Zeitpunkt statisch wird. Wenn Sie die Daten aus einem SortedDictionary<TKey,TValue> in einen kopieren, wird die Dictionary<TKey,TValue> Abruf Geschwindigkeit verbessert.This is useful if you need to build a sorted dictionary that at some point becomes static; copying the data from a SortedDictionary<TKey,TValue> to a Dictionary<TKey,TValue> improves retrieval speed.

using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create a new sorted dictionary of strings, with string
        // keys.
        SortedDictionary<string, string> openWith =
            new SortedDictionary<string, string>();

        // Add some elements to the dictionary.
        openWith.Add("txt", "notepad.exe");
        openWith.Add("bmp", "paint.exe");
        openWith.Add("dib", "paint.exe");
        openWith.Add("rtf", "wordpad.exe");

        // Create a Dictionary of strings with string keys, and
        // initialize it with the contents of the sorted dictionary.
        Dictionary<string, string> copy =
            new Dictionary<string, string>(openWith);

        // List the contents of the copy.
        Console.WriteLine();
        foreach( KeyValuePair<string, string> kvp in copy )
        {
            Console.WriteLine("Key = {0}, Value = {1}",
               kvp.Key, kvp.Value);
        }
    }
}

/* This code example produces the following output:

Key = bmp, Value = paint.exe
Key = dib, Value = paint.exe
Key = rtf, Value = wordpad.exe
Key = txt, Value = notepad.exe
 */
Imports System.Collections.Generic

Public Class Example
    
    Public Shared Sub Main() 

        ' Create a new sorted dictionary of strings, with string 
        ' keys.
        Dim openWith As New SortedDictionary(Of String, String)
        
        ' Add some elements to the sorted dictionary. 
        openWith.Add("txt", "notepad.exe")
        openWith.Add("bmp", "paint.exe")
        openWith.Add("dib", "paint.exe")
        openWith.Add("rtf", "wordpad.exe")
        
        ' Create a Dictionary of strings with string keys, and 
        ' initialize it with the contents of the sorted dictionary.
        Dim copy As New Dictionary(Of String, String)(openWith)

        ' List the contents of the copy.
        Console.WriteLine()
        For Each kvp As KeyValuePair(Of String, String) In copy
            Console.WriteLine("Key = {0}, Value = {1}", _
                kvp.Key, kvp.Value)
        Next kvp

    End Sub

End Class

' This code example produces the following output:
'
'Key = bmp, Value = paint.exe
'Key = dib, Value = paint.exe
'Key = rtf, Value = wordpad.exe
'Key = txt, Value = notepad.exe

Hinweise

Jeder Schlüssel in einem Dictionary<TKey,TValue> muss gemäß dem Standard Gleichheits Vergleich eindeutig sein. ebenso muss jeder Schlüssel in der Quelle dictionary entsprechend dem Standard Gleichheits Vergleich eindeutig sein.Every key in a Dictionary<TKey,TValue> must be unique according to the default equality comparer; likewise, every key in the source dictionary must also be unique according to the default equality comparer.

Die Anfangskapazität der neuen Dictionary<TKey,TValue> ist groß genug, um alle Elemente in zu enthalten dictionary .The initial capacity of the new Dictionary<TKey,TValue> is large enough to contain all the elements in dictionary.

Dictionary<TKey,TValue>erfordert eine Gleichheits Implementierung, um zu bestimmen, ob Schlüssel gleich sind.Dictionary<TKey,TValue> requires an equality implementation to determine whether keys are equal. Dieser Konstruktor verwendet den generischen Standard Gleichheits Vergleich EqualityComparer<T>.Default .This constructor uses the default generic equality comparer, EqualityComparer<T>.Default. Wenn TKey der Typ die System.IEquatable<T> generische Schnittstelle implementiert, verwendet der Standard Gleichheits Vergleich diese Implementierung.If type TKey implements the System.IEquatable<T> generic interface, the default equality comparer uses that implementation. Alternativ können Sie eine Implementierung der IEqualityComparer<T> generischen-Schnittstelle angeben, indem Sie einen Konstruktor verwenden, der einen- comparer Parameter akzeptiert.Alternatively, you can specify an implementation of the IEqualityComparer<T> generic interface by using a constructor that accepts a comparer parameter.

Dieser Konstruktor ist ein O (n)-Vorgang, wobei n die Anzahl der Elemente in ist dictionary .This constructor is an O(n) operation, where n is the number of elements in dictionary.

Weitere Informationen

Dictionary<TKey,TValue>(IEnumerable<KeyValuePair<TKey,TValue>>)

Initialisiert eine neue Instanz der- Dictionary<TKey,TValue> Klasse, die aus dem angegebenen kopierte Elemente enthält IEnumerable<T> .Initializes a new instance of the Dictionary<TKey,TValue> class that contains elements copied from the specified IEnumerable<T>.

public:
 Dictionary(System::Collections::Generic::IEnumerable<System::Collections::Generic::KeyValuePair<TKey, TValue>> ^ collection);
public Dictionary (System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<TKey,TValue>>? collection);
public Dictionary (System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<TKey,TValue>> collection);
new System.Collections.Generic.Dictionary<'Key, 'Value> : seq<System.Collections.Generic.KeyValuePair<'Key, 'Value>> -> System.Collections.Generic.Dictionary<'Key, 'Value>
Public Sub New (collection As IEnumerable(Of KeyValuePair(Of TKey, TValue)))

Parameter

collection
IEnumerable<KeyValuePair<TKey,TValue>>

Die IEnumerable<T> , deren Elemente in die neue kopiert werden Dictionary<TKey,TValue> .The IEnumerable<T> whose elements are copied to the new Dictionary<TKey,TValue>.

Ausnahmen

collection ist null.collection is null.

collectionenthält mindestens einen doppelten Schlüssel.collection contains one or more duplicated keys.

Dictionary<TKey,TValue>(IEqualityComparer<TKey>)

Initialisiert eine neue, leere Instanz der Dictionary<TKey,TValue>-Klasse mit der Standardanfangskapazität und dem angegebenen IEqualityComparer<T>.Initializes a new instance of the Dictionary<TKey,TValue> class that is empty, has the default initial capacity, and uses the specified IEqualityComparer<T>.

public:
 Dictionary(System::Collections::Generic::IEqualityComparer<TKey> ^ comparer);
public Dictionary (System.Collections.Generic.IEqualityComparer<TKey> comparer);
public Dictionary (System.Collections.Generic.IEqualityComparer<TKey>? comparer);
new System.Collections.Generic.Dictionary<'Key, 'Value> : System.Collections.Generic.IEqualityComparer<'Key> -> System.Collections.Generic.Dictionary<'Key, 'Value>
Public Sub New (comparer As IEqualityComparer(Of TKey))

Parameter

comparer
IEqualityComparer<TKey>

Die IEqualityComparer<T>-Implementierung, die zum Vergleichen von Schlüsseln verwendet werden soll, oder null, wenn der Standard-EqualityComparer<T> für diesen Schlüsseltyp verwendet werden soll.The IEqualityComparer<T> implementation to use when comparing keys, or null to use the default EqualityComparer<T> for the type of the key.

Beispiele

Im folgenden Codebeispiel wird ein Dictionary<TKey,TValue> -Objekt mit einem Gleichheits Vergleich ohne Beachtung der aktuellen Kultur erstellt.The following code example creates a Dictionary<TKey,TValue> with a case-insensitive equality comparer for the current culture. Im Beispiel werden vier-Elemente, einige mit Kleinbuchstaben und einige mit Großbuchstaben, hinzugefügt.The example adds four elements, some with lower-case keys and some with upper-case keys. Im Beispiel wird dann versucht, ein Element mit einem Schlüssel hinzuzufügen, der sich von einem vorhandenen Schlüssel nur in der Groß-/Kleinschreibung unterscheidet, die resultierende Ausnahme abfängt und eine Fehlermeldung anzeigt.The example then attempts to add an element with a key that differs from an existing key only by case, catches the resulting exception, and displays an error message. Zum Schluss zeigt das Beispiel die Elemente im Wörterbuch an.Finally, the example displays the elements in the dictionary.

using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create a new Dictionary of strings, with string keys
        // and a case-insensitive comparer for the current culture.
        Dictionary<string, string> openWith =
                      new Dictionary<string, string>(
                          StringComparer.CurrentCultureIgnoreCase);

        // Add some elements to the dictionary.
        openWith.Add("txt", "notepad.exe");
        openWith.Add("bmp", "paint.exe");
        openWith.Add("DIB", "paint.exe");
        openWith.Add("rtf", "wordpad.exe");

        // Try to add a fifth element with a key that is the same
        // except for case; this would be allowed with the default
        // comparer.
        try
        {
            openWith.Add("BMP", "paint.exe");
        }
        catch (ArgumentException)
        {
            Console.WriteLine("\nBMP is already in the dictionary.");
        }

        // List the contents of the sorted dictionary.
        Console.WriteLine();
        foreach( KeyValuePair<string, string> kvp in openWith )
        {
            Console.WriteLine("Key = {0}, Value = {1}", kvp.Key,
                kvp.Value);
        }
    }
}

/* This code example produces the following output:

BMP is already in the dictionary.

Key = txt, Value = notepad.exe
Key = bmp, Value = paint.exe
Key = DIB, Value = paint.exe
Key = rtf, Value = wordpad.exe
 */
Imports System.Collections.Generic

Public Class Example
    
    Public Shared Sub Main() 

        ' Create a new Dictionary of strings, with string keys 
        ' and a case-insensitive comparer for the current culture.
        Dim openWith As New Dictionary(Of String, String)( _
            StringComparer.CurrentCultureIgnoreCase)
        
        ' Add some elements to the dictionary. 
        openWith.Add("txt", "notepad.exe")
        openWith.Add("bmp", "paint.exe")
        openWith.Add("DIB", "paint.exe")
        openWith.Add("rtf", "wordpad.exe")

        ' Try to add a fifth element with a key that is the same 
        ' except for case; this would be allowed with the default
        ' comparer.
        Try
            openWith.Add("BMP", "paint.exe")
        Catch ex As ArgumentException
            Console.WriteLine(vbLf & "BMP is already in the dictionary.")
        End Try
        
        ' List the contents of the dictionary.
        Console.WriteLine()
        For Each kvp As KeyValuePair(Of String, String) In openWith
            Console.WriteLine("Key = {0}, Value = {1}", _
                kvp.Key, kvp.Value)
        Next kvp

    End Sub

End Class

' This code example produces the following output:
'
'BMP is already in the dictionary.
'
'Key = txt, Value = notepad.exe
'Key = bmp, Value = paint.exe
'Key = DIB, Value = paint.exe
'Key = rtf, Value = wordpad.exe

Hinweise

Verwenden Sie diesen Konstruktor mit den von der-Klasse bereitgestellten Zeichen folgen vergleichen, bei denen die Groß-/Kleinschreibung nicht beachtet wird StringComparer , um Wörterbücher zu erstellenUse this constructor with the case-insensitive string comparers provided by the StringComparer class to create dictionaries with case-insensitive string keys.

Jeder Schlüssel in einem Dictionary<TKey,TValue> muss gemäß dem angegebenen Comparer eindeutig sein.Every key in a Dictionary<TKey,TValue> must be unique according to the specified comparer.

Dictionary<TKey,TValue>erfordert eine Gleichheits Implementierung, um zu bestimmen, ob Schlüssel gleich sind.Dictionary<TKey,TValue> requires an equality implementation to determine whether keys are equal. Wenn comparer ist null , verwendet dieser Konstruktor den generischen Standard Gleichheits Vergleich EqualityComparer<T>.Default .If comparer is null, this constructor uses the default generic equality comparer, EqualityComparer<T>.Default. Wenn TKey der Typ die System.IEquatable<T> generische Schnittstelle implementiert, verwendet der Standard Gleichheits Vergleich diese Implementierung.If type TKey implements the System.IEquatable<T> generic interface, the default equality comparer uses that implementation.

Hinweis

Wenn Sie die Größe der Auflistung schätzen können, ist es bei der Verwendung eines Konstruktors, der die anfängliche Kapazität angibt, nicht mehr erforderlich, beim Hinzufügen von Elementen zur Größenänderung auszuführen Dictionary<TKey,TValue> .If you can estimate the size of the collection, using a constructor that specifies the initial capacity eliminates the need to perform a number of resizing operations while adding elements to the Dictionary<TKey,TValue>.

Dieser Konstruktor ist ein O (1)-Vorgang.This constructor is an O(1) operation.

Weitere Informationen

Dictionary<TKey,TValue>(Int32)

Initialisiert eine neue, leere Instanz der Dictionary<TKey,TValue>-Klasse mit der Standardanfangskapazität, wobei der Standardgleichheitsvergleich für den Schlüsseltyp verwendet wird.Initializes a new instance of the Dictionary<TKey,TValue> class that is empty, has the specified initial capacity, and uses the default equality comparer for the key type.

public:
 Dictionary(int capacity);
public Dictionary (int capacity);
new System.Collections.Generic.Dictionary<'Key, 'Value> : int -> System.Collections.Generic.Dictionary<'Key, 'Value>
Public Sub New (capacity As Integer)

Parameter

capacity
Int32

Die anfängliche Anzahl von Elementen, die das Dictionary<TKey,TValue> enthalten kann.The initial number of elements that the Dictionary<TKey,TValue> can contain.

Ausnahmen

capacity ist kleiner als 0.capacity is less than 0.

Beispiele

Im folgenden Codebeispiel wird ein Wörterbuch mit einer Anfangskapazität von 4 erstellt und mit 4 Einträgen aufgefüllt.The following code example creates a dictionary with an initial capacity of 4 and populates it with 4 entries.

using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create a new dictionary of strings, with string keys and
        // an initial capacity of 4.
        Dictionary<string, string> openWith =
                               new Dictionary<string, string>(4);

        // Add 4 elements to the dictionary.
        openWith.Add("txt", "notepad.exe");
        openWith.Add("bmp", "paint.exe");
        openWith.Add("dib", "paint.exe");
        openWith.Add("rtf", "wordpad.exe");

        // List the contents of the dictionary.
        Console.WriteLine();
        foreach( KeyValuePair<string, string> kvp in openWith )
        {
            Console.WriteLine("Key = {0}, Value = {1}",
               kvp.Key, kvp.Value);
        }
    }
}

/* This code example produces the following output:

Key = txt, Value = notepad.exe
Key = bmp, Value = paint.exe
Key = dib, Value = paint.exe
Key = rtf, Value = wordpad.exe
 */
Imports System.Collections.Generic

Public Class Example
    
    Public Shared Sub Main() 

        ' Create a new dictionary of strings, with string keys and
        ' an initial capacity of 4.
        Dim openWith As New Dictionary(Of String, String)(4)
        
        ' Add 4 elements to the dictionary. 
        openWith.Add("txt", "notepad.exe")
        openWith.Add("bmp", "paint.exe")
        openWith.Add("dib", "paint.exe")
        openWith.Add("rtf", "wordpad.exe")
        
        ' List the contents of the dictionary.
        Console.WriteLine()
        For Each kvp As KeyValuePair(Of String, String) In openWith
            Console.WriteLine("Key = {0}, Value = {1}", _
                kvp.Key, kvp.Value)
        Next kvp

    End Sub

End Class

' This code example produces the following output:
'
'Key = txt, Value = notepad.exe
'Key = bmp, Value = paint.exe
'Key = dib, Value = paint.exe
'Key = rtf, Value = wordpad.exe

Hinweise

Jeder Schlüssel in einem Dictionary<TKey,TValue> muss gemäß dem Standard Gleichheits Vergleich eindeutig sein.Every key in a Dictionary<TKey,TValue> must be unique according to the default equality comparer.

Die Kapazität eines Dictionary<TKey,TValue> ist die Anzahl der Elemente, die der hinzugefügt werden können, bevor die Größe geändert werden kann Dictionary<TKey,TValue> .The capacity of a Dictionary<TKey,TValue> is the number of elements that can be added to the Dictionary<TKey,TValue> before resizing is necessary. Wenn Elemente zu einem hinzugefügt werden Dictionary<TKey,TValue> , wird die Kapazität bei Bedarf automatisch erhöht, indem das interne Array neu zugewiesen wird.As elements are added to a Dictionary<TKey,TValue>, the capacity is automatically increased as required by reallocating the internal array.

Wenn die Größe der Auflistung geschätzt werden kann, entfällt beim Angeben der anfänglichen Kapazität das Ausführen einer Reihe von Größenänderung beim Hinzufügen von Elementen zum Dictionary<TKey,TValue> .If the size of the collection can be estimated, specifying the initial capacity eliminates the need to perform a number of resizing operations while adding elements to the Dictionary<TKey,TValue>.

Dictionary<TKey,TValue>erfordert eine Gleichheits Implementierung, um zu bestimmen, ob Schlüssel gleich sind.Dictionary<TKey,TValue> requires an equality implementation to determine whether keys are equal. Dieser Konstruktor verwendet den generischen Standard Gleichheits Vergleich EqualityComparer<T>.Default .This constructor uses the default generic equality comparer, EqualityComparer<T>.Default. Wenn TKey der Typ die System.IEquatable<T> generische Schnittstelle implementiert, verwendet der Standard Gleichheits Vergleich diese Implementierung.If type TKey implements the System.IEquatable<T> generic interface, the default equality comparer uses that implementation. Alternativ können Sie eine Implementierung der IEqualityComparer<T> generischen-Schnittstelle angeben, indem Sie einen Konstruktor verwenden, der einen- comparer Parameter akzeptiert.Alternatively, you can specify an implementation of the IEqualityComparer<T> generic interface by using a constructor that accepts a comparer parameter.

Dieser Konstruktor ist ein O (1)-Vorgang.This constructor is an O(1) operation.

Weitere Informationen

Dictionary<TKey,TValue>(IDictionary<TKey,TValue>, IEqualityComparer<TKey>)

Initialisiert eine neue Instanz der Dictionary<TKey,TValue>-Klasse, die aus dem angegebenen IDictionary<TKey,TValue> kopierte Elemente enthält und den angegebenen IEqualityComparer<T> verwendet.Initializes a new instance of the Dictionary<TKey,TValue> class that contains elements copied from the specified IDictionary<TKey,TValue> and uses the specified IEqualityComparer<T>.

public:
 Dictionary(System::Collections::Generic::IDictionary<TKey, TValue> ^ dictionary, System::Collections::Generic::IEqualityComparer<TKey> ^ comparer);
public Dictionary (System.Collections.Generic.IDictionary<TKey,TValue> dictionary, System.Collections.Generic.IEqualityComparer<TKey> comparer);
public Dictionary (System.Collections.Generic.IDictionary<TKey,TValue> dictionary, System.Collections.Generic.IEqualityComparer<TKey>? comparer);
new System.Collections.Generic.Dictionary<'Key, 'Value> : System.Collections.Generic.IDictionary<'Key, 'Value> * System.Collections.Generic.IEqualityComparer<'Key> -> System.Collections.Generic.Dictionary<'Key, 'Value>
Public Sub New (dictionary As IDictionary(Of TKey, TValue), comparer As IEqualityComparer(Of TKey))

Parameter

dictionary
IDictionary<TKey,TValue>

Das IDictionary<TKey,TValue>, dessen Elemente in das neue Dictionary<TKey,TValue> kopiert werden.The IDictionary<TKey,TValue> whose elements are copied to the new Dictionary<TKey,TValue>.

comparer
IEqualityComparer<TKey>

Die IEqualityComparer<T>-Implementierung, die zum Vergleichen von Schlüsseln verwendet werden soll, oder null, wenn der Standard-EqualityComparer<T> für diesen Schlüsseltyp verwendet werden soll.The IEqualityComparer<T> implementation to use when comparing keys, or null to use the default EqualityComparer<T> for the type of the key.

Ausnahmen

dictionary ist null.dictionary is null.

dictionary enthält mindestens einen doppelten Schlüssel.dictionary contains one or more duplicate keys.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie der- Dictionary<TKey,TValue>(IDictionary<TKey,TValue>, IEqualityComparer<TKey>) Konstruktor verwendet wird, um einen ohne Beachtung Dictionary<TKey,TValue> der Groß-/Kleinschreibung in einem anderen Wörterbuch zu initialisieren.The following code example shows how to use the Dictionary<TKey,TValue>(IDictionary<TKey,TValue>, IEqualityComparer<TKey>) constructor to initialize a Dictionary<TKey,TValue> with case-insensitive sorted content from another dictionary. Im Codebeispiel wird ein-Objekt erstellt, bei dem die Groß-/Kleinschreibung nicht beachtet wird, SortedDictionary<TKey,TValue> und es wird mit Daten in zufälliger Reihenfolge aufgefüllt. Anschließend wird das SortedDictionary<TKey,TValue> -Objekt an den- Dictionary<TKey,TValue>(IDictionary<TKey,TValue>, IEqualityComparer<TKey>) Konstruktor übergeben, zusammen mit einem Gleichheits Vergleich ohne Beachtung der Groß-/Kleinschreibung Dictionary<TKey,TValue>The code example creates a SortedDictionary<TKey,TValue> with a case-insensitive comparer and populates it with data in random order, then passes the SortedDictionary<TKey,TValue> to the Dictionary<TKey,TValue>(IDictionary<TKey,TValue>, IEqualityComparer<TKey>) constructor, along with a case-insensitive equality comparer, creating a Dictionary<TKey,TValue> that is sorted. Dies ist hilfreich, wenn Sie ein sortiertes Wörterbuch erstellen müssen, das zu einem bestimmten Zeitpunkt statisch wird. Wenn Sie die Daten aus einem SortedDictionary<TKey,TValue> in einen kopieren, wird die Dictionary<TKey,TValue> Abruf Geschwindigkeit verbessert.This is useful if you need to build a sorted dictionary that at some point becomes static; copying the data from a SortedDictionary<TKey,TValue> to a Dictionary<TKey,TValue> improves retrieval speed.

Hinweis

Wenn Sie ein neues Wörterbuch ohne Beachtung der Groß-/Kleinschreibung erstellen und es mit Einträgen aus einem Wörterbuch auffüllen, das einen Vergleich unter Berücksichtigung der Groß-und Kleinschreibung verwendet, wird eine Ausnahme ausgelöst, wenn das Eingabe Wörterbuch Schlüssel enthält, die sich nur in der Groß-/Kleinschreibung unterscheidenWhen you create a new dictionary with a case-insensitive comparer and populate it with entries from a dictionary that uses a case-sensitive comparer, as in this example, an exception occurs if the input dictionary has keys that differ only by case.

using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create a new sorted dictionary of strings, with string
        // keys and a case-insensitive comparer.
        SortedDictionary<string, string> openWith =
                new SortedDictionary<string, string>(
                    StringComparer.CurrentCultureIgnoreCase);

        // Add some elements to the dictionary.
        openWith.Add("txt", "notepad.exe");
        openWith.Add("Bmp", "paint.exe");
        openWith.Add("DIB", "paint.exe");
        openWith.Add("rtf", "wordpad.exe");

        // Create a Dictionary of strings with string keys and a
        // case-insensitive equality comparer, and initialize it
        // with the contents of the sorted dictionary.
        Dictionary<string, string> copy =
                new Dictionary<string, string>(openWith,
                    StringComparer.CurrentCultureIgnoreCase);

        // List the contents of the copy.
        Console.WriteLine();
        foreach( KeyValuePair<string, string> kvp in copy )
        {
            Console.WriteLine("Key = {0}, Value = {1}",
               kvp.Key, kvp.Value);
        }
    }
}

/* This code example produces the following output:

Key = Bmp, Value = paint.exe
Key = DIB, Value = paint.exe
Key = rtf, Value = wordpad.exe
Key = txt, Value = notepad.exe
 */
Imports System.Collections.Generic

Public Class Example
    
    Public Shared Sub Main() 

        ' Create a new sorted dictionary of strings, with string 
        ' keys and a case-insensitive comparer.
        Dim openWith As New SortedDictionary(Of String, String)( _
            StringComparer.CurrentCultureIgnoreCase)
        
        ' Add some elements to the sorted dictionary. 
        openWith.Add("txt", "notepad.exe")
        openWith.Add("Bmp", "paint.exe")
        openWith.Add("DIB", "paint.exe")
        openWith.Add("rtf", "wordpad.exe")
        
        ' Create a Dictionary of strings with string keys and a 
        ' case-insensitive equality comparer, and initialize it
        ' with the contents of the sorted dictionary.
        Dim copy As New Dictionary(Of String, String)(openWith, _
            StringComparer.CurrentCultureIgnoreCase)

        ' List the contents of the copy.
        Console.WriteLine()
        For Each kvp As KeyValuePair(Of String, String) In copy
            Console.WriteLine("Key = {0}, Value = {1}", _
                kvp.Key, kvp.Value)
        Next kvp

    End Sub

End Class

' This code example produces the following output:
'
'Key = Bmp, Value = paint.exe
'Key = DIB, Value = paint.exe
'Key = rtf, Value = wordpad.exe
'Key = txt, Value = notepad.exe

Hinweise

Verwenden Sie diesen Konstruktor mit den von der-Klasse bereitgestellten Zeichen folgen vergleichen, bei denen die Groß-/Kleinschreibung nicht beachtet wird StringComparer , um Wörterbücher zu erstellenUse this constructor with the case-insensitive string comparers provided by the StringComparer class to create dictionaries with case-insensitive string keys.

Jeder Schlüssel in einem Dictionary<TKey,TValue> muss gemäß dem angegebenen Comparer eindeutig sein. ebenso muss jeder Schlüssel in der Quelle dictionary entsprechend dem angegebenen Vergleich eindeutig sein.Every key in a Dictionary<TKey,TValue> must be unique according to the specified comparer; likewise, every key in the source dictionary must also be unique according to the specified comparer.

Hinweis

Doppelte Schlüssel können z. b. auftreten, wenn der von comparer der-Klasse bereitgestellte Zeichen folgen Vergleich ohne Berücksichtigung der Groß-/Kleinschreibung nicht beachtet wird StringComparer und dictionary kein groß-und Kleinschreibung beachtet wird.For example, duplicate keys can occur if comparer is one of the case-insensitive string comparers provided by the StringComparer class and dictionary does not use a case-insensitive comparer key.

Die Anfangskapazität der neuen Dictionary<TKey,TValue> ist groß genug, um alle Elemente in zu enthalten dictionary .The initial capacity of the new Dictionary<TKey,TValue> is large enough to contain all the elements in dictionary.

Dictionary<TKey,TValue>erfordert eine Gleichheits Implementierung, um zu bestimmen, ob Schlüssel gleich sind.Dictionary<TKey,TValue> requires an equality implementation to determine whether keys are equal. Wenn comparer ist null , verwendet dieser Konstruktor den generischen Standard Gleichheits Vergleich EqualityComparer<T>.Default .If comparer is null, this constructor uses the default generic equality comparer, EqualityComparer<T>.Default. Wenn TKey der Typ die System.IEquatable<T> generische Schnittstelle implementiert, verwendet der Standard Gleichheits Vergleich diese Implementierung.If type TKey implements the System.IEquatable<T> generic interface, the default equality comparer uses that implementation.

Dieser Konstruktor ist ein O ( n )-Vorgang, wobei n die Anzahl der Elemente in ist dictionary .This constructor is an O(n) operation, where n is the number of elements in dictionary.

Weitere Informationen

Dictionary<TKey,TValue>(IEnumerable<KeyValuePair<TKey,TValue>>, IEqualityComparer<TKey>)

Initialisiert eine neue Instanz der Dictionary<TKey,TValue>-Klasse, die aus dem angegebenen IEnumerable<T> kopierte Elemente enthält und den angegebenen IEqualityComparer<T> verwendet.Initializes a new instance of the Dictionary<TKey,TValue> class that contains elements copied from the specified IEnumerable<T> and uses the specified IEqualityComparer<T>.

public:
 Dictionary(System::Collections::Generic::IEnumerable<System::Collections::Generic::KeyValuePair<TKey, TValue>> ^ collection, System::Collections::Generic::IEqualityComparer<TKey> ^ comparer);
public Dictionary (System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<TKey,TValue>>? collection, System.Collections.Generic.IEqualityComparer<TKey>? comparer);
public Dictionary (System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<TKey,TValue>> collection, System.Collections.Generic.IEqualityComparer<TKey> comparer);
new System.Collections.Generic.Dictionary<'Key, 'Value> : seq<System.Collections.Generic.KeyValuePair<'Key, 'Value>> * System.Collections.Generic.IEqualityComparer<'Key> -> System.Collections.Generic.Dictionary<'Key, 'Value>
Public Sub New (collection As IEnumerable(Of KeyValuePair(Of TKey, TValue)), comparer As IEqualityComparer(Of TKey))

Parameter

collection
IEnumerable<KeyValuePair<TKey,TValue>>

Das IEnumerable<T>, dessen Elemente in das neue Dictionary<TKey,TValue> kopiert werden.The IEnumerable<T> whose elements are copied to the new Dictionary<TKey,TValue>.

comparer
IEqualityComparer<TKey>

Die IEqualityComparer<T>-Implementierung, die zum Vergleichen von Schlüsseln verwendet werden soll, oder null, wenn der Standard-EqualityComparer<T> für diesen Schlüsseltyp verwendet werden soll.The IEqualityComparer<T> implementation to use when comparing keys, or null to use the default EqualityComparer<T> for the type of the key.

Ausnahmen

collection ist null.collection is null.

collectionenthält mindestens einen doppelten Schlüssel.collection contains one or more duplicated keys.

Dictionary<TKey,TValue>(Int32, IEqualityComparer<TKey>)

Initialisiert eine neue, leere Instanz der Dictionary<TKey,TValue>-Klasse mit der angegebenen Anfangskapazität und dem angegebenen IEqualityComparer<T>.Initializes a new instance of the Dictionary<TKey,TValue> class that is empty, has the specified initial capacity, and uses the specified IEqualityComparer<T>.

public:
 Dictionary(int capacity, System::Collections::Generic::IEqualityComparer<TKey> ^ comparer);
public Dictionary (int capacity, System.Collections.Generic.IEqualityComparer<TKey> comparer);
public Dictionary (int capacity, System.Collections.Generic.IEqualityComparer<TKey>? comparer);
new System.Collections.Generic.Dictionary<'Key, 'Value> : int * System.Collections.Generic.IEqualityComparer<'Key> -> System.Collections.Generic.Dictionary<'Key, 'Value>
Public Sub New (capacity As Integer, comparer As IEqualityComparer(Of TKey))

Parameter

capacity
Int32

Die anfängliche Anzahl von Elementen, die das Dictionary<TKey,TValue> enthalten kann.The initial number of elements that the Dictionary<TKey,TValue> can contain.

comparer
IEqualityComparer<TKey>

Die IEqualityComparer<T>-Implementierung, die zum Vergleichen von Schlüsseln verwendet werden soll, oder null, wenn der Standard-EqualityComparer<T> für diesen Schlüsseltyp verwendet werden soll.The IEqualityComparer<T> implementation to use when comparing keys, or null to use the default EqualityComparer<T> for the type of the key.

Ausnahmen

capacity ist kleiner als 0.capacity is less than 0.

Beispiele

Im folgenden Codebeispiel wird ein Dictionary<TKey,TValue> -Objekt mit einer Anfangskapazität von 5 und einem Gleichheits Vergleich ohne Beachtung der Groß-/Kleinschreibung für die aktuelle Kultur erstellt.The following code example creates a Dictionary<TKey,TValue> with an initial capacity of 5 and a case-insensitive equality comparer for the current culture. Im Beispiel werden vier-Elemente, einige mit Kleinbuchstaben und einige mit Großbuchstaben, hinzugefügt.The example adds four elements, some with lower-case keys and some with upper-case keys. Im Beispiel wird dann versucht, ein Element mit einem Schlüssel hinzuzufügen, der sich von einem vorhandenen Schlüssel nur in der Groß-/Kleinschreibung unterscheidet, die resultierende Ausnahme abfängt und eine Fehlermeldung anzeigt.The example then attempts to add an element with a key that differs from an existing key only by case, catches the resulting exception, and displays an error message. Zum Schluss zeigt das Beispiel die Elemente im Wörterbuch an.Finally, the example displays the elements in the dictionary.

using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create a new dictionary of strings, with string keys, an
        // initial capacity of 5, and a case-insensitive equality
        // comparer.
        Dictionary<string, string> openWith =
                      new Dictionary<string, string>(5,
                          StringComparer.CurrentCultureIgnoreCase);

        // Add 4 elements to the dictionary.
        openWith.Add("txt", "notepad.exe");
        openWith.Add("bmp", "paint.exe");
        openWith.Add("DIB", "paint.exe");
        openWith.Add("rtf", "wordpad.exe");

        // Try to add a fifth element with a key that is the same
        // except for case; this would be allowed with the default
        // comparer.
        try
        {
            openWith.Add("BMP", "paint.exe");
        }
        catch (ArgumentException)
        {
            Console.WriteLine("\nBMP is already in the dictionary.");
        }

        // List the contents of the dictionary.
        Console.WriteLine();
        foreach( KeyValuePair<string, string> kvp in openWith )
        {
            Console.WriteLine("Key = {0}, Value = {1}", kvp.Key,
                kvp.Value);
        }
    }
}

/* This code example produces the following output:

BMP is already in the dictionary.

Key = txt, Value = notepad.exe
Key = bmp, Value = paint.exe
Key = DIB, Value = paint.exe
Key = rtf, Value = wordpad.exe
 */
Imports System.Collections.Generic

Public Class Example
    
    Public Shared Sub Main() 

        ' Create a new Dictionary of strings, with string keys, an
        ' initial capacity of 5, and a case-insensitive equality
        ' comparer.
        Dim openWith As New Dictionary(Of String, String)(5, _
            StringComparer.CurrentCultureIgnoreCase)
        
        ' Add 4 elements to the dictionary. 
        openWith.Add("txt", "notepad.exe")
        openWith.Add("bmp", "paint.exe")
        openWith.Add("DIB", "paint.exe")
        openWith.Add("rtf", "wordpad.exe")

        ' Try to add a fifth element with a key that is the same 
        ' except for case; this would be allowed with the default
        ' comparer.
        Try
            openWith.Add("BMP", "paint.exe")
        Catch ex As ArgumentException
            Console.WriteLine(vbLf & "BMP is already in the dictionary.")
        End Try
        
        ' List the contents of the dictionary.
        Console.WriteLine()
        For Each kvp As KeyValuePair(Of String, String) In openWith
            Console.WriteLine("Key = {0}, Value = {1}", _
                kvp.Key, kvp.Value)
        Next kvp

    End Sub

End Class

' This code example produces the following output:
'
'BMP is already in the dictionary.
'
'Key = txt, Value = notepad.exe
'Key = bmp, Value = paint.exe
'Key = DIB, Value = paint.exe
'Key = rtf, Value = wordpad.exe

Hinweise

Verwenden Sie diesen Konstruktor mit den von der-Klasse bereitgestellten Zeichen folgen vergleichen, bei denen die Groß-/Kleinschreibung nicht beachtet wird StringComparer , um Wörterbücher zu erstellenUse this constructor with the case-insensitive string comparers provided by the StringComparer class to create dictionaries with case-insensitive string keys.

Jeder Schlüssel in einem Dictionary<TKey,TValue> muss gemäß dem angegebenen Comparer eindeutig sein.Every key in a Dictionary<TKey,TValue> must be unique according to the specified comparer.

Die Kapazität eines Dictionary<TKey,TValue> ist die Anzahl der Elemente, die der hinzugefügt werden können, bevor die Größe geändert werden kann Dictionary<TKey,TValue> .The capacity of a Dictionary<TKey,TValue> is the number of elements that can be added to the Dictionary<TKey,TValue> before resizing is necessary. Wenn Elemente zu einem hinzugefügt werden Dictionary<TKey,TValue> , wird die Kapazität bei Bedarf automatisch erhöht, indem das interne Array neu zugewiesen wird.As elements are added to a Dictionary<TKey,TValue>, the capacity is automatically increased as required by reallocating the internal array.

Wenn die Größe der Auflistung geschätzt werden kann, entfällt beim Angeben der anfänglichen Kapazität das Ausführen einer Reihe von Größenänderung beim Hinzufügen von Elementen zum Dictionary<TKey,TValue> .If the size of the collection can be estimated, specifying the initial capacity eliminates the need to perform a number of resizing operations while adding elements to the Dictionary<TKey,TValue>.

Dictionary<TKey,TValue>erfordert eine Gleichheits Implementierung, um zu bestimmen, ob Schlüssel gleich sind.Dictionary<TKey,TValue> requires an equality implementation to determine whether keys are equal. Wenn comparer ist null , verwendet dieser Konstruktor den generischen Standard Gleichheits Vergleich EqualityComparer<T>.Default .If comparer is null, this constructor uses the default generic equality comparer, EqualityComparer<T>.Default. Wenn TKey der Typ die System.IEquatable<T> generische Schnittstelle implementiert, verwendet der Standard Gleichheits Vergleich diese Implementierung.If type TKey implements the System.IEquatable<T> generic interface, the default equality comparer uses that implementation.

Dieser Konstruktor ist ein O (1)-Vorgang.This constructor is an O(1) operation.

Weitere Informationen

Dictionary<TKey,TValue>(SerializationInfo, StreamingContext)

Initialisiert eine neue Instanz der Dictionary<TKey,TValue>-Klasse mit serialisierten Daten.Initializes a new instance of the Dictionary<TKey,TValue> class with serialized data.

protected:
 Dictionary(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);
protected Dictionary (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
new System.Collections.Generic.Dictionary<'Key, 'Value> : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Collections.Generic.Dictionary<'Key, 'Value>
Protected Sub New (info As SerializationInfo, context As StreamingContext)

Parameter

info
SerializationInfo

Ein SerializationInfo-Objekt mit den zum Serialisieren der Dictionary<TKey,TValue> erforderlichen Informationen.A SerializationInfo object containing the information required to serialize the Dictionary<TKey,TValue>.

context
StreamingContext

Eine StreamingContext-Struktur mit der Quelle und dem Ziel des entsprechenden serialisierten Streams für Dictionary<TKey,TValue>.A StreamingContext structure containing the source and destination of the serialized stream associated with the Dictionary<TKey,TValue>.

Hinweise

Dieser Konstruktor wird während der Deserialisierung aufgerufen, um ein Objekt, das über einen Stream übertragen wird, wiederherzustellen.This constructor is called during deserialization to reconstitute an object transmitted over a stream. Weitere Informationen finden Sie unter XML- und SOAP-Serialisierung.For more information, see XML and SOAP Serialization.

Weitere Informationen

Gilt für: