ConditionalWeakTable<TKey,TValue> 類別

參考

定義

命名空間:: System.Runtime.CompilerServices

組件:: System.Runtime.dll

組件:: mscorlib.dll

組件:: netstandard.dll

來源:: ConditionalWeakTable.cs

來源:: ConditionalWeakTable.cs

來源:: ConditionalWeakTable.cs

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

可讓編譯程式以動態方式將物件字段附加至 Managed 物件。

generic <typename TKey, typename TValue>
 where TKey : class where TValue : classpublic ref class ConditionalWeakTable sealed

generic <typename TKey, typename TValue>
 where TKey : class where TValue : classpublic ref class ConditionalWeakTable sealed : System::Collections::Generic::IEnumerable<System::Collections::Generic::KeyValuePair<TKey, TValue>>

public sealed class ConditionalWeakTable<TKey,TValue> where TKey : class where TValue : class

public sealed class ConditionalWeakTable<TKey,TValue> : System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<TKey,TValue>> where TKey : class where TValue : class

[System.Runtime.InteropServices.ComVisible(false)]
public sealed class ConditionalWeakTable<TKey,TValue> where TKey : class where TValue : class

type ConditionalWeakTable<'Key, 'Value (requires 'Key : null and 'Value : null)> = class

type ConditionalWeakTable<'Key, 'Value (requires 'Key : null and 'Value : null)> = class
    interface seq<KeyValuePair<'Key, 'Value>>
    interface IEnumerable

[<System.Runtime.InteropServices.ComVisible(false)>]
type ConditionalWeakTable<'Key, 'Value (requires 'Key : null and 'Value : null)> = class

Public NotInheritable Class ConditionalWeakTable(Of TKey, TValue)

Public NotInheritable Class ConditionalWeakTable(Of TKey, TValue)
Implements IEnumerable(Of KeyValuePair(Of TKey, TValue))

類型參數

TKey

附加欄位的參考型別。

TValue

欄位的類型。這必須是參考型別。

繼承: Object
ConditionalWeakTable<TKey,TValue>

屬性: ComVisibleAttribute

實作: IEnumerable<KeyValuePair<TKey,TValue>> IEnumerable

範例

下列範例說明儲存在數據表 ConditionalWeakTable<TKey,TValue> 數據表中的索引鍵在數據表外部的參考終結之後不會保存。此範例會定義兩個類別：ManagedClass，代表數據表中的索引鍵，ClassData，代表索引鍵的值。此範例會具現化每個類型的三個物件。它也會具現化代表第二個 ManagedClass的 WeakReference 對象，然後終結第二個 ManagedClass 實例。嘗試從 Target 屬性擷取第二個 ManagedClass 物件，表示物件不會保留任何參考。

using System;
using System.Runtime.CompilerServices;

public class Example
{
   public static void Main()
   {
      var mc1 = new ManagedClass();
      var mc2 = new ManagedClass();
      var mc3 = new ManagedClass();
      
      var cwt = new ConditionalWeakTable<ManagedClass, ClassData>();
      cwt.Add(mc1, new ClassData());          
      cwt.Add(mc2, new ClassData());
      cwt.Add(mc3, new ClassData());
      
      var wr2 = new WeakReference(mc2);
      mc2 = null;

      GC.Collect();
      
      ClassData data = null; 

      if (wr2.Target == null)
          Console.WriteLine("No strong reference to mc2 exists.");   
      else if (cwt.TryGetValue(wr2.Target, out data))
          Console.WriteLine("Data created at {0}", data.CreationTime);      
      else
          Console.WriteLine("mc2 not found in the table.");
   }
}

public class ManagedClass
{ 
}

public class ClassData
{
   public DateTime CreationTime;
   public object Data;   
   
   public ClassData()
   {
      CreationTime = DateTime.Now;
      this.Data  = new object();     
   }
}
// The example displays the following output:
//       No strong reference to mc2 exists.

Imports System.Runtime.CompilerServices

Module Example
   Public Sub Main()
      Dim mc1 As New ManagedClass()
      Dim mc2 As New ManagedClass()
      Dim mc3 As New ManagedClass()
                    
      Dim cwt As New ConditionalWeakTable(Of ManagedClass, ClassData)()
      cwt.Add(mc1, New ClassData())          
      cwt.Add(mc2, New ClassData())
      cwt.Add(mc3, New ClassData())
      
      Dim wr2 As New WeakReference(mc2)
      mc2 = Nothing

      GC.Collect()

      Dim data As ClassData = Nothing

      If wr2.Target Is Nothing Then
          Console.WriteLine("No strong reference to mc2 exists.")   
      Else If cwt.TryGetValue(mc2, data) Then
          Console.WriteLine("Data created at {0}", data.CreationTime)      
      Else
          Console.WriteLine("mc2 not found in the table.")
      End If
   End Sub
End Module

