NameObjectCollectionBase 建構函式
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
初始化 NameObjectCollectionBase 類別的新執行個體。
多載
| 名稱 | Description |
|---|---|
| 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 。
protected:
NameObjectCollectionBase();protected NameObjectCollectionBase();Protected Sub New ()備註
a NameObjectCollectionBase 的容量是它 NameObjectCollectionBase 能容納的元素數量。 當元素加入 NameObjectCollectionBase時，容量會自動透過重新配置內部陣列而增加。
若能估計集合的大小，指定初始容量即可免除在加入元素 NameObjectCollectionBase時進行多次調整大小操作的需求。
雜湊碼提供者會為實例中的 NameObjectCollectionBase 金鑰分配雜湊碼。 預設的雜湊碼提供者為 CaseInsensitiveHashCodeProvider.
比較器判斷兩個鍵是否相等。 預設比較器為 CaseInsensitiveComparer。
此構造子為 O（1） 運算。
另請參閱
適用於
NameObjectCollectionBase(IEqualityComparer)
初始化一個新的類別實例，該實例 NameObjectCollectionBase 為空，擁有預設初始容量，並使用指定的 IEqualityComparer 物件。
protected:
NameObjectCollectionBase(System::Collections::IEqualityComparer ^ equalityComparer);protected NameObjectCollectionBase(System.Collections.IEqualityComparer equalityComparer);protected NameObjectCollectionBase(System.Collections.IEqualityComparer? equalityComparer);new System.Collections.Specialized.NameObjectCollectionBase : System.Collections.IEqualityComparer -> System.Collections.Specialized.NameObjectCollectionBaseProtected Sub New (equalityComparer As IEqualityComparer)參數
- equalityComparer
- IEqualityComparer
IEqualityComparer用於判斷兩個鍵是否相等，並為集合中鍵產生雜湊碼的物件。
備註
物體的 NameObjectCollectionBase 容量是它 NameObjectCollectionBase 能容納的元素數量。 當元素加入 NameObjectCollectionBase時，容量會自動透過重新配置內部陣列而增加。
若能估計集合的大小，指定初始容量即可免除在加入元素 NameObjectCollectionBase時進行多次調整大小操作的需求。
該 IEqualityComparer 物件結合了比較器與雜湊碼提供者。 雜湊碼提供者會為 NameObjectCollectionBase. 比較器判斷兩個鍵是否相等。
此構造子為 O（1） 運算。
另請參閱
適用於
NameObjectCollectionBase(Int32)
初始化一個新的類別實例，該實例 NameObjectCollectionBase 為空，擁有指定的初始容量，並使用預設雜湊碼提供者與預設比較器。
protected:
NameObjectCollectionBase(int capacity);protected NameObjectCollectionBase(int capacity);new System.Collections.Specialized.NameObjectCollectionBase : int -> System.Collections.Specialized.NameObjectCollectionBaseProtected Sub New (capacity As Integer)參數
- capacity
- Int32
該實例最初可包含的近似條目 NameObjectCollectionBase 數。
例外狀況
capacity 小於零。
備註
a NameObjectCollectionBase 的容量是它 NameObjectCollectionBase 能容納的元素數量。 當元素加入 NameObjectCollectionBase時，容量會自動透過重新配置內部陣列而增加。
若能估計集合的大小，指定初始容量即可免除在加入元素 NameObjectCollectionBase時進行多次調整大小操作的需求。
雜湊碼提供者會為實例中的 NameObjectCollectionBase 金鑰分配雜湊碼。 預設的雜湊碼提供者為 CaseInsensitiveHashCodeProvider.
比較器判斷兩個鍵是否相等。 預設比較器為 CaseInsensitiveComparer。
此構造子是一個 O（n） 運算，其中 n 為 capacity。
另請參閱
適用於
NameObjectCollectionBase(IHashCodeProvider, IComparer)
警告
This constructor has been deprecated. Use NameObjectCollectionBase(IEqualityComparer) instead.
警告
Please 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("Please use NameObjectCollectionBase(IEqualityComparer) instead.")]
protected NameObjectCollectionBase(System.Collections.IHashCodeProvider? hashProvider, System.Collections.IComparer? comparer);[System.Obsolete("Please use NameObjectCollectionBase(IEqualityComparer) instead.")]
protected NameObjectCollectionBase(System.Collections.IHashCodeProvider hashProvider, System.Collections.IComparer comparer);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[<System.Obsolete("Please use NameObjectCollectionBase(IEqualityComparer) instead.")>]
new System.Collections.Specialized.NameObjectCollectionBase : System.Collections.IHashCodeProvider * System.Collections.IComparer -> System.Collections.Specialized.NameObjectCollectionBasenew System.Collections.Specialized.NameObjectCollectionBase : System.Collections.IHashCodeProvider * System.Collections.IComparer -> System.Collections.Specialized.NameObjectCollectionBaseProtected Sub New (hashProvider As IHashCodeProvider, comparer As IComparer)參數
- hashProvider
- IHashCodeProvider
那 IHashCodeProvider 就會提供該 NameObjectCollectionBase 實例中所有金鑰的雜湊碼。
- 屬性
備註
a NameObjectCollectionBase 的容量是它 NameObjectCollectionBase 能容納的元素數量。 當元素加入 NameObjectCollectionBase時，容量會自動透過重新配置內部陣列而增加。
若能估計集合的大小，指定初始容量即可免除在加入元素 NameObjectCollectionBase時進行多次調整大小操作的需求。
雜湊碼提供者會為實例中的 NameObjectCollectionBase 金鑰分配雜湊碼。 預設的雜湊碼提供者為 CaseInsensitiveHashCodeProvider.
比較器判斷兩個鍵是否相等。 預設比較器為 CaseInsensitiveComparer。
此構造子為 O（1） 運算。
另請參閱
- IHashCodeProvider
- IComparer
- CaseInsensitiveHashCodeProvider
- CaseInsensitiveComparer
- 執行 Culture-Insensitive 字串操作
適用於
NameObjectCollectionBase(Int32, IEqualityComparer)
初始化一個空的類別新實例，該實例 NameObjectCollectionBase 具有指定的初始容量，並使用指定的 IEqualityComparer 物件。
protected:
NameObjectCollectionBase(int capacity, System::Collections::IEqualityComparer ^ equalityComparer);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.NameObjectCollectionBaseProtected Sub New (capacity As Integer, equalityComparer As IEqualityComparer)參數
- capacity
- Int32
物件最初可包含的近似條目 NameObjectCollectionBase 數。
- equalityComparer
- IEqualityComparer
IEqualityComparer用於判斷兩個鍵是否相等，並為集合中鍵產生雜湊碼的物件。
例外狀況
capacity 小於零。
備註
物體的 NameObjectCollectionBase 容量是它 NameObjectCollectionBase 能容納的元素數量。 當元素加入 NameObjectCollectionBase時，容量會自動透過重新配置內部陣列而增加。
若能估計集合的大小，指定初始容量即可免除在加入元素 NameObjectCollectionBase時進行多次調整大小操作的需求。
該 IEqualityComparer 物件結合了比較器與雜湊碼提供者。 雜湊碼提供者會為 NameObjectCollectionBase. 比較器判斷兩個鍵是否相等。
此構造子為 O（n） 運算，其中 n 為 capacity 參數。
另請參閱
適用於
NameObjectCollectionBase(SerializationInfo, StreamingContext)
警告
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);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.NameObjectCollectionBasenew System.Collections.Specialized.NameObjectCollectionBase : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Collections.Specialized.NameObjectCollectionBaseProtected Sub New (info As SerializationInfo, context As StreamingContext)參數
- info
- SerializationInfo
一個 SerializationInfo 包含序列化新 NameObjectCollectionBase 實例所需資訊的物件。
- context
- StreamingContext
一個 StreamingContext 包含與新 NameObjectCollectionBase 實例相關聯序列化串流來源與目的地的物件。
- 屬性
備註
此構造子為 O（1） 運算。
另請參閱
適用於
NameObjectCollectionBase(Int32, IHashCodeProvider, IComparer)
警告
This constructor has been deprecated. Use NameObjectCollectionBase(Int32, IEqualityComparer) instead.
警告
Please 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("Please use NameObjectCollectionBase(Int32, IEqualityComparer) instead.")]
protected NameObjectCollectionBase(int capacity, System.Collections.IHashCodeProvider? hashProvider, System.Collections.IComparer? comparer);[System.Obsolete("Please use NameObjectCollectionBase(Int32, IEqualityComparer) instead.")]
protected NameObjectCollectionBase(int capacity, System.Collections.IHashCodeProvider hashProvider, System.Collections.IComparer comparer);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[<System.Obsolete("Please use NameObjectCollectionBase(Int32, IEqualityComparer) instead.")>]
new System.Collections.Specialized.NameObjectCollectionBase : int * System.Collections.IHashCodeProvider * System.Collections.IComparer -> System.Collections.Specialized.NameObjectCollectionBasenew System.Collections.Specialized.NameObjectCollectionBase : int * System.Collections.IHashCodeProvider * System.Collections.IComparer -> System.Collections.Specialized.NameObjectCollectionBaseProtected Sub New (capacity As Integer, hashProvider As IHashCodeProvider, comparer As IComparer)參數
- capacity
- Int32
該實例最初可包含的近似條目 NameObjectCollectionBase 數。
- hashProvider
- IHashCodeProvider
那 IHashCodeProvider 就會提供該 NameObjectCollectionBase 實例中所有金鑰的雜湊碼。
- 屬性
例外狀況
capacity 小於零。
備註
a NameObjectCollectionBase 的容量是它 NameObjectCollectionBase 能容納的元素數量。 當元素加入 NameObjectCollectionBase時，容量會自動透過重新配置內部陣列而增加。
若能估計集合的大小，指定初始容量即可免除在加入元素 NameObjectCollectionBase時進行多次調整大小操作的需求。
雜湊碼提供者會為實例中的 NameObjectCollectionBase 金鑰分配雜湊碼。 預設的雜湊碼提供者為 CaseInsensitiveHashCodeProvider.
比較器判斷兩個鍵是否相等。 預設比較器為 CaseInsensitiveComparer。
此構造子是一個 O（n） 運算，其中 n 為 capacity。
另請參閱
- IHashCodeProvider
- CaseInsensitiveHashCodeProvider
- IComparer
- CaseInsensitiveComparer
- 執行 Culture-Insensitive 字串操作
