C#-LinqToObject-Element

概述:包括ElementAt,ElementAtOrDefault,First,FirstOrDefault,Last,LastOrDefault,Single,SingleOrDefault

概述

"元素"表示获取某个位置的元素,它包括ElementAt,ElementAtOrDefault,First,FirstOrDefault,Last,LastOrDefault,Single,SingleOrDefault。使用容易,看方法注释,不再赘述。

一 元素

1.方法签名

js 复制代码
/// <summary>
/// 返回序列中指定位置(index)的元素
/// </summary>
/// <typeparam name="TSource">泛型类型参数</typeparam>
/// <param name="source">待处理序列</param>
/// <param name="index">位置(序号)</param>
/// <returns>返回序列中指定位置(index)的元素</returns>
/// <exception cref="T:System.ArgumentNullException">source==null</exception>
/// <exception cref="T:System.ArgumentOutOfRangeException">index<0 或者 index>=source.Length</exception>
TSource ElementAt<TSource>(this IEnumerable<TSource> source, int index);

/// <summary>
/// 返回序列中指定位置(index)的元素,或者如果index超出序列范围,则返回默认值
/// </summary>
/// <typeparam name="TSource">泛型类型参数</typeparam>
/// <param name="source">待处理序列</param>
/// <param name="index">位置(序号)</param>
/// <returns>返回序列中指定位置(index)的元素,或者如果index超出序列范围,则返回默认值</returns>
/// <exception cref="T:System.ArgumentNullException">source==null</exception>
TSource ElementAtOrDefault<TSource>(this IEnumerable<TSource> source, int index);

/// <summary>
/// 返回序列的第一个值
/// </summary>
/// <typeparam name="TSource">泛型类型参数</typeparam>
/// <param name="source">待处理序列</param>
/// <returns>返回序列中的第一个值</returns>
/// <exception cref="T:System.ArgumentNullException">source==null</exception>
/// <exception cref="T:System.InvalidOperationException">source是empty</exception>
TSource First<TSource>(this IEnumerable<TSource> source);

/// <summary>
/// 返回序列中第一个满足指定条件的元素。
/// </summary>
/// <typeparam name="TSource">泛型类型参数</typeparam>
/// <param name="source">待处理序列</param>
/// <param name="predicate">测试序列每个元素的方法</param>
/// <returns>返回序列中第一个满足指定条件的元素。</returns>
/// <exception cref="T:System.ArgumentNullException">source==null 或者 predicate=null</exception>
/// <exception cref="T:System.InvalidOperationException">source是empty;或者序列中没有满足条件的元素</exception>
TSource First<TSource>(this IEnumerable<TSource> source, Func<TSource, bool> predicate);

/// <summary>
/// 返回序列的第一个值,或者当序列是empty时,返回TSource默认值。
/// </summary>
/// <typeparam name="TSource">泛型类型参数</typeparam>
/// <param name="source">待处理序列</param>
/// <returns>返回序列的第一个值,或者当序列是empty时,返回TSource默认值</returns>
/// <exception cref="T:System.ArgumentNullException">source==null</exception>
TSource FirstOrDefault<TSource>(this IEnumerable<TSource> source);

/// <summary>
/// 返回序列中第一个满足条件的值。或者,当序列是empty与序列中没有满足条件的值时,返回TSource默认值。
/// </summary>
/// <typeparam name="TSource">泛型类型参数</typeparam>
/// <param name="source">待处理序列</param>
/// <param name="predicate">测试序列每个元素的方法</param>
/// <returns>返回序列中第一个满足条件的值。或者,当序列是empty与序列中没有满足条件的值时,返回TSource默认值。</returns>
/// <exception cref="T:System.ArgumentNullException">source==null 或者 predicate=null</exception>
TSource FirstOrDefault<TSource>(this IEnumerable<TSource> source, Func<TSource, bool> predicate);

/// <summary>
/// 返回序列中的最后一个元素
/// </summary>
/// <typeparam name="TSource">泛型类型参数</typeparam>
/// <param name="source">待处理序列</param>
/// <returns>返回序列中的最后一个元素</returns>
/// <exception cref="T:System.ArgumentNullException">source==null</exception>
/// <exception cref="T:System.InvalidOperationException">source是empty</exception>
TSource Last<TSource>(this IEnumerable<TSource> source);

/// <summary>
/// 返回序列中最后一个满足指定条件的元素。
/// </summary>
/// <typeparam name="TSource">泛型类型参数</typeparam>
/// <param name="source">待处理序列</param>
/// <param name="predicate">测试序列每个元素的方法</param>
/// <returns>返回序列中最后一个满足指定条件的元素。</returns>
/// <exception cref="T:System.ArgumentNullException">source==null 或者 predicate=null</exception>
/// <exception cref="T:System.InvalidOperationException">source是empty;或者序列中没有满足条件的元素</exception>
TSource Last<TSource>(this IEnumerable<TSource> source, Func<TSource, bool> predicate);


