SemanticValue 類別

參考

定義

命名空間:: System.Speech.Recognition

組件:: System.Speech.dll

套件:: System.Speech v8.0.0

套件:: System.Speech v9.0.0-preview.7.24405.7

來源:: SemanticValue.cs

來源:: SemanticValue.cs

來源:: SemanticValue.cs

重要

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

表示已辨識片語意組織。

public ref class SemanticValue sealed : System::Collections::Generic::ICollection<System::Collections::Generic::KeyValuePair<System::String ^, System::Speech::Recognition::SemanticValue ^>>, System::Collections::Generic::IDictionary<System::String ^, System::Speech::Recognition::SemanticValue ^>, System::Collections::Generic::IEnumerable<System::Collections::Generic::KeyValuePair<System::String ^, System::Speech::Recognition::SemanticValue ^>>

[System.Serializable]
public sealed class SemanticValue : System.Collections.Generic.ICollection<System.Collections.Generic.KeyValuePair<string,System.Speech.Recognition.SemanticValue>>, System.Collections.Generic.IDictionary<string,System.Speech.Recognition.SemanticValue>, System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<string,System.Speech.Recognition.SemanticValue>>

public sealed class SemanticValue : System.Collections.Generic.ICollection<System.Collections.Generic.KeyValuePair<string,System.Speech.Recognition.SemanticValue>>, System.Collections.Generic.IDictionary<string,System.Speech.Recognition.SemanticValue>, System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<string,System.Speech.Recognition.SemanticValue>>

[<System.Serializable>]
type SemanticValue = class
    interface IDictionary<string, SemanticValue>
    interface ICollection<KeyValuePair<string, SemanticValue>>
    interface seq<KeyValuePair<string, SemanticValue>>
    interface IEnumerable

type SemanticValue = class
    interface ICollection<KeyValuePair<string, SemanticValue>>
    interface seq<KeyValuePair<string, SemanticValue>>
    interface IEnumerable
    interface IDictionary<string, SemanticValue>

Public NotInheritable Class SemanticValue
Implements ICollection(Of KeyValuePair(Of String, SemanticValue)), IDictionary(Of String, SemanticValue), IEnumerable(Of KeyValuePair(Of String, SemanticValue))

繼承: Object
SemanticValue

屬性: SerializableAttribute

實作: ICollection<KeyValuePair<String,SemanticValue>> ICollection<KeyValuePair<TKey,TValue>> IDictionary<String,SemanticValue> IEnumerable<KeyValuePair<String,SemanticValue>> IEnumerable<KeyValuePair<TKey,TValue>> IEnumerable<T> IEnumerable

範例

下列範例顯示 SpeechRecognized 事件的處理程式，其設計目的是要處理變更前景和背景色彩的命令。

處理程式會偵測零的 Count 和 null的 Value，來識別沒有基礎語意結構的辨識詞組。接著，藉由剖析原始文字，即可直接處理此辨識輸出。

在其他情況下，處理程式會使用索引鍵來取得色彩名稱的 RGB 元件、判斷命令是否會變更前景或背景，或指出找不到有效的索引鍵。

