NameValueCollection Конструкторы

Определение

Пространство имен:

System.Collections.Specialized

Сборка:

System.Collections.Specialized.dll

Инициализирует новый экземпляр класса NameValueCollection.

Перегрузки

NameValueCollection()	Инициализирует новый экземпляр класса NameValueCollection, который является пустым, обладает исходной емкостью по умолчанию, использует поставщика хэш-кода по умолчанию и функцию сравнения по умолчанию. Функция сравнения и поставщик хэш-кода работают без учета регистра.
NameValueCollection(IEqualityComparer)	Инициализирует новый экземпляр пустого класса NameValueCollection, который обладает начальной емкостью по умолчанию и использует указанный объект IEqualityComparer.
NameValueCollection(NameValueCollection)	Копирует записи из указанной коллекции NameValueCollection в новую коллекцию NameValueCollection с начальной емкостью, равной количеству копируемых записей. При этом используется такой же поставщик хэш-кода и такая же функция сравнения, которые использовались в исходной коллекции.
NameValueCollection(Int32)	Инициализирует новый экземпляр класса NameValueCollection, который является пустым, обладает указанной исходной емкостью, использует поставщика хэш-кода по умолчанию и функцию сравнения по умолчанию. Функция сравнения и поставщик хэш-кода работают без учета регистра.
NameValueCollection(IHashCodeProvider, IComparer)	Устаревшие.. Инициализирует новый экземпляр класса NameValueCollection, который является пустым, обладает начальной емкостью по умолчанию и использует указанного поставщика хэш-кода и указанную функцию сравнения.
NameValueCollection(Int32, IEqualityComparer)	Инициализирует новый экземпляр класса NameValueCollection, который является пустым, обладает указанной исходной емкостью и использует заданный объект IEqualityComparer.
NameValueCollection(Int32, NameValueCollection)	Копирует записи из указанной коллекции NameValueCollection в новую коллекцию NameValueCollection с указанной начальной емкостью или начальной емкостью, равной количеству копируемых записей, — в зависимости от того, какое значение больше. При этом используются поставщик хэш-кода по умолчанию и функция сравнения по умолчанию, работающие без учета регистра.
NameValueCollection(SerializationInfo, StreamingContext)	Устаревшие.. Инициализирует новый экземпляр класса NameValueCollection, который поддерживает сериализацию и использует указанные объекты SerializationInfo и StreamingContext.
NameValueCollection(Int32, IHashCodeProvider, IComparer)	Устаревшие.. Инициализирует новый экземпляр пустого класса NameValueCollection, который обладает указанной исходной емкостью и использует заданного поставщика хэш-кода и функцию сравнения.

NameValueCollection()

Исходный код:

NameValueCollection.cs

Инициализирует новый экземпляр класса NameValueCollection, который является пустым, обладает исходной емкостью по умолчанию, использует поставщика хэш-кода по умолчанию и функцию сравнения по умолчанию. Функция сравнения и поставщик хэш-кода работают без учета регистра.

public:
 NameValueCollection();

public NameValueCollection ();

Public Sub New ()

Комментарии

Емкость — NameValueCollection это количество элементов, которые может содержать объект NameValueCollection . При добавлении элементов в NameValueCollectionемкость автоматически увеличивается по мере необходимости путем перераспределения внутреннего массива.

Если размер коллекции можно оценить, указание начальной емкости избавляет от необходимости выполнять ряд операций изменения размера при добавлении элементов в NameValueCollection.

Поставщик хэш-кода раздает хэш-коды для ключей NameValueCollectionв . Поставщиком хэш-кода по умолчанию является CaseInsensitiveHashCodeProvider.

Функция сравнения определяет, равны ли два ключа. Компаратор по умолчанию — .CaseInsensitiveComparer

Этот конструктор является операцией O(1).

См. также раздел

• CaseInsensitiveHashCodeProvider
• CaseInsensitiveComparer
• Выполнение строковых операций, не зависящих от языка и региональных параметров

NameValueCollection(IEqualityComparer)

Исходный код:

NameValueCollection.cs

Инициализирует новый экземпляр пустого класса NameValueCollection, который обладает начальной емкостью по умолчанию и использует указанный объект IEqualityComparer.

public:
 NameValueCollection(System::Collections::IEqualityComparer ^ equalityComparer);

public NameValueCollection (System.Collections.IEqualityComparer? equalityComparer);

new System.Collections.Specialized.NameValueCollection : System.Collections.IEqualityComparer -> System.Collections.Specialized.NameValueCollection

Public Sub New (equalityComparer As IEqualityComparer)

Параметры

equalityComparer

IEqualityComparer

Объект IEqualityComparer, который используется для определения равенства двух ключей и создания хэш-кодов для ключей в коллекции.

Комментарии

