NameObjectCollectionBase コンストラクタ (Int32, IHashCodeProvider, IComparer)

2007-08-14

メモ : このコンストラクタは、互換性のために残されています。

空で、指定した初期量を備え、指定したハッシュコードプロバイダと比較演算子を使用する、NameObjectCollectionBase クラスの新しいインスタンスを初期化します。

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

構文

'宣言
<ObsoleteAttribute("Please use NameObjectCollectionBase(Int32, IEqualityComparer) instead.")> _
Protected Sub New ( _
    capacity As Integer, _
    hashProvider As IHashCodeProvider, _
    comparer As IComparer _
)
'使用
Dim capacity As Integer
Dim hashProvider As IHashCodeProvider
Dim comparer As IComparer

Dim instance As New NameObjectCollectionBase(capacity, hashProvider, comparer)

[ObsoleteAttribute("Please use NameObjectCollectionBase(Int32, IEqualityComparer) instead.")] 
protected NameObjectCollectionBase (
    int capacity,
    IHashCodeProvider hashProvider,
    IComparer comparer
)

[ObsoleteAttribute(L"Please use NameObjectCollectionBase(Int32, IEqualityComparer) instead.")] 
protected:
NameObjectCollectionBase (
    int capacity, 
    IHashCodeProvider^ hashProvider, 
    IComparer^ comparer
)

/** @attribute ObsoleteAttribute("Please use NameObjectCollectionBase(Int32, IEqualityComparer) instead.") */ 
protected NameObjectCollectionBase (
    int capacity, 
    IHashCodeProvider hashProvider, 
    IComparer comparer
)

ObsoleteAttribute("Please use NameObjectCollectionBase(Int32, IEqualityComparer) instead.") 
protected function NameObjectCollectionBase (
    capacity : int, 
    hashProvider : IHashCodeProvider, 
    comparer : IComparer
)

パラメータ

capacity
NameObjectCollectionBase が初期状態で格納できるエントリの概数。

hashProvider
NameObjectCollectionBase インスタンス内のすべてのキーにハッシュコードを提供する IHashCodeProvider。

comparer
2 つのキーが等しいかどうかを判断するために使用する IComparer。

例外

例外の種類	条件
ArgumentOutOfRangeException	capacity が 0 未満です。

解説

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

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

ハッシュコードプロバイダは、キーに対するハッシュコードを NameObjectCollectionBase インスタンスに提供します。既定のハッシュコードプロバイダは CaseInsensitiveHashCodeProvider です。

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

このコンストラクタは O(n) 操作です (n は capacity)。

プラットフォーム

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

サポート対象 : 1.0、1.1
2.0 では、互換性のために残されています (コンパイル時に警告)

.NET Compact Framework

サポート対象 : 1.0
2.0 では、互換性のために残されています (コンパイル時に警告)

参照

その他の技術情報

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