newGrammar.SpeechRecognized +=  
  delegate(object sender, SpeechRecognizedEventArgs eventArgs)   
  {  

    // Retrieve the value of the semantic property.  
    bool changeBackGround = true;  
    string errorString = "";  
    SemanticValue semantics = eventArgs.Result.Semantics;  

    Color newColor = Color.Empty;  

    try   
    {  
      if (semantics.Count == 0 && semantics.Value==null)  
      {  
        // Signifies recognition by a grammar with no semantics.  
        // Parse the string, assuming that the last word is color,  
        // and search for "background" or "foreground" in the input.  
        if (eventArgs.Result.Text.Contains("foreground"))   
        {  
          changeBackGround = false;  
        }  
        string cName = eventArgs.Result.Words[eventArgs.Result.Words.Count - 1].Text;  
        newColor = Color.FromName(cName);  

      }  
      else if (semantics.ContainsKey("colorStringList") ^ semantics.ContainsKey("colorRGBValueList"))   
      {  

        // Determine whether to change background or foreground.  
        if (semantics.ContainsKey("applyChgToBackground"))   
        {  
          changeBackGround = semantics["applyChgToBackground"].Value is bool;  
        }  

        // Get the RGB color value.  
        if (semantics.ContainsKey("colorStringList"))   
        {  
          newColor = Color.FromName((string)semantics["colorStringList"].Value);  
        }  
        if (semantics.ContainsKey("colorRGBValueList"))   
        {  
          newColor = System.Drawing.Color.FromArgb((int)semantics["colorRGBValueList"].Value);  
        }  
      }  
      else   
      {  

        // Throw an exception if the semantics do not contain the keys we  
        // support.  
        throw(new Exception("Unsupported semantics keys found."));  
      }  
    }  

    catch (Exception exp)   
    {  
      MessageBox.Show(String.Format("Unable to process color semantics.:\n{0}\n", exp.Message));  
      return;  
    }  

    // Change colors, either foreground or background.  
    if (changeBackGround)   
    {  
      BackColor = newColor;  
      float Bright = BackColor.GetBrightness();  
      float Hue = BackColor.GetHue();  
      float Sat = BackColor.GetSaturation();  

      // Make sure that text is readable regardless of the background.  
      if (BackColor.GetBrightness() <= .50)   
      {  
        ForeColor = Color.White;  
      }  
      else   
      {  
        ForeColor = Color.Black;  
      }  
    }  
    else   
    {  
      ForeColor = newColor;  
      float Bright = ForeColor.GetBrightness();  
      float Hue = ForeColor.GetHue();  
      float Sat = ForeColor.GetSaturation();  

      // Make sure that text is readable regardless of Foreground.  
      if (ForeColor.GetBrightness() <= .50)   
      {  
        BackColor = Color.White;  
      }  
      else   
      {  
        BackColor = Color.Black;  
      }  
    }  
    return;  
  };

備註

SemanticValue 是在 System.Speech 中實作語意技術的主要物件。語意解譯可讓文法定義辨識引擎用來正確解譯音訊輸入的規則。語意解譯也可讓辨識引擎組織其結果，以便更容易處理，而不是只傳回可辨識的字組和字組序列。

例如，辨識引擎輸出「將背景變更為紅色」必須由應用程式剖析和解譯，才能採取行動。 Grammar 物件可以指定語意解譯，藉由指定片語具有兩個語意子結構，一個用於選取背景或前景（以文字 “background 代表”），另一個用於選取色彩（以文字 “red 表示” ）。

System.Speech 代表 SemanticValue 物件樹狀結構中辨識作業的語意。

每個 SemanticValue 實體都包含下列專案：

透過 Value 屬性存取的 Object，用來索引 SemanticValue實例。
由 Confidence 屬性傳回之語意剖析精確度的量值。
子物件的名稱/值組集合（KeyValuePair<TKey,TValue>），這些物件也是 SemanticValue 實例。子節點可透過使用字串查閱索引鍵和 SemanticValue 實例的 SemanticValue 實作來存取 IDictionary<TKey,TValue>，如下列範例所示。
```
foreach (KeyValuePair<String, SemanticValue> child in semantics)   
{  
  Utils.CreateSemanticsTreeNodes(semanticsNode.Nodes, child.Value, child.Key);  
}  
```

以 System.Speech 為基礎的辨識引擎會針對辨識的所有輸出提供有效的 SemanticValue 實例，即使是沒有明確語意結構的片語也是如此。

片語的 SemanticValue 實體是使用 RecognizedPhrase 物件上的 Semantics 屬性取得的（或繼承自該片語的物件，例如 RecognitionResult）。

針對沒有語意結構的已辨識詞組取得 SemanticValue 物件的特性如下：

缺乏兒童（Count 為0）。
Value 屬性 null。
人工語意信賴等級為 1.0 （由 Confidence傳回）。

一般而言，應用程式會間接建立 SemanticValue 實例，並使用 SemanticResultValue 和 SemanticResultKey 實例，搭配 Choices 和 GrammarBuilder 物件，將它們新增至 Grammar 物件。

直接建構 SemanticValue 實例在建立強型別文法時很有用。

