NameObjectCollectionBase 建構函式

定義

命名空間:

System.Collections.Specialized

組件:

System.Collections.Specialized.dll

初始化 NameObjectCollectionBase 類別的新執行個體。

多載

NameObjectCollectionBase()	初始化 NameObjectCollectionBase 類別的新執行個體，這個執行個體是空白的。
NameObjectCollectionBase(IEqualityComparer)	初始化 NameObjectCollectionBase 類別的新執行個體，這個執行個體是空白的、具有預設的初始容量，並使用指定的 IEqualityComparer 物件。
NameObjectCollectionBase(Int32)	初始化 NameObjectCollectionBase 類別的新執行個體，這個執行個體是空白的、具有指定的初始容量，並使用預設雜湊碼提供者和預設比較子。
NameObjectCollectionBase(IHashCodeProvider, IComparer)	已淘汰. 初始化 NameObjectCollectionBase 類別的新執行個體，這個執行個體是空白的、具有預設的初始容量，並使用指定的雜湊碼提供者和指定的比較子。
NameObjectCollectionBase(Int32, IEqualityComparer)	初始化 NameObjectCollectionBase 類別的新執行個體，這個執行個體是空白的、具有指定的初始容量，並使用指定的 IEqualityComparer 物件。
NameObjectCollectionBase(SerializationInfo, StreamingContext)	已淘汰. 初始化 NameObjectCollectionBase 類別的新執行個體，這個執行個體可序列化，並使用指定的 SerializationInfo 和 StreamingContext。
NameObjectCollectionBase(Int32, IHashCodeProvider, IComparer)	已淘汰. 初始化 NameObjectCollectionBase 類別的新執行個體，這個執行個體是空白的、具有指定的初始容量，並使用指定的雜湊碼提供者和指定的比較子。

NameObjectCollectionBase()

來源:

NameObjectCollectionBase.cs

初始化 NameObjectCollectionBase 類別的新執行個體，這個執行個體是空白的。

protected:
 NameObjectCollectionBase();

protected NameObjectCollectionBase ();

Protected Sub New ()

備註

的 NameObjectCollectionBase 容量是 可以保存的項目 NameObjectCollectionBase 數目。 當元素新增至 NameObjectCollectionBase時，重新配置內部數位會自動增加容量。

如果可以估計集合的大小，指定初始容量就不需要在將元素新增至 NameObjectCollectionBase時執行一些重設大小作業。

哈希碼提供者會為 實例中的 NameObjectCollectionBase 索引鍵分配哈希碼。 預設哈希碼提供者為 CaseInsensitiveHashCodeProvider。

比較子會判斷兩個索引鍵是否相等。 預設比較子是 CaseInsensitiveComparer。

此建構函式是 O (1) 作業。

另請參閱

• CaseInsensitiveHashCodeProvider
• CaseInsensitiveComparer
• 執行不區分文化特性的字串作業

NameObjectCollectionBase(IEqualityComparer)

來源:

NameObjectCollectionBase.cs

初始化 NameObjectCollectionBase 類別的新執行個體，這個執行個體是空白的、具有預設的初始容量，並使用指定的 IEqualityComparer 物件。

protected:
 NameObjectCollectionBase(System::Collections::IEqualityComparer ^ equalityComparer);

protected NameObjectCollectionBase (System.Collections.IEqualityComparer? equalityComparer);

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

Protected Sub New (equalityComparer As IEqualityComparer)

參數

equalityComparer

IEqualityComparer

IEqualityComparer 物件，可用來判斷兩個索引鍵是否相等，以及為集合中的索引鍵產生雜湊碼。

備註

物件的容量 NameObjectCollectionBase 是 可以保存的項目 NameObjectCollectionBase 數目。 當元素新增至 NameObjectCollectionBase時，重新配置內部數位會自動增加容量。

如果可以估計集合的大小，指定初始容量就不需要在將元素新增至 NameObjectCollectionBase時執行一些重設大小作業。