/// <summary>
/// 返回序列的最后一个值,或者当序列是empty时,返回TSource默认值。
/// </summary>
/// <typeparam name="TSource">泛型类型参数</typeparam>
/// <param name="source">待处理序列</param>
/// <returns>返回序列的最后一个值,或者当序列是empty时,返回TSource默认值。</returns>
/// <exception cref="T:System.ArgumentNullException">source==null</exception>
TSource LastOrDefault<TSource>(this IEnumerable<TSource> source);

/// <summary>
/// 返回序列中最后一个满足条件的值。或者,当序列是empty与序列中没有满足条件的值时,返回TSource默认值。
/// </summary>
/// <typeparam name="TSource">泛型类型参数</typeparam>
/// <param name="source">待处理序列</param>
/// <param name="predicate">测试序列每个元素的方法</param>
/// <returns>返回序列中最后一个满足条件的值。或者,当序列是empty与序列中没有满足条件的值时,返回TSource默认值。</returns>
/// <exception cref="T:System.ArgumentNullException">source==null 或者 predicate=null</exception>
TSource LastOrDefault<TSource>(this IEnumerable<TSource> source, Func<TSource, bool> predicate);

/// <summary>
/// 返回序列中唯一的元素,如果序列中没有确切的元素,则抛出异常。
/// </summary>
/// <typeparam name="TSource">序列中的元素类型</typeparam>
/// <param name="source">待处理序列</param>
/// <returns>序列的单个元素。</returns>
/// <exception cref="T:System.ArgumentNullException">source==null</exception>
/// <exception cref="T:System.InvalidOperationException">序列是空的,或者序列的元素数量超过1个 </exception>
TSource Single<TSource>(this IEnumerable<TSource> source);

/// <summary>
/// 返回序列中唯一满足指定条件的元素,如果存在多个这样的元素,则抛出异常。
/// </summary>
/// <typeparam name="TSource">序列中的元素类型</typeparam>
/// <param name="source">待处理序列</param>
/// <param name="predicate">用于测试一个元素的条件的函数。</param>
/// <returns>序列中满足条件的单个元素。</returns>
/// <exception cref="T:System.ArgumentNullException">source==null or predicate</exception>
/// <exception cref="T:System.InvalidOperationException">序列是空的,或者序列中满足条件的元素数量超过1个或者为0个 </exception>
TSource Single<TSource>(this IEnumerable<TSource> source, Func<TSource, bool> predicate);

/// <summary>
///  返回序列中唯一的元素,如果序列中没有确切的元素,则返回默认值。如果序列中元素数量超过一个,那么抛出异常.
/// </summary>
/// <typeparam name="TSource">序列中的元素类型</typeparam>
/// <param name="source">待处理序列</param>
/// <returns>返回序列中唯一的元素,如果序列中没有确切的元素,则返回默认值。</returns>
/// <exception cref="T:System.ArgumentNullException">source==null</exception>
/// <exception cref="T:System.InvalidOperationException">序列的元素数量超过1个 </exception>
TSource SingleOrDefault<TSource>(this IEnumerable<TSource> source);

/// <summary>
/// 返回序列中满足条件的唯一元素;或者返回默认值,如果序列没有满足条件的元素。
/// 如果满足条件的元素多于一个,则会抛出异常。
/// </summary>
/// <typeparam name="TSource">序列中的元素类型</typeparam>
/// <param name="source">待处理序列</param>
/// <param name="predicate">用于测试一个元素的条件的函数。</param>
/// <returns></returns>
/// <exception cref="T:System.ArgumentNullException">source==null or predicate</exception>
/// <exception cref="T:System.InvalidOperationException">序列中满足条件的元素数量超过1个 </exception>
TSource SingleOrDefault<TSource>(this IEnumerable<TSource> source, Func<TSource, bool> predicate);
相关推荐
阿登林2 小时前
C# .NET Core中Chart图表绘制与PDF导出
c#·1024程序员节
yi碗汤园7 小时前
【一文了解】八大排序-插入排序、希尔排序
开发语言·算法·unity·c#·1024程序员节
小朩9 小时前
数据结构C语言
数据结构·c#·1024程序员节
CN.LG10 小时前
C# 企业微信机器人消息推送
c#·企业微信·1024程序员节·机器人推送
唐青枫10 小时前
C#.NET ArrayPool 深入解析:高性能内存池的实现与应用
c#·.net
张人玉10 小时前
WPF 核心概念笔记(补充示例)
c#·wpf·1024程序员节·布局控件
foundbug99910 小时前
C# 实现 Modbus TCP 通信
开发语言·tcp/ip·c#
hoiii18711 小时前
C#实现摄像头视频录制与保存
开发语言·c#·音视频
YuanlongWang11 小时前
C# 设计模式——观察者
windows·设计模式·c#
李趣趣20 小时前
数据库字段类型bit容易被忽视的bug
c#·bug