SemanticValue 會實作 IDictionary<TKey,TValue>、ICollection<T>和 IEnumerable<T> 介面。

建構函式

SemanticValue(Object)	初始化 SemanticValue 類別的新實例，並指定語意值。
SemanticValue(String, Object, Single)	初始化 SemanticValue 類別的新實例，並指定語意值、索引鍵名稱和信賴等級。

屬性

Confidence	傳回相對於傳回目前 SemanticValue實例之語意剖析正確性的相對量值。
Count	傳回目前 SemanticValue 實例下子 SemanticValue 對象的數目。
Item[String]	傳回屬於目前 SemanticValue的子 SemanticValue 實例。
Value	只讀屬性，會傳回目前 SemanticValue中包含的資訊。

方法

Contains(KeyValuePair<String,SemanticValue>)	指出目前 SemanticValue 實例集合是否包含特定索引鍵，以及以索引鍵/值組表示的特定實例 SemanticValue。
ContainsKey(String)	指出目前 SemanticValue 實例集合是否包含具有指定索引鍵字串的子 SemanticValue 實例。
Equals(Object)	判斷指定的物件是否為 `SemanticValue` 的實例，且等於 `SemanticValue`的目前實例。
GetHashCode()	提供 `SemanticValue` 物件的哈希碼。
GetType()	取得目前實例的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
ToString()	傳回表示目前物件的字串。 (繼承來源 Object)

明確介面實作

ICollection<KeyValuePair<String,SemanticValue>>.Add(KeyValuePair<String,SemanticValue>)	將指定的索引鍵和 SemanticValue 加入至集合。
ICollection<KeyValuePair<String,SemanticValue>>.Clear()	從集合中移除所有索引鍵/值組。
ICollection<KeyValuePair<String,SemanticValue>>.CopyTo(KeyValuePair<String,SemanticValue>[], Int32)	將索引鍵/值組複製到目標陣列中的特定位置。
ICollection<KeyValuePair<String,SemanticValue>>.IsReadOnly	取得值，這個值表示集合是否為唯讀。
ICollection<KeyValuePair<String,SemanticValue>>.Remove(KeyValuePair<String,SemanticValue>)	從集合中移除指定的索引鍵和 SemanticValue。
IDictionary<String,SemanticValue>.Add(String, SemanticValue)	將指定的索引鍵和 SemanticValue 加入至字典。
IDictionary<String,SemanticValue>.Keys	取得集合，其中包含索引鍵/值組字典中的索引鍵。
IDictionary<String,SemanticValue>.Remove(String)	從字典中移除指定的索引鍵和 SemanticValue。
IDictionary<String,SemanticValue>.TryGetValue(String, SemanticValue)	取得與指定索引鍵相關聯的 SemanticValue。
IDictionary<String,SemanticValue>.Values	取得集合，其中包含索引鍵/值組字典中的值。
IEnumerable.GetEnumerator()	傳回逐一查看集合的列舉值。
IEnumerable<KeyValuePair<String,SemanticValue>>.GetEnumerator()	傳回逐一查看集合的列舉值。

擴充方法

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>。
AsReadOnly<TKey,TValue>(IDictionary<TKey,TValue>)	傳回目前字典的唯讀 ReadOnlyDictionary<TKey,TValue> 包裝函式。
Remove<TKey,TValue>(IDictionary<TKey,TValue>, TKey, TValue)	嘗試從 `dictionary`移除具有指定 `key` 的值。
TryAdd<TKey,TValue>(IDictionary<TKey,TValue>, TKey, TValue)	試著將指定的 `key` 與 `value` 新增至 `dictionary`。
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>)	表示已辨識片語意組織。
AggregateBy<TSource,TKey,TAccumulate>(IEnumerable<TSource>, Func<TSource, TKey>, Func<TKey,TAccumulate>, Func<TAccumulate,TSource,TAccumulate>, IEqualityComparer<TKey>)	表示已辨識片語意組織。
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>)	表示已辨識片語意組織。
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>)	從來源集合的父節點中移除每個節點。

適用於

共用方式為

SemanticValue 類別

定義

範例

備註

建構函式

屬性

方法

明確介面實作

擴充方法

適用於

另請參閱

其他資源