Public Class ManagedClass
End Class

Public Class ClassData
   Public CreationTime As DateTime
   Public Data As Object   
   
   Public Sub New()
      Me.CreationTime = DateTime.Now
      Me.Data  = New Object()     
   End Sub
End Class
' The example displays the following output:
'       No strong reference to mc2 exists.

備註

ConditionalWeakTable<TKey,TValue> 類別可讓語言編譯程式在運行時間將任意屬性附加至Managed物件。 ConditionalWeakTable<TKey,TValue> 對像是一個字典，該字典會將Managed物件系結成索引鍵所代表的索引鍵，以及由值表示的附加屬性。物件的索引鍵是附加屬性之 TKey 類別的個別實例，而其值則是指派給對應對象的屬性值。

索引鍵必須是唯一的;換句話說，ConditionalWeakTable<TKey,TValue> 類別支援每個 Managed 物件的一個附加值。如果將兩個索引鍵傳遞至 Object.ReferenceEquals 方法，則會傳回 true。

備註

您無法藉由覆寫 Object.GetHashCode 來明確設定索引鍵的哈希碼來控制相等比較。 ConditionalWeakTable<TKey,TValue> 類別不會使用 Object.GetHashCode 方法來計算哈希碼，因此不會叫用 Object.GetHashCode 覆寫。

雖然 ConditionalWeakTable<TKey,TValue> 類別會保存索引鍵/值組的集合，但最好將其視為數據表，而不是字典物件。 ConditionalWeakTable<TKey,TValue> 類別與字典有幾種不同：

它不會儲存金鑰。也就是說，索引鍵不會只保持運作，因為它是集合的成員。
它不包含字典通常擁有的所有方法（例如 GetEnumerator 或 Contains）。
它不會實作 IDictionary<TKey,TValue> 介面。

ConditionalWeakTable<TKey,TValue> 類別與其他集合物件在管理儲存在集合中之索引鍵的物件存留期時不同。一般而言，當物件儲存在集合中時，其存留期會持續到移除它為止（而且沒有物件的其他參考），或直到集合物件本身被終結為止。不過，在 ConditionalWeakTable<TKey,TValue> 類別中，將索引鍵/值組新增至數據表並不保證索引鍵會保存，即使可以直接從儲存在數據表中的值到達它（例如，如果數據表包含一個索引鍵、A，且值為 V1，而第二個索引鍵 B，其值為 P2 且包含 A 的參考）。相反地，ConditionalWeakTable<TKey,TValue> 只要數據表外部沒有其他索引鍵參考，就會自動移除索引鍵/值專案。此範例提供圖例。

建構函式

ConditionalWeakTable<TKey,TValue>()

初始化 ConditionalWeakTable<TKey,TValue> 類別的新實例。

方法

Add(TKey, TValue)	將索引鍵新增至數據表。
AddOrUpdate(TKey, TValue)	如果索引鍵不存在，請新增索引鍵和值，或如果索引鍵存在，則會更新現有的索引鍵值。
Clear()	清除所有索引鍵/值組。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
Finalize()	確保當垃圾收集行程回收 ConditionalWeakTable<TKey,TValue> 物件時，會釋放資源，並執行其他清除作業。
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetOrCreateValue(TKey)	以不可部分完成的方式搜尋數據表中的指定索引鍵，並傳回對應的值。如果索引鍵不存在於數據表中，方法會叫用類別的無參數建構函式，此建構函式代表數據表的值，以建立系結至指定索引鍵的值。
GetType()	取得目前實例的 Type。 (繼承來源 Object)
GetValue(TKey, ConditionalWeakTable<TKey,TValue>.CreateValueCallback)	以不可部分完成的方式搜尋數據表中的指定索引鍵，並傳回對應的值。如果數據表中沒有索引鍵，方法會叫用回呼方法，以建立系結至指定索引鍵的值。
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
Remove(TKey)	從數據表中移除索引鍵及其值。
ToString()	傳回表示目前物件的字串。 (繼承來源 Object)
TryAdd(TKey, TValue)	如果索引鍵不存在，就會將索引鍵新增至數據表。
TryGetValue(TKey, TValue)	取得指定索引鍵的值。

明確介面實作

IEnumerable.GetEnumerator()	傳回可用來逐一查看 ConditionalWeakTable<TKey,TValue> 數據表的列舉值。
IEnumerable<KeyValuePair<TKey,TValue>>.GetEnumerator()	傳回可用來逐一查看 ConditionalWeakTable<TKey,TValue> 數據表的列舉值。

擴充方法

ToFrozenDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	根據指定的索引鍵選取器函式，從 IEnumerable<T> 建立 FrozenDictionary<TKey,TValue>。
ToFrozenDictionary<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)	根據指定的索引鍵選取器和項目選取器函式，從 IEnumerable<T> 建立 FrozenDictionary<TKey,TValue>。
ToFrozenSet<T>(IEnumerable<T>, IEqualityComparer<T>)	使用指定的值建立 FrozenSet<T>。
ToImmutableArray<TSource>(IEnumerable<TSource>)	從指定的集合建立不可變的陣列。
ToImmutableDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	從現有的專案集合建構不可變的字典，將轉換函式套用至來源索引鍵。
ToImmutableDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	根據序列的一些轉換，建構不可變的字典。
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>)	列舉和轉換序列，併產生其內容的不可變字典。
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IEqualityComparer<TKey>)	列舉和轉換序列，並使用指定的索引鍵比較子產生其內容的不可變字典。
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IEqualityComparer<TKey>, IEqualityComparer<TValue>)	列舉和轉換序列，並使用指定的索引鍵和值比較子產生其內容的不可變字典。
ToImmutableHashSet<TSource>(IEnumerable<TSource>)	列舉序列，併產生其內容的不可變哈希集。
ToImmutableHashSet<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>)	列舉序列、產生其內容的不可變哈希集，並使用集合類型的指定相等比較子。
ToImmutableList<TSource>(IEnumerable<TSource>)	列舉序列，併產生其內容的不可變清單。
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>)	列舉和轉換序列，併產生其內容的不可變排序字典。
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IComparer<TKey>)	列舉和轉換序列，並使用指定的索引鍵比較子產生其內容的不可變排序字典。
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IComparer<TKey>, IEqualityComparer<TValue>)	列舉和轉換序列，並使用指定的索引鍵和值比較子產生其內容的不可變排序字典。
ToImmutableSortedSet<TSource>(IEnumerable<TSource>)	列舉序列，併產生其內容的不可變排序集。
ToImmutableSortedSet<TSource>(IEnumerable<TSource>, IComparer<TSource>)	列舉序列、產生其內容的不可變排序集，並使用指定的比較子。
CopyToDataTable<T>(IEnumerable<T>)	傳回包含 DataRow 物件複本的 DataTable，指定泛型參數 `T`DataRow的輸入 IEnumerable<T> 物件。
CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption)	將 DataRow 物件複製到指定的 DataTable，指定輸入 IEnumerable<T> 物件，其中泛型參數 `T` 是 DataRow。
CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption, FillErrorEventHandler)	將 DataRow 物件複製到指定的 DataTable，指定輸入 IEnumerable<T> 物件，其中泛型參數 `T` 是 DataRow。
Aggregate<TSource>(IEnumerable<TSource>, Func<TSource,TSource,TSource>)	在序列上套用累加器函式。
Aggregate<TSource,TAccumulate>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>)	在序列上套用累加器函式。指定的種子值會當做初始累加器值使用。
Aggregate<TSource,TAccumulate,TResult>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>, Func<TAccumulate,TResult>)	在序列上套用累加器函式。指定的種子值會當做初始累加器值使用，而指定的函式則用來選取結果值。
AggregateBy<TSource,TKey,TAccumulate>(IEnumerable<TSource>, Func<TSource, TKey>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>, IEqualityComparer<TKey>)	可讓編譯程式以動態方式將物件字段附加至 Managed 物件。
AggregateBy<TSource,TKey,TAccumulate>(IEnumerable<TSource>, Func<TSource, TKey>, Func<TKey,TAccumulate>, Func<TAccumulate,TSource,TAccumulate>, IEqualityComparer<TKey>)	可讓編譯程式以動態方式將物件字段附加至 Managed 物件。
All<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	判斷序列的所有專案是否符合條件。
Any<TSource>(IEnumerable<TSource>)	判斷序列是否包含任何專案。
Any<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	判斷序列的任何專案是否符合條件。
Append<TSource>(IEnumerable<TSource>, TSource)	將值附加至序列結尾。
AsEnumerable<TSource>(IEnumerable<TSource>)	傳回輸入類型為 IEnumerable<T>。
Average<TSource>(IEnumerable<TSource>, Func<TSource,Decimal>)	計算 Decimal 值序列的平均值，這些值是在輸入序列的每個元素上叫用轉換函式所取得。
Average<TSource>(IEnumerable<TSource>, Func<TSource,Double>)	計算 Double 值序列的平均值，這些值是在輸入序列的每個元素上叫用轉換函式所取得。
Average<TSource>(IEnumerable<TSource>, Func<TSource,Int32>)	計算 Int32 值序列的平均值，這些值是在輸入序列的每個元素上叫用轉換函式所取得。
Average<TSource>(IEnumerable<TSource>, Func<TSource,Int64>)	計算 Int64 值序列的平均值，這些值是在輸入序列的每個元素上叫用轉換函式所取得。
Average<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Decimal>>)	計算在輸入序列的每個元素上叫用轉換函式所取得之可為 Null Decimal 值序列的平均值。
Average<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Double>>)	計算在輸入序列的每個元素上叫用轉換函式所取得之可為 Null Double 值序列的平均值。
Average<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Int32>>)	計算在輸入序列的每個元素上叫用轉換函式所取得之可為 Null Int32 值序列的平均值。
Average<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Int64>>)	計算在輸入序列的每個元素上叫用轉換函式所取得之可為 Null Int64 值序列的平均值。
Average<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Single>>)	計算在輸入序列的每個元素上叫用轉換函式所取得之可為 Null Single 值序列的平均值。
Average<TSource>(IEnumerable<TSource>, Func<TSource,Single>)	計算 Single 值序列的平均值，這些值是在輸入序列的每個元素上叫用轉換函式所取得。
Cast<TResult>(IEnumerable)	將 IEnumerable 的項目轉換成指定的型別。
Chunk<TSource>(IEnumerable<TSource>, Int32)	將序列的專案分割成大社區塊，最多 `size`。
Concat<TSource>(IEnumerable<TSource>, IEnumerable<TSource>)	串連兩個序列。
Contains<TSource>(IEnumerable<TSource>, TSource)	判斷序列是否使用預設相等比較子來包含指定的專案。
Contains<TSource>(IEnumerable<TSource>, TSource, IEqualityComparer<TSource>)	使用指定的 IEqualityComparer<T>，判斷序列是否包含指定的專案。
Count<TSource>(IEnumerable<TSource>)	傳回序列中的項目數目。
Count<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	傳回數位，代表指定序列中滿足條件的項目數目。
CountBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	可讓編譯程式以動態方式將物件字段附加至 Managed 物件。
DefaultIfEmpty<TSource>(IEnumerable<TSource>)	如果序列是空的，則傳回指定序列的專案或單一集合中型別參數的預設值。
DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource)	如果序列是空的，則傳回指定序列的專案或單一集合中的指定值。
Distinct<TSource>(IEnumerable<TSource>)	使用預設相等比較子來比較值，從序列傳回不同的專案。
Distinct<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>)	使用指定的 IEqualityComparer<T> 來比較值，從序列傳回不同的專案。
DistinctBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	根據指定的索引鍵選取器函式，從序列傳回不同的專案。
DistinctBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	根據指定的索引鍵選取器函式，並使用指定的比較子來比較索引鍵，從序列傳回不同的專案。
ElementAt<TSource>(IEnumerable<TSource>, Index)	傳回序列中指定索引處的專案。
ElementAt<TSource>(IEnumerable<TSource>, Int32)	傳回序列中指定索引處的專案。
ElementAtOrDefault<TSource>(IEnumerable<TSource>, Index)	傳回序列中指定索引處的專案，如果索引超出範圍，則傳回預設值。
ElementAtOrDefault<TSource>(IEnumerable<TSource>, Int32)	傳回序列中指定索引處的專案，如果索引超出範圍，則傳回預設值。
Except<TSource>(IEnumerable<TSource>, IEnumerable<TSource>)	使用預設相等比較子來比較值，產生兩個序列的集合差異。
Except<TSource>(IEnumerable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)	使用指定的 IEqualityComparer<T> 來比較值，產生兩個序列的集合差異。
ExceptBy<TSource,TKey>(IEnumerable<TSource>, IEnumerable<TKey>, Func<TSource,TKey>)	根據指定的索引鍵選取器函式，產生兩個序列的集合差異。
ExceptBy<TSource,TKey>(IEnumerable<TSource>, IEnumerable<TKey>, Func<TSource,TKey>, IEqualityComparer<TKey>)	根據指定的索引鍵選取器函式，產生兩個序列的集合差異。
First<TSource>(IEnumerable<TSource>)	傳回序列的第一個專案。
First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	傳回序列中符合指定條件的第一個專案。
FirstOrDefault<TSource>(IEnumerable<TSource>)	傳回序列的第一個專案，如果序列不包含任何專案，則傳回預設值。
FirstOrDefault<TSource>(IEnumerable<TSource>, TSource)	傳回序列的第一個專案，如果序列不包含任何專案，則傳回指定的預設值。
FirstOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	傳回序列的第一個專案，如果找不到這類專案，則為符合條件或預設值。
FirstOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>, TSource)	傳回序列中符合條件的第一個專案，如果沒有找到這類專案，則傳回指定的預設值。
GroupBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	根據指定的索引鍵選取器函式，將序列的專案分組。
GroupBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	根據指定的索引鍵選取器函式將序列的專案分組，並使用指定的比較子比較索引鍵。
GroupBy<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>)	根據指定的索引鍵選取器函式將序列的專案分組，並使用指定的函式來投影每個群組的專案。
GroupBy<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)	根據索引鍵選取器函式，將序列的專案分組。索引鍵是使用比較子來比較，而且每個群組的元素都是使用指定的函式來投影。
GroupBy<TSource,TKey,TResult>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TKey,IEnumerable<TSource>,TResult>)	根據指定的索引鍵選取器函式，將序列的專案分組，並從每個群組及其索引鍵建立結果值。
GroupBy<TSource,TKey,TResult>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TKey,IEnumerable<TSource>,TResult>, IEqualityComparer<TKey>)	根據指定的索引鍵選取器函式，將序列的專案分組，並從每個群組及其索引鍵建立結果值。使用指定的比較子來比較索引鍵。
GroupBy<TSource,TKey,TElement,TResult>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, Func<TKey,IEnumerable<TElement>,TResult>)	根據指定的索引鍵選取器函式，將序列的專案分組，並從每個群組及其索引鍵建立結果值。每個群組的項目都會使用指定的函式來投影。
GroupBy<TSource,TKey,TElement,TResult>(IEnumerable<TSource>, Func<TSource, TKey>, Func<TSource,TElement>, Func<TKey,IEnumerable<TElement>, TResult>, IEqualityComparer<TKey>)	根據指定的索引鍵選取器函式，將序列的專案分組，並從每個群組及其索引鍵建立結果值。索引鍵值是使用指定的比較子來比較，而每個群組的元素都是使用指定的函式來投影。
GroupJoin<TOuter,TInner,TKey,TResult>(IEnumerable<TOuter>, IEnumerable<TInner>, Func<TOuter,TKey>, Func<TInner,TKey>, Func<TOuter,IEnumerable<TInner>, TResult>)	根據索引鍵的相等性，將兩個序列的專案相互關聯，並將結果分組。默認相等比較子可用來比較索引鍵。
GroupJoin<TOuter,TInner,TKey,TResult>(IEnumerable<TOuter>, IEnumerable<TInner>, Func<TOuter,TKey>, Func<TInner,TKey>, Func<TOuter,IEnumerable<TInner>, TResult>, IEqualityComparer<TKey>)	根據索引鍵相等將兩個序列的專案相互關聯，並將結果分組。指定的 IEqualityComparer<T> 可用來比較索引鍵。
Index<TSource>(IEnumerable<TSource>)	傳回可列舉，將元素的索引併入 Tuple 中。
Intersect<TSource>(IEnumerable<TSource>, IEnumerable<TSource>)	使用預設相等比較子比較值來產生兩個序列的集合交集。
Intersect<TSource>(IEnumerable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)	使用指定的 IEqualityComparer<T> 來比較值，產生兩個序列的集合交集。
IntersectBy<TSource,TKey>(IEnumerable<TSource>, IEnumerable<TKey>, Func<TSource,TKey>)	根據指定的索引鍵選取器函式，產生兩個序列的集合交集。
IntersectBy<TSource,TKey>(IEnumerable<TSource>, IEnumerable<TKey>, Func<TSource,TKey>, IEqualityComparer<TKey>)	根據指定的索引鍵選取器函式，產生兩個序列的集合交集。
Join<TOuter,TInner,TKey,TResult>(IEnumerable<TOuter>, IEnumerable<TInner>, Func<TOuter,TKey>, Func<TInner,TKey>, Func<TOuter,TInner,TResult>)	根據比對索引鍵，將兩個序列的專案相互關聯。默認相等比較子可用來比較索引鍵。
Join<TOuter,TInner,TKey,TResult>(IEnumerable<TOuter>, IEnumerable<TInner>, Func<TOuter,TKey>, Func<TInner,TKey>, Func<TOuter,TInner,TResult>, IEqualityComparer<TKey>)	根據比對索引鍵，將兩個序列的專案相互關聯。指定的 IEqualityComparer<T> 可用來比較索引鍵。
Last<TSource>(IEnumerable<TSource>)	傳回序列的最後一個專案。
Last<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	傳回符合指定條件之序列的最後一個專案。
LastOrDefault<TSource>(IEnumerable<TSource>)	傳回序列的最後一個專案，如果序列不包含任何專案，則傳回預設值。
LastOrDefault<TSource>(IEnumerable<TSource>, TSource)	傳回序列的最後一個專案，如果序列不包含任何專案，則傳回指定的預設值。
LastOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	傳回序列的最後一個專案，如果找不到這類專案，則為符合條件或預設值。
LastOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>, TSource)	傳回符合條件之序列的最後一個專案，如果沒有找到這類專案，則傳回指定的預設值。
LongCount<TSource>(IEnumerable<TSource>)	傳回代表序列中項目總數的 Int64。
LongCount<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	傳回 Int64，代表序列中滿足條件的項目數目。
Max<TSource>(IEnumerable<TSource>)	傳回泛型序列中的最大值。
Max<TSource>(IEnumerable<TSource>, IComparer<TSource>)	傳回泛型序列中的最大值。
Max<TSource>(IEnumerable<TSource>, Func<TSource,Decimal>)	在序列的每個元素上叫用轉換函式，並傳回最大 Decimal 值。
Max<TSource>(IEnumerable<TSource>, Func<TSource,Double>)	在序列的每個元素上叫用轉換函式，並傳回最大 Double 值。
Max<TSource>(IEnumerable<TSource>, Func<TSource,Int32>)	在序列的每個元素上叫用轉換函式，並傳回最大 Int32 值。
Max<TSource>(IEnumerable<TSource>, Func<TSource,Int64>)	在序列的每個元素上叫用轉換函式，並傳回最大 Int64 值。
Max<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Decimal>>)	在序列的每個元素上叫用轉換函式，並傳回可為 Null 的最大 Decimal 值。
Max<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Double>>)	在序列的每個元素上叫用轉換函式，並傳回可為 Null 的最大 Double 值。
Max<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Int32>>)	在序列的每個元素上叫用轉換函式，並傳回可為 Null 的最大 Int32 值。
Max<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Int64>>)	在序列的每個元素上叫用轉換函式，並傳回可為 Null 的最大 Int64 值。
Max<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Single>>)	在序列的每個元素上叫用轉換函式，並傳回可為 Null 的最大 Single 值。
Max<TSource>(IEnumerable<TSource>, Func<TSource,Single>)	在序列的每個元素上叫用轉換函式，並傳回最大 Single 值。
Max<TSource,TResult>(IEnumerable<TSource>, Func<TSource,TResult>)	在泛型序列的每個專案上叫用轉換函式，並傳回產生的最大值。
MaxBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	根據指定的索引鍵選取器函式，傳回泛型序列中的最大值。
MaxBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IComparer<TKey>)	根據指定的索引鍵選取器函式和索引鍵比較子，傳回泛型序列中的最大值。
Min<TSource>(IEnumerable<TSource>)	傳回泛型序列中的最小值。
Min<TSource>(IEnumerable<TSource>, IComparer<TSource>)	傳回泛型序列中的最小值。
Min<TSource>(IEnumerable<TSource>, Func<TSource,Decimal>)	在序列的每個元素上叫用轉換函式，並傳回最小值 Decimal 值。
Min<TSource>(IEnumerable<TSource>, Func<TSource,Double>)	在序列的每個元素上叫用轉換函式，並傳回最小值 Double 值。
Min<TSource>(IEnumerable<TSource>, Func<TSource,Int32>)	在序列的每個元素上叫用轉換函式，並傳回最小值 Int32 值。
Min<TSource>(IEnumerable<TSource>, Func<TSource,Int64>)	在序列的每個元素上叫用轉換函式，並傳回最小值 Int64 值。
Min<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Decimal>>)	在序列的每個專案上叫用轉換函式，並傳回可為 null 的最小值 Decimal 值。
Min<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Double>>)	在序列的每個專案上叫用轉換函式，並傳回可為 null 的最小值 Double 值。
Min<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Int32>>)	在序列的每個專案上叫用轉換函式，並傳回可為 null 的最小值 Int32 值。
Min<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Int64>>)	在序列的每個專案上叫用轉換函式，並傳回可為 null 的最小值 Int64 值。
Min<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Single>>)	在序列的每個專案上叫用轉換函式，並傳回可為 null 的最小值 Single 值。
Min<TSource>(IEnumerable<TSource>, Func<TSource,Single>)	在序列的每個元素上叫用轉換函式，並傳回最小值 Single 值。
Min<TSource,TResult>(IEnumerable<TSource>, Func<TSource,TResult>)	在泛型序列的每個專案上叫用轉換函式，並傳回產生的最小值。
MinBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	根據指定的索引鍵選取器函式，傳回泛型序列中的最小值。
MinBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IComparer<TKey>)	根據指定的索引鍵選取器函式和索引鍵比較子，傳回泛型序列中的最小值。
OfType<TResult>(IEnumerable)	根據指定的型別篩選 IEnumerable 的專案。
Order<T>(IEnumerable<T>)	以遞增順序排序序列的專案。
Order<T>(IEnumerable<T>, IComparer<T>)	以遞增順序排序序列的專案。
OrderBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	根據索引鍵，以遞增順序排序序列的專案。
OrderBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IComparer<TKey>)	使用指定的比較子，以遞增順序排序序列的專案。
OrderByDescending<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	根據索引鍵，以遞減順序排序序列的專案。
OrderByDescending<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IComparer<TKey>)	使用指定的比較子，以遞減順序排序序列的專案。
OrderDescending<T>(IEnumerable<T>)	依遞減順序排序序列的專案。
OrderDescending<T>(IEnumerable<T>, IComparer<T>)	依遞減順序排序序列的專案。
Prepend<TSource>(IEnumerable<TSource>, TSource)	將值加入序列的開頭。
Reverse<TSource>(IEnumerable<TSource>)	反轉序列中項目的順序。
Select<TSource,TResult>(IEnumerable<TSource>, Func<TSource,TResult>)	將序列的每個專案投影成新的表單。
Select<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,TResult>)	藉由合併元素的索引，將序列的每個專案投影成新的表單。
SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TResult>>)	將序列的每個專案投影到 IEnumerable<T>，並將產生的序列扁平化成一個序列。
SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TResult>>)	將序列的每個專案投影至 IEnumerable<T>，並將產生的序列扁平化成一個序列。每個來源專案的索引會以該專案的投影形式使用。
SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>)	將序列的每個專案投影到 IEnumerable<T>，將產生的序列扁平化成一個序列，並在其中的每個元素上叫用結果選取器函式。
SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>)	將序列的每個專案投影到 IEnumerable<T>，將產生的序列扁平化成一個序列，並在其中的每個元素上叫用結果選取器函式。每個來源專案的索引會用於該專案的中繼投影形式。
SequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>)	判斷兩個序列是否相等，方法是使用其型別的默認相等比較子來比較專案。
SequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)	使用指定的 IEqualityComparer<T>，判斷兩個序列是否相等。
Single<TSource>(IEnumerable<TSource>)	傳回序列的唯一專案，如果序列中沒有一個專案，則會擲回例外狀況。
Single<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	傳回序列中唯一符合指定條件的專案，如果有多個這類專案存在，則會擲回例外狀況。
SingleOrDefault<TSource>(IEnumerable<TSource>)	傳回序列的唯一專案;如果序列是空的，則傳回預設值;如果序列中有多個項目，這個方法會擲回例外狀況。
SingleOrDefault<TSource>(IEnumerable<TSource>, TSource)	傳回序列的唯一專案，如果序列是空的，則傳回指定的預設值;如果序列中有多個項目，這個方法會擲回例外狀況。
SingleOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	傳回序列中唯一符合指定條件的專案，如果沒有這類專案，則傳回預設值;如果一個以上的專案符合條件，這個方法會擲回例外狀況。
SingleOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>, TSource)	傳回序列中唯一符合指定條件的專案，如果沒有這類專案，則傳回指定的預設值;如果一個以上的專案符合條件，這個方法會擲回例外狀況。
Skip<TSource>(IEnumerable<TSource>, Int32)	略過序列中指定數目的專案，然後傳回其餘專案。
SkipLast<TSource>(IEnumerable<TSource>, Int32)	傳回新的可列舉集合，其中包含 `source` 的專案，並省略來源集合的最後一個 `count` 專案。
SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	只要指定的條件為 true，就會略過序列中的項目，然後傳回其餘元素。
SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>)	只要指定的條件為 true，就會略過序列中的項目，然後傳回其餘元素。元素的索引用於述詞函式的邏輯中。
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Decimal>)	計算 Decimal 值序列的總和，這些值是在輸入序列的每個元素上叫用轉換函式所取得。
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Double>)	計算 Double 值序列的總和，這些值是在輸入序列的每個元素上叫用轉換函式所取得。
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Int32>)	計算 Int32 值序列的總和，這些值是在輸入序列的每個元素上叫用轉換函式所取得。
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Int64>)	計算 Int64 值序列的總和，這些值是在輸入序列的每個元素上叫用轉換函式所取得。
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Decimal>>)	計算在輸入序列的每個元素上叫用轉換函式所取得之可為 Null Decimal 值的序列總和。
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Double>>)	計算在輸入序列的每個元素上叫用轉換函式所取得之可為 Null Double 值的序列總和。
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Int32>>)	計算在輸入序列的每個元素上叫用轉換函式所取得之可為 Null Int32 值的序列總和。
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Int64>>)	計算在輸入序列的每個元素上叫用轉換函式所取得之可為 Null Int64 值的序列總和。
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Single>>)	計算在輸入序列的每個元素上叫用轉換函式所取得之可為 Null Single 值的序列總和。
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Single>)	計算 Single 值序列的總和，這些值是在輸入序列的每個元素上叫用轉換函式所取得。
Take<TSource>(IEnumerable<TSource>, Int32)	從序列開頭傳回指定的連續項目數目。
Take<TSource>(IEnumerable<TSource>, Range)	傳回序列中連續專案的指定範圍。
TakeLast<TSource>(IEnumerable<TSource>, Int32)	傳回新的可列舉集合，其中包含來自 `source`的最後一個 `count` 專案。
TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	只要指定的條件為 true，就會從序列傳回專案。
TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>)	只要指定的條件為 true，就會從序列傳回專案。元素的索引用於述詞函式的邏輯中。
ToArray<TSource>(IEnumerable<TSource>)	從 IEnumerable<T>建立陣列。
ToDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	根據指定的索引鍵選取器函式，從 IEnumerable<T> 建立 Dictionary<TKey,TValue>。
ToDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	根據指定的索引鍵選取器函式和索引鍵比較子，從 IEnumerable<T> 建立 Dictionary<TKey,TValue>。
ToDictionary<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>)	根據指定的索引鍵選取器和項目選取器函式，從 IEnumerable<T> 建立 Dictionary<TKey,TValue>。
ToDictionary<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)	根據指定的索引鍵選取器函式、比較子和元素選取器函式，從 IEnumerable<T> 建立 Dictionary<TKey,TValue>。
ToHashSet<TSource>(IEnumerable<TSource>)	從 IEnumerable<T>建立 HashSet<T>。
ToHashSet<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>)	使用 `comparer` 比較索引鍵，從 IEnumerable<T> 建立 HashSet<T>。
ToList<TSource>(IEnumerable<TSource>)	從 IEnumerable<T>建立 List<T>。
ToLookup<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	根據指定的索引鍵選取器函式，從 IEnumerable<T> 建立 Lookup<TKey,TElement>。
ToLookup<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	根據指定的索引鍵選取器函式和索引鍵比較子，從 IEnumerable<T> 建立 Lookup<TKey,TElement>。
ToLookup<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>)	根據指定的索引鍵選取器和項目選取器函式，從 IEnumerable<T> 建立 Lookup<TKey,TElement>。
ToLookup<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)	根據指定的索引鍵選取器函式、比較子和元素選取器函式，從 IEnumerable<T> 建立 Lookup<TKey,TElement>。
TryGetNonEnumeratedCount<TSource>(IEnumerable<TSource>, Int32)	嘗試判斷序列中的項目數目，而不強制列舉。
Union<TSource>(IEnumerable<TSource>, IEnumerable<TSource>)	使用預設相等比較子產生兩個序列的集合聯集。
Union<TSource>(IEnumerable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)	使用指定的 IEqualityComparer<T>產生兩個序列的集合聯集。
UnionBy<TSource,TKey>(IEnumerable<TSource>, IEnumerable<TSource>, Func<TSource,TKey>)	根據指定的索引鍵選取器函式，產生兩個序列的集合聯集。
UnionBy<TSource,TKey>(IEnumerable<TSource>, IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	根據指定的索引鍵選取器函式，產生兩個序列的集合聯集。
Where<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	根據述詞篩選值序列。
Where<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>)	根據述詞篩選值序列。每個元素的索引都會用於述詞函式的邏輯中。
Zip<TFirst,TSecond>(IEnumerable<TFirst>, IEnumerable<TSecond>)	產生具有來自兩個指定序列之元素的 Tuple 序列。
Zip<TFirst,TSecond,TThird>(IEnumerable<TFirst>, IEnumerable<TSecond>, IEnumerable<TThird>)	產生具有來自三個指定序列之元素的 Tuple 序列。
Zip<TFirst,TSecond,TResult>(IEnumerable<TFirst>, IEnumerable<TSecond>, Func<TFirst,TSecond,TResult>)	將指定的函式套用至兩個序列的對應專案，產生結果序列。
AsParallel(IEnumerable)	啟用查詢的平行處理。
AsParallel<TSource>(IEnumerable<TSource>)	啟用查詢的平行處理。
AsQueryable(IEnumerable)	將 IEnumerable 轉換成 IQueryable。
AsQueryable<TElement>(IEnumerable<TElement>)	將泛型 IEnumerable<T> 轉換成泛型 IQueryable<T>。
Ancestors<T>(IEnumerable<T>)	傳回專案集合，其中包含來源集合中每個節點的上階。
Ancestors<T>(IEnumerable<T>, XName)	傳回元素的篩選集合，其中包含來源集合中每個節點的上階。集合中只會包含具有相符 XName 的專案。
DescendantNodes<T>(IEnumerable<T>)	傳回來源集合中每個文件和專案之子代節點的集合。
Descendants<T>(IEnumerable<T>)	傳回專案集合，其中包含來源集合中每個元素和檔的子代專案。
Descendants<T>(IEnumerable<T>, XName)	傳回篩選的專案集合，其中包含來源集合中每個元素和檔的子代專案。集合中只會包含具有相符 XName 的專案。
Elements<T>(IEnumerable<T>)	傳回來源集合中每個專案和檔的子專案集合。
Elements<T>(IEnumerable<T>, XName)	傳回來源集合中每個專案和檔之子項目的篩選集合。集合中只會包含具有相符 XName 的專案。
InDocumentOrder<T>(IEnumerable<T>)	傳回包含來源集合中所有節點的節點集合，依檔順序排序。
Nodes<T>(IEnumerable<T>)	傳回來源集合中每個檔和專案之子節點的集合。
Remove<T>(IEnumerable<T>)	從來源集合的父節點中移除每個節點。

適用於

產品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

執行緒安全性

ConditionalWeakTable<TKey,TValue> 類別的實例是安全線程。他們不需要呼叫端執行任何其他鎖定。

分享方式：