NameValueCollection コンストラクタ (Int32, NameValueCollection)

指定した初期量またはコピーされるエントリの数と同じ初期量のうち値が大きい方の初期量を備え、大文字と小文字を区別しない既定のハッシュコードプロバイダおよび比較演算子を使用する新しい NameValueCollection に、指定した NameValueCollection からエントリをコピーします。

名前空間: System.Collections.Specialized
アセンブリ: System (system.dll 内)

構文

'宣言
Public Sub New ( _
    capacity As Integer, _
    col As NameValueCollection _
)
'使用
Dim capacity As Integer
Dim col As NameValueCollection

Dim instance As New NameValueCollection(capacity, col)

public NameValueCollection (
    int capacity,
    NameValueCollection col
)

public:
NameValueCollection (
    int capacity, 
    NameValueCollection^ col
)

public NameValueCollection (
    int capacity, 
    NameValueCollection col
)

public function NameValueCollection (
    capacity : int, 
    col : NameValueCollection
)

パラメータ

capacity
NameValueCollection に格納できるエントリ数の初期値。

col
新しい NameValueCollection インスタンスにコピーする NameValueCollection。

例外

例外の種類	条件
ArgumentOutOfRangeException	capacity が 0 未満です。
ArgumentNullException	col が null 参照 (Visual Basic では Nothing) です。

解説

NameValueCollection の容量は、NameValueCollection が保持できる要素数になります。NameValueCollection に要素を追加すると、必要に応じて、内部の配列の再割り当てによって容量が自動的に増加します。

コレクションのサイズを推定できる場合は、初期量を指定すると、NameValueCollection に要素を追加するときに、サイズ変更操作を何度も実行する必要がなくなります。

ハッシュコードプロバイダは、NameValueCollection 内のキーにハッシュコードを提供します。既定のハッシュコードプロバイダは CaseInsensitiveHashCodeProvider です。

比較演算子は 2 つのキーが等しいかどうかを判断します。既定の比較演算子は CaseInsensitiveComparer です。

このコンストラクタは O(n) 操作です。ここで、n は capacity です。col の要素数が capacity を超えている場合、このコンストラクタは O(n + m) 操作になります。ここで、n は capacity で、m は col の要素数です。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework

サポート対象 : 2.0、1.1、1.0

.NET Compact Framework

サポート対象 : 2.0、1.0

参照

その他の技術情報

カルチャを認識しない文字列操作の実行

Last updated on 2007-08-14