對象 IEqualityComparer 會結合比較子和哈希碼提供者。 哈希碼提供者會為 中的 NameObjectCollectionBase索引鍵分配哈希碼。 比較子會判斷兩個索引鍵是否相等。

此建構函式是 O (1) 作業。

另請參閱

• IEqualityComparer
• 執行不區分文化特性的字串作業

NameObjectCollectionBase(Int32)

來源:

NameObjectCollectionBase.cs

初始化 NameObjectCollectionBase 類別的新執行個體，這個執行個體是空白的、具有指定的初始容量，並使用預設雜湊碼提供者和預設比較子。

protected:
 NameObjectCollectionBase(int capacity);

protected NameObjectCollectionBase (int capacity);

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

Protected Sub New (capacity As Integer)

參數

capacity

Int32

NameObjectCollectionBase 執行個體一開始可包含的大約項目數。

例外狀況

ArgumentOutOfRangeException

capacity 小於零。

備註

的 NameObjectCollectionBase 容量是 可以保存的項目 NameObjectCollectionBase 數目。 當元素新增至 NameObjectCollectionBase時，重新配置內部數位會自動增加容量。

如果可以估計集合的大小，指定初始容量就不需要在將元素新增至 NameObjectCollectionBase時執行一些重設大小作業。

哈希碼提供者會為 實例中的 NameObjectCollectionBase 索引鍵分配哈希碼。 預設哈希碼提供者為 CaseInsensitiveHashCodeProvider。

比較子會判斷兩個索引鍵是否相等。 預設比較子是 CaseInsensitiveComparer。

這個建構函式是 O (n) 作業，其中 n 是 capacity。

另請參閱

• CaseInsensitiveHashCodeProvider
• CaseInsensitiveComparer
• 執行不區分文化特性的字串作業

NameObjectCollectionBase(IHashCodeProvider, IComparer)

來源:

NameObjectCollectionBase.cs

警告

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

初始化 NameObjectCollectionBase 類別的新執行個體，這個執行個體是空白的、具有預設的初始容量，並使用指定的雜湊碼提供者和指定的比較子。

protected:
 NameObjectCollectionBase(System::Collections::IHashCodeProvider ^ hashProvider, System::Collections::IComparer ^ comparer);

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

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

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

參數

hashProvider

IHashCodeProvider

IHashCodeProvider，將為 NameObjectCollectionBase 執行個體中的所有索引鍵提供雜湊碼。

comparer

IComparer

IComparer，可用來判斷兩個索引鍵是否相等。

屬性

ObsoleteAttribute

備註

的 NameObjectCollectionBase 容量是 可以保存的項目 NameObjectCollectionBase 數目。 當元素新增至 NameObjectCollectionBase時，重新配置內部數位會自動增加容量。

如果可以估計集合的大小，指定初始容量就不需要在將元素新增至 NameObjectCollectionBase時執行一些重設大小作業。

哈希碼提供者會為 實例中的 NameObjectCollectionBase 索引鍵分配哈希碼。 預設哈希碼提供者為 CaseInsensitiveHashCodeProvider。

比較子會判斷兩個索引鍵是否相等。 預設比較子是 CaseInsensitiveComparer。

此建構函式是 O (1) 作業。

另請參閱

• IHashCodeProvider
• IComparer
• CaseInsensitiveHashCodeProvider
• CaseInsensitiveComparer
• 執行不區分文化特性的字串作業

NameObjectCollectionBase(Int32, IEqualityComparer)

來源:

NameObjectCollectionBase.cs

初始化 NameObjectCollectionBase 類別的新執行個體，這個執行個體是空白的、具有指定的初始容量，並使用指定的 IEqualityComparer 物件。

protected:
 NameObjectCollectionBase(int capacity, System::Collections::IEqualityComparer ^ equalityComparer);

protected NameObjectCollectionBase (int capacity, System.Collections.IEqualityComparer? equalityComparer);

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

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