Емкость NameValueCollection объекта — это количество элементов, которые может содержать объект NameValueCollection . При добавлении элементов в NameValueCollectionемкость автоматически увеличивается по мере необходимости путем перераспределения внутреннего массива.

Если размер коллекции можно оценить, указание начальной емкости избавляет от необходимости выполнять ряд операций изменения размера при добавлении элементов в NameValueCollection.

Объект IEqualityComparer объединяет компаратор и поставщик хэш-кода. Поставщик хэш-кода раздает хэш-коды для ключей NameValueCollectionв . Функция сравнения определяет, равны ли два ключа.

Этот конструктор является операцией O(1).

См. также раздел

• IEqualityComparer
• Выполнение строковых операций, не зависящих от языка и региональных параметров

NameValueCollection(NameValueCollection)

Исходный код:

NameValueCollection.cs

Копирует записи из указанной коллекции NameValueCollection в новую коллекцию NameValueCollection с начальной емкостью, равной количеству копируемых записей. При этом используется такой же поставщик хэш-кода и такая же функция сравнения, которые использовались в исходной коллекции.

public:
 NameValueCollection(System::Collections::Specialized::NameValueCollection ^ col);

public NameValueCollection (System.Collections.Specialized.NameValueCollection col);

new System.Collections.Specialized.NameValueCollection : System.Collections.Specialized.NameValueCollection -> System.Collections.Specialized.NameValueCollection

Public Sub New (col As NameValueCollection)

Параметры

col

NameValueCollection

Коллекция NameValueCollection, копируемая в новый экземпляр класса NameValueCollection.

Исключения

ArgumentNullException

col имеет значение null.

Комментарии

Емкость — NameValueCollection это количество элементов, которые может содержать объект NameValueCollection . При добавлении элементов в NameValueCollectionемкость автоматически увеличивается по мере необходимости путем перераспределения внутреннего массива.

Если размер коллекции можно оценить, указание начальной емкости избавляет от необходимости выполнять ряд операций изменения размера при добавлении элементов в NameValueCollection.

Поставщик хэш-кода раздает хэш-коды для ключей NameValueCollectionв . Поставщиком хэш-кода по умолчанию является CaseInsensitiveHashCodeProvider.

Функция сравнения определяет, равны ли два ключа. Компаратор по умолчанию — .CaseInsensitiveComparer

Элементы нового NameValueCollection объекта сортируются в том же порядке, что и исходный NameValueCollection.

Этот конструктор является операцией O(n), где n — количество элементов в col.

См. также раздел

• CaseInsensitiveHashCodeProvider
• CaseInsensitiveComparer
• Выполнение строковых операций, не зависящих от языка и региональных параметров

NameValueCollection(Int32)

Исходный код:

NameValueCollection.cs

Инициализирует новый экземпляр класса NameValueCollection, который является пустым, обладает указанной исходной емкостью, использует поставщика хэш-кода по умолчанию и функцию сравнения по умолчанию. Функция сравнения и поставщик хэш-кода работают без учета регистра.

public:
 NameValueCollection(int capacity);

public NameValueCollection (int capacity);

new System.Collections.Specialized.NameValueCollection : int -> System.Collections.Specialized.NameValueCollection

Public Sub New (capacity As Integer)

Параметры

capacity

Int32

Начальное количество записей, которое может содержать NameValueCollection.

Исключения

ArgumentOutOfRangeException

Значение параметра capacity меньше нуля.

Комментарии

Емкость — NameValueCollection это количество элементов, которые может содержать объект NameValueCollection . При добавлении элементов в NameValueCollectionемкость автоматически увеличивается по мере необходимости путем перераспределения внутреннего массива.

Если размер коллекции можно оценить, указание начальной емкости избавляет от необходимости выполнять ряд операций изменения размера при добавлении элементов в NameValueCollection.

Поставщик хэш-кода раздает хэш-коды для ключей NameValueCollectionв . Поставщиком хэш-кода по умолчанию является CaseInsensitiveHashCodeProvider.

Функция сравнения определяет, равны ли два ключа. Компаратор по умолчанию — .CaseInsensitiveComparer

Этот конструктор является операцией O(n), где n — .capacity

См. также раздел

• CaseInsensitiveHashCodeProvider
• CaseInsensitiveComparer
• Выполнение строковых операций, не зависящих от языка и региональных параметров

NameValueCollection(IHashCodeProvider, IComparer)

Исходный код:

NameValueCollection.cs

Внимание!

This constructor has been deprecated. Use NameValueCollection(IEqualityComparer) instead.

Инициализирует новый экземпляр класса NameValueCollection, который является пустым, обладает начальной емкостью по умолчанию и использует указанного поставщика хэш-кода и указанную функцию сравнения.

public:
 NameValueCollection(System::Collections::IHashCodeProvider ^ hashProvider, System::Collections::IComparer ^ comparer);

