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);
相关推荐
李宥小哥3 小时前
C#基础09-面向对象关键字
开发语言·c#
ajassi20003 小时前
开源 C# 快速开发(十四)进程--内存映射
开发语言·开源·c#
ajassi20005 小时前
开源 C# 快速开发(十五)进程--windows消息
windows·开源·c#
ajassi20005 小时前
开源 C# 快速开发(十三)进程--管道通讯
开发语言·开源·c#
Rotion_深11 小时前
C# 对Bitmap 的一些处理方法,裁剪,压缩,旋转等
图像处理·c#
秋月的私语11 小时前
如何快速将当前的c#工程发布成单文件
android·java·c#
切糕师学AI14 小时前
在 C# 中,如何使 $““ 字符串支持换行
c#
小先生81217 小时前
.NET Core项目中 Serilog日志文件配置
c#·.netcore
大飞pkz19 小时前
【设计模式】迭代器模式
开发语言·设计模式·c#·迭代器模式
张人玉21 小时前
C# UDP 服务端与客户端2.0
单片机·udp·c#