參數

capacity

Int32

NameObjectCollectionBase 物件一開始可包含的大約項目數。

equalityComparer

IEqualityComparer

IEqualityComparer 物件，可用來判斷兩個索引鍵是否相等，以及為集合中的索引鍵產生雜湊碼。

例外狀況

ArgumentOutOfRangeException

capacity 小於零。

備註

物件的容量 NameObjectCollectionBase 是 可以保存的項目 NameObjectCollectionBase 數目。 當元素新增至 NameObjectCollectionBase時，重新配置內部數位會自動增加容量。

如果可以估計集合的大小，指定初始容量就不需要在將元素新增至 NameObjectCollectionBase時執行一些重設大小作業。

對象 IEqualityComparer 會結合比較子和哈希碼提供者。 哈希碼提供者會為 中的 NameObjectCollectionBase索引鍵分配哈希碼。 比較子會判斷兩個索引鍵是否相等。

這個建構函式是 O (n) 作業，其中 n 是 capacity 參數。

另請參閱

• IEqualityComparer
• 執行不區分文化特性的字串作業

NameObjectCollectionBase(SerializationInfo, StreamingContext)

來源:

NameObjectCollectionBase.cs

警告

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

初始化 NameObjectCollectionBase 類別的新執行個體，這個執行個體可序列化，並使用指定的 SerializationInfo 和 StreamingContext。

protected:
 NameObjectCollectionBase(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 NameObjectCollectionBase (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.NameObjectCollectionBase : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Collections.Specialized.NameObjectCollectionBase

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

參數

info

SerializationInfo

SerializationInfo 物件，包含將新的 NameObjectCollectionBase 執行個體序列化所需的資訊。

context

StreamingContext

StreamingContext 物件，包含與新 NameObjectCollectionBase 執行個體相關聯之已序列資料流的來源和目的地。

屬性

ObsoleteAttribute

備註

此建構函式是 O (1) 作業。

另請參閱

• ISerializable
• SerializationInfo
• StreamingContext
• 執行不區分文化特性的字串作業

NameObjectCollectionBase(Int32, IHashCodeProvider, IComparer)

來源:

NameObjectCollectionBase.cs

警告

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

初始化 NameObjectCollectionBase 類別的新執行個體，這個執行個體是空白的、具有指定的初始容量，並使用指定的雜湊碼提供者和指定的比較子。

protected:
 NameObjectCollectionBase(int capacity, System::Collections::IHashCodeProvider ^ hashProvider, System::Collections::IComparer ^ comparer);

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

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

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

參數

capacity

Int32

NameObjectCollectionBase 執行個體一開始可包含的大約項目數。

hashProvider

IHashCodeProvider

IHashCodeProvider，將為 NameObjectCollectionBase 執行個體中的所有索引鍵提供雜湊碼。

comparer

IComparer

IComparer，可用來判斷兩個索引鍵是否相等。

屬性

ObsoleteAttribute

例外狀況

ArgumentOutOfRangeException

capacity 小於零。

備註

的 NameObjectCollectionBase 容量是 可以保存的項目 NameObjectCollectionBase 數目。 當元素新增至 NameObjectCollectionBase時，重新配置內部數位會自動增加容量。

如果可以估計集合的大小，指定初始容量就不需要在將元素新增至 NameObjectCollectionBase時執行一些重設大小作業。

哈希碼提供者會為 實例中的 NameObjectCollectionBase 索引鍵分配哈希碼。 預設哈希碼提供者為 CaseInsensitiveHashCodeProvider。

比較子會判斷兩個索引鍵是否相等。 預設比較子是 CaseInsensitiveComparer。

這個建構函式是 O (n) 作業，其中 n 是 capacity。

另請參閱

• IHashCodeProvider
• CaseInsensitiveHashCodeProvider
• IComparer
• CaseInsensitiveComparer
• 執行不區分文化特性的字串作業