C#2.0新增功能05 迭代器
迭代器可用于逐步迭代集合,例如列表和数组。
迭代器方法或 get
访问器可对集合执行自定义迭代。 迭代器方法使用 yield return 语句返回元素,每次返回一个。 到达 yield return
语句时,会记住当前在代码中的位置。 下次调用迭代器函数时,将从该位置重新开始执行。
通过 foreach 语句或 LINQ 查询从客户端代码中使用迭代器。
在以下示例中,foreach
循环的首次迭代导致 SomeNumbers
迭代器方法继续执行,直至到达第一个 yield return
语句。 此迭代返回的值为 3,并保留当前在迭代器方法中的位置。 在循环的下次迭代中,迭代器方法的执行将从其暂停的位置继续,直至到达 yield return
语句后才会停止。 此迭代返回的值为 5,并再次保留当前在迭代器方法中的位置。 到达迭代器方法的结尾时,循环便已完成。
static void Main()
{
foreach (int number in SomeNumbers())
{
Console.Write(number.ToString() + " ");
}
// 输出: 3 5 8
Console.ReadKey();
} public static System.Collections.IEnumerable SomeNumbers()
{
yield return ;
yield return ;
yield return ;
}
迭代器方法或 get
访问器的返回类型可以是 IEnumerable、IEnumerable<T>、IEnumerator 或 IEnumerator<T>。
可以使用 yield break
语句来终止迭代。
对于本主题中除简单迭代器示例以外的所有示例,请为 System.Collections 和 System.Collections.Generic 命名空间加入 using 指令。
yield return
语句。 在 Main
中,foreach
语句体的每次迭代都会创建一个对迭代器函数的调用,并将继续到下一个 yield return
语句。static void Main()
{
foreach (int number in EvenSequence(, ))
{
Console.Write(number.ToString() + " ");
}
// 输出: 6 8 10 12 14 16 18
Console.ReadKey();
} public static System.Collections.Generic.IEnumerable<int> EvenSequence(int firstNumber, int lastNumber)
{
// 迭代集合中的偶数.
for (int number = firstNumber; number <= lastNumber; number++)
{
if (number % == )
{
yield return number;
}
}
}
在以下示例中,DaysOfTheWeek
类实现 IEnumerable 接口,此操作需要 GetEnumerator 方法。 编译器隐式调用 GetEnumerator
方法,此方法返回 IEnumerator。
GetEnumerator
方法通过使用 yield return
语句每次返回 1 个字符串。
static void Main()
{
DaysOfTheWeek days = new DaysOfTheWeek(); foreach (string day in days)
{
Console.Write(day + " ");
}
// 输出: Sun Mon Tue Wed Thu Fri Sat
Console.ReadKey();
} public class DaysOfTheWeek : IEnumerable
{
private string[] days = { "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat" }; public IEnumerator GetEnumerator()
{
for (int index = ; index < days.Length; index++)
{
// 迭代每一天
yield return days[index];
}
}
}
下例创建了一个包含动物集合的 Zoo
类。
引用类实例 (theZoo
) 的 foreach
语句隐式调用 GetEnumerator
方法。 引用 Birds
和 Mammals
属性的 foreach
语句使用 AnimalsForType
命名迭代器方法。
static void Main()
{
Zoo theZoo = new Zoo(); theZoo.AddMammal("Whale");
theZoo.AddMammal("Rhinoceros");
theZoo.AddBird("Penguin");
theZoo.AddBird("Warbler"); foreach (string name in theZoo)
{
Console.Write(name + " ");
}
Console.WriteLine();
// 输出: Whale Rhinoceros Penguin Warbler foreach (string name in theZoo.Birds)
{
Console.Write(name + " ");
}
Console.WriteLine();
// 输出: Penguin Warbler foreach (string name in theZoo.Mammals)
{
Console.Write(name + " ");
}
Console.WriteLine();
// 输出: Whale Rhinoceros Console.ReadKey();
} public class Zoo : IEnumerable
{
// 私有成员
private List<Animal> animals = new List<Animal>(); // 公共方法
public void AddMammal(string name)
{
animals.Add(new Animal { Name = name, Type = Animal.TypeEnum.Mammal });
} public void AddBird(string name)
{
animals.Add(new Animal { Name = name, Type = Animal.TypeEnum.Bird });
} public IEnumerator GetEnumerator()
{
foreach (Animal theAnimal in animals)
{
yield return theAnimal.Name;
}
} // 公共成员
public IEnumerable Mammals
{
get { return AnimalsForType(Animal.TypeEnum.Mammal); }
} public IEnumerable Birds
{
get { return AnimalsForType(Animal.TypeEnum.Bird); }
} // 私有方法
private IEnumerable AnimalsForType(Animal.TypeEnum type)
{
foreach (Animal theAnimal in animals)
{
if (theAnimal.Type == type)
{
yield return theAnimal.Name;
}
}
} // 私有类
private class Animal
{
public enum TypeEnum { Bird, Mammal } public string Name { get; set; }
public TypeEnum Type { get; set; }
}
}
在以下示例中,Stack<T> 泛型类实现 IEnumerable<T> 泛型接口。 Push 方法将值分配给类型为 T
的数组。 GetEnumerator 方法通过使用 yield return
语句返回数组值。
除了泛型 GetEnumerator 方法,还必须实现非泛型 GetEnumerator 方法。 这是因为从 IEnumerable 继承了 IEnumerable<T>。 非泛型实现遵从泛型实现的规则。
本示例使用命名迭代器来支持通过各种方法循环访问同一数据集合。 这些命名迭代器为 TopToBottom
和 BottomToTop
属性,以及 TopN
方法。
BottomToTop
属性在 get
访问器中使用迭代器。
static void Main()
{
Stack<int> theStack = new Stack<int>(); // 向堆栈中添加项
for (int number = ; number <= ; number++)
{
theStack.Push(number);
} // 从堆栈中检索项。
// 此处允许使用 foreach,因为 foreach 实现了 IEnumerable<int>
foreach (int number in theStack)
{
Console.Write("{0} ", number);
}
Console.WriteLine();
// 输出: 9 8 7 6 5 4 3 2 1 0 // 此处允许使用 foreach,因为 theStack.TopToBottom 属性返回了 IEnumerable(Of Integer).
foreach (int number in theStack.TopToBottom)
{
Console.Write("{0} ", number);
}
Console.WriteLine();
// 输出: 9 8 7 6 5 4 3 2 1 0 foreach (int number in theStack.BottomToTop)
{
Console.Write("{0} ", number);
}
Console.WriteLine();
// 输出: 0 1 2 3 4 5 6 7 8 9 foreach (int number in theStack.TopN())
{
Console.Write("{0} ", number);
}
Console.WriteLine();
// 输出: 9 8 7 6 5 4 3 Console.ReadKey();
} public class Stack<T> : IEnumerable<T>
{
private T[] values = new T[];
private int top = ; public void Push(T t)
{
values[top] = t;
top++;
}
public T Pop()
{
top--;
return values[top];
} // 此方法实现了GetEnumerator()方法. 它允许在 foreach 语句中使用类的实例。
public IEnumerator<T> GetEnumerator()
{
for (int index = top - ; index >= ; index--)
{
yield return values[index];
}
} IEnumerator IEnumerable.GetEnumerator()
{
return GetEnumerator();
} public IEnumerable<T> TopToBottom
{
get { return this; }
} public IEnumerable<T> BottomToTop
{
get
{
for (int index = ; index <= top - ; index++)
{
yield return values[index];
}
}
} public IEnumerable<T> TopN(int itemsFromTop)
{
// 如有必要,返回少于 itemsFromTop
int startIndex = itemsFromTop >= top ? : top - itemsFromTop; for (int index = top - ; index >= startIndex; index--)
{
yield return values[index];
}
} }
迭代器可用作一种方法,或一个 get
访问器。 不能在事件、实例构造函数、静态构造函数或静态终结器中使用迭代器。
必须存在从 yield return
语句中的表达式类型到迭代器返回的 IEnumerable<T> 类型参数的隐式转换。
在 C# 中,迭代器方法不能有任何 in
、ref
或 out
参数。
在 C# 中,“yield”不是保留字,只有在 return
或 break
关键字之前使用时才有特殊含义。
即使将迭代器编写成方法,编译器也会将其转换为实际上是状态机的嵌套类。 只要客户端代码中的 foreach
循环继续,此类就会跟踪迭代器的位置。
若要查看编译器执行的操作,可使用 Ildasm.exe 工具查看为迭代器方法生成的 Microsoft 中间语言代码。
为类或结构创建迭代器时,不必实现整个 IEnumerator 接口。 编译器检测到迭代器时,会自动生成 IEnumerator 或 IEnumerator<T> 接口的 Current
、MoveNext
和 Dispose
方法。
在 foreach
循环(或对 IEnumerator.MoveNext
的直接调用)的每次后续迭代中,下一个迭代器代码体都会在上一个 yield return
语句之后恢复。 然后继续下一个 yield return
语句,直至到达迭代器体的结尾,或直至遇到 yield break
语句。
迭代器不支持 IEnumerator.Reset 方法。 若要从头开始重新迭代,必须获取新的迭代器。 在迭代器方法返回的迭代器上调用 Reset 会引发 NotSupportedException。
有关其他信息,请参阅 C# 语言规范。
需要使用复杂代码填充列表序列时,使用迭代器可保持 foreach
循环的简单性。 需执行以下操作时,这可能很有用:
在第一次
foreach
循环迭代之后,修改列表序列。避免在
foreach
循环的第一次迭代之前完全加载大型列表。 一个示例是用于加载一批表格行的分页提取。 另一个示例关于 EnumerateFiles 方法,该方法在 .NET Framework 中实现迭代器。在迭代器中封装生成列表。 使用迭代器方法,可生成该列表,然后在循环中产出每个结果。
C#2.0新增功能05 迭代器的更多相关文章
- C#3.0新增功能05 分部方法
连载目录 [已更新最新开发文章,点击查看详细] 分部类或结构可以包含分部方法. 类的一个部分包含方法的签名. 可以在同一部分或另一个部分中定义可选实现. 如果未提供该实现,则会在编译时删除 ...
- C#2.0新增功能01 分布类与分部方法
连载目录 [已更新最新开发文章,点击查看详细] 分部类型 拆分一个类.一个结构.一个接口或一个方法的定义到两个或更多的文件中, 每个源文件包含类型或方法定义的一部分,编译应用程序时将把所有部分组 ...
- C#基础拾遗系列之二:使用ILSpy探索C#7.0新增功能点
C#基础拾遗系列之二:使用ILSpy探索C#7.0新增功能点 第一部分: C#是一种通用的,类型安全的,面向对象的编程语言.有如下特点: (1)面向对象:c# 是面向对象的范例的一个丰富实现, 它 ...
- C#2.0新增功能06 协变和逆变
连载目录 [已更新最新开发文章,点击查看详细] 在 C# 中,协变和逆变能够实现数组类型.委托类型和泛型类型参数的隐式引用转换. 协变保留分配兼容性,逆变则与之相反. 以下代码演示分配兼容性.协 ...
- C#基础拾遗系列之二:C#7.0新增功能点
第一部分: C#是一种通用的,类型安全的,面向对象的编程语言.有如下特点: (1)面向对象:c# 是面向对象的范例的一个丰富实现, 它包括封装.继承和多态性.C#面向对象的行为包括: 统一的类型系统 ...
- C#7.0新增功能点
原文地址: https://www.cnblogs.com/runningsmallguo/p/8972678.html 第二部分:C#7.0新增的功能 (1)数字字面量的提升: C#7中的数字文字 ...
- 说说C# 8.0 新增功能Index和Range的^0是什么?
前言 在<C# 8.0 中使用 Index 和 Range>这篇中有人提出^0是什么意思?处于好奇就去试了,结果抛出异常.查看官方文档说^0索引与 sequence[sequence.Le ...
- C#3.0新增功能09 LINQ 基础05 使用 LINQ 进行数据转换
连载目录 [已更新最新开发文章,点击查看详细] 语言集成查询 (LINQ) 不只是检索数据. 它也是用于转换数据的强大工具. 通过使用 LINQ查询,可以使用源序列作为输入,并通过多种方式对其进 ...
- C#3.0新增功能10 表达式树 05 解释表达式
连载目录 [已更新最新开发文章,点击查看详细] 表达式树中的每个节点将是派生自 Expression 的类的对象. 该设计使得访问表达式树中的所有节点成为相对直接的递归操作. 常规策略是从根节点 ...
随机推荐
- MySQL 主从配置 读写分离
Master配置 1.创建用户: 在Master MySQL上创建一个用户‘repl’,并允许其他Slave服务器可以通过远程访问Master,通过该用户读取二进制日志,实现数据同步. create ...
- RESTful API设计原则与规范
RESTful API设计原则与规范 一.背景与基础概念 2 二.RESTful API应遵循的原则 3 1.协议(Protocol) 3 2.域名(ROOT URL) 3 3.版本(Versioni ...
- Awesome C/C++(图像部分)
GUI Graphic User Interface CEGUI - Flexible, cross-platform GUI library. FLTK - Fast, light, cross-p ...
- JavaScript-DOM续
一.路由的跳转 <body> <a href="#/course">课程</a> <a href="#/main"&g ...
- Md2All:好用的markdown文件转换工具,文章迁移微信公众号的利器
目录 简介 使用体验 极速上手 更多功能 总结 简介 markdown以简单的语法和强大的功能,征服了无数技术创作者,几乎主流的技术博客网站都开始支持markdown语言撰写博客.但是微信公众号的文章 ...
- Spring Boot入门篇(基于Spring Boot 2.0系列)
1:概述: Spring Boot是用来简化Spring应用的初始化开发过程. 2:特性: 创建独立的应用(jar|war形式); 需要用到spring-boot-maven-plugin插件 直接嵌 ...
- spring常见十大异常
一.找不到配置文件的异常 [plain] view plaincopy org.springframework.beans.factory.BeanDefinitionStoreException: ...
- windows pyspider WEB显示框太小解决方法
环境:windows7 + chrome + pyspider 解决方法: WEB预览框过小的原因在于页面元素的css属性height被替换为60px: CSS文件所在地方:C:\Users\Admi ...
- ajax中error函数参数与返回值详解 200 300 400 500
201-206:都表示服务器成功处理了请求的状态代码,说明网页可以正常访问. 200:(成功) 服务器已成功处理了请求.通常,这表示服务器提供了请求的网页. 201:(已创建) 请求成功且服务器已创建 ...
- OSI参考模型---网络基础篇(1)
什么是网络 网络就是将分布在不同地理位置,具有独立功能的终端(一切联网的设备都叫终端:例如电脑,手机,智能家电等等联网的设备),通过通信线路(双绞线.光纤.电话线等等)和通信设备(例如:交换机.路由器 ...