[System.Obsolete("This constructor has been deprecated. Use NameValueCollection(IEqualityComparer) instead.")]
public NameValueCollection (System.Collections.IHashCodeProvider? hashProvider, System.Collections.IComparer? comparer);

[<System.Obsolete("This constructor has been deprecated. Use NameValueCollection(IEqualityComparer) instead.")>]
new System.Collections.Specialized.NameValueCollection : System.Collections.IHashCodeProvider * System.Collections.IComparer -> System.Collections.Specialized.NameValueCollection

Public Sub New (hashProvider As IHashCodeProvider, comparer As IComparer)

Параметры

hashProvider

IHashCodeProvider

Объект IHashCodeProvider, который предоставит хэш-коды для всех ключей в NameValueCollection.

comparer

IComparer

Интерфейс IComparer, который используется для определения равенства двух ключей.

Атрибуты

ObsoleteAttribute

Комментарии

Емкость — NameValueCollection это количество элементов, которые может содержать объект NameValueCollection . При добавлении элементов в NameValueCollectionемкость автоматически увеличивается по мере необходимости путем перераспределения внутреннего массива.

Если размер коллекции можно оценить, указание начальной емкости избавляет от необходимости выполнять ряд операций изменения размера при добавлении элементов в NameValueCollection.

Поставщик хэш-кода раздает хэш-коды для ключей NameValueCollectionв . Поставщиком хэш-кода по умолчанию является CaseInsensitiveHashCodeProvider.

Функция сравнения определяет, равны ли два ключа. Компаратор по умолчанию — .CaseInsensitiveComparer

Этот конструктор является операцией O(1).

См. также раздел

• IHashCodeProvider
• CaseInsensitiveHashCodeProvider
• IComparer
• CaseInsensitiveComparer
• Выполнение строковых операций, не зависящих от языка и региональных параметров

NameValueCollection(Int32, IEqualityComparer)

Исходный код:

NameValueCollection.cs

Инициализирует новый экземпляр класса NameValueCollection, который является пустым, обладает указанной исходной емкостью и использует заданный объект IEqualityComparer.

public:
 NameValueCollection(int capacity, System::Collections::IEqualityComparer ^ equalityComparer);

public NameValueCollection (int capacity, System.Collections.IEqualityComparer? equalityComparer);

new System.Collections.Specialized.NameValueCollection : int * System.Collections.IEqualityComparer -> System.Collections.Specialized.NameValueCollection

Public Sub New (capacity As Integer, equalityComparer As IEqualityComparer)

Параметры

capacity

Int32

Начальное количество записей, которое может содержать объект NameValueCollection.

equalityComparer

IEqualityComparer

Объект IEqualityComparer, который используется для определения равенства двух ключей и создания хэш-кодов для ключей в коллекции.

Исключения

ArgumentOutOfRangeException

Значение параметра capacity меньше нуля.

Комментарии

Емкость NameValueCollection объекта — это количество элементов, которые может содержать объект NameValueCollection . При добавлении элементов в NameValueCollectionемкость автоматически увеличивается по мере необходимости путем перераспределения внутреннего массива.

Если размер коллекции можно оценить, указание начальной емкости избавляет от необходимости выполнять ряд операций изменения размера при добавлении элементов в NameValueCollection.

Объект IEqualityComparer объединяет компаратор и поставщик хэш-кода. Поставщик хэш-кода раздает хэш-коды для ключей NameValueCollectionв . Функция сравнения определяет, равны ли два ключа.

Этот конструктор является операцией O(n), где n — capacity параметр .

См. также раздел

• IEqualityComparer
• Выполнение строковых операций, не зависящих от языка и региональных параметров

NameValueCollection(Int32, NameValueCollection)

Исходный код:

NameValueCollection.cs

Копирует записи из указанной коллекции NameValueCollection в новую коллекцию NameValueCollection с указанной начальной емкостью или начальной емкостью, равной количеству копируемых записей, — в зависимости от того, какое значение больше. При этом используются поставщик хэш-кода по умолчанию и функция сравнения по умолчанию, работающие без учета регистра.

public:
 NameValueCollection(int capacity, System::Collections::Specialized::NameValueCollection ^ col);

public NameValueCollection (int capacity, System.Collections.Specialized.NameValueCollection col);

new System.Collections.Specialized.NameValueCollection : int * System.Collections.Specialized.NameValueCollection -> System.Collections.Specialized.NameValueCollection

Public Sub New (capacity As Integer, col As NameValueCollection)

Параметры

capacity

Int32

Начальное количество записей, которое может содержать NameValueCollection.

col

NameValueCollection

Коллекция NameValueCollection, копируемая в новый экземпляр класса NameValueCollection.

Исключения

ArgumentOutOfRangeException

Значение параметра capacity меньше нуля.

ArgumentNullException

col имеет значение null.

Комментарии

Емкость — NameValueCollection это количество элементов, которые может содержать объект NameValueCollection . При добавлении элементов в NameValueCollectionемкость автоматически увеличивается по мере необходимости путем перераспределения внутреннего массива.

Если размер коллекции можно оценить, указание начальной емкости избавляет от необходимости выполнять ряд операций изменения размера при добавлении элементов в NameValueCollection.

Поставщик хэш-кода раздает хэш-коды для ключей NameValueCollectionв . Поставщиком хэш-кода по умолчанию является CaseInsensitiveHashCodeProvider.

Функция сравнения определяет, равны ли два ключа. Компаратор по умолчанию — .CaseInsensitiveComparer

Этот конструктор является операцией O(n), где n — .capacity Если число элементов в col больше , этот capacityконструктор становится операцией O(m + n), где n — capacity и m — количество элементов в .col

См. также раздел

• CaseInsensitiveHashCodeProvider
• CaseInsensitiveComparer
• Выполнение строковых операций, не зависящих от языка и региональных параметров

NameValueCollection(SerializationInfo, StreamingContext)

Исходный код:

NameValueCollection.cs

Внимание!

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

Инициализирует новый экземпляр класса NameValueCollection, который поддерживает сериализацию и использует указанные объекты SerializationInfo и StreamingContext.

protected:
 NameValueCollection(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected NameValueCollection (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Collections.Specialized.NameValueCollection : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Collections.Specialized.NameValueCollection

Protected Sub New (info As SerializationInfo, context As StreamingContext)

Параметры

info

SerializationInfo

Объект SerializationInfo, который содержит сведения, необходимые для сериализации нового экземпляра класса NameValueCollection.

context

StreamingContext

Объект StreamingContext, содержащий исходный объект и объект назначения для сериализованного потока, связанного с новым экземпляром класса NameValueCollection.

Атрибуты

ObsoleteAttribute

Комментарии

Этот конструктор является операцией O(1).

См. также раздел

• ISerializable
• SerializationInfo
• StreamingContext
• Выполнение строковых операций, не зависящих от языка и региональных параметров

NameValueCollection(Int32, IHashCodeProvider, IComparer)

Исходный код:

NameValueCollection.cs

Внимание!

This constructor has been deprecated. Use NameValueCollection(Int32, IEqualityComparer) instead.

Инициализирует новый экземпляр пустого класса NameValueCollection, который обладает указанной исходной емкостью и использует заданного поставщика хэш-кода и функцию сравнения.

public:
 NameValueCollection(int capacity, System::Collections::IHashCodeProvider ^ hashProvider, System::Collections::IComparer ^ comparer);

[System.Obsolete("This constructor has been deprecated. Use NameValueCollection(Int32, IEqualityComparer) instead.")]
public NameValueCollection (int capacity, System.Collections.IHashCodeProvider? hashProvider, System.Collections.IComparer? comparer);

[<System.Obsolete("This constructor has been deprecated. Use NameValueCollection(Int32, IEqualityComparer) instead.")>]
new System.Collections.Specialized.NameValueCollection : int * System.Collections.IHashCodeProvider * System.Collections.IComparer -> System.Collections.Specialized.NameValueCollection

Public Sub New (capacity As Integer, hashProvider As IHashCodeProvider, comparer As IComparer)

Параметры

capacity

Int32

Начальное количество записей, которое может содержать NameValueCollection.

hashProvider

IHashCodeProvider

Объект IHashCodeProvider, который предоставит хэш-коды для всех ключей в NameValueCollection.

comparer

IComparer

Интерфейс IComparer, который используется для определения равенства двух ключей.

Атрибуты

ObsoleteAttribute

Исключения

ArgumentOutOfRangeException

Значение параметра capacity меньше нуля.

Комментарии

Емкость — NameValueCollection это количество элементов, которые может содержать объект NameValueCollection . При добавлении элементов в NameValueCollectionемкость автоматически увеличивается по мере необходимости путем перераспределения внутреннего массива.

Если размер коллекции можно оценить, указание начальной емкости избавляет от необходимости выполнять ряд операций изменения размера при добавлении элементов в NameValueCollection.

Поставщик хэш-кода раздает хэш-коды для ключей NameValueCollectionв . Поставщиком хэш-кода по умолчанию является CaseInsensitiveHashCodeProvider.

Функция сравнения определяет, равны ли два ключа. Компаратор по умолчанию — .CaseInsensitiveComparer

Этот конструктор является операцией O(n), где n — .capacity

См. также раздел

• CaseInsensitiveHashCodeProvider
• CaseInsensitiveComparer
• Выполнение строковых операций, не зависящих от языка и региональных параметров