1. IronPDF
  2. IronPDF博客
  3. .NET 帮助
  4. C# Yield Return
.NET 帮助

C# Yield Return（对开发者的工作原理）

发布 2024年一月27日
分享:

C# 是微软开发的最流行的编程语言之一，它提供的功能可为您的代码增添优雅和高效。C# 2.0 中首次引入的 yield 关键字就是其中之一。微软提供了一份关于 yield 关键字语句的完整语言参考资料，以探讨在迭代器方法中使用它们的更多信息，您可以查看该参考资料 这里.

在本文中，我们将介绍 C# 中的 yield return，探讨其功能、用例以及如何改变迭代方式。

Understanding the Basics：C&num 中的迭代

迭代是编程中的一个基本概念，C# 提供了多种机制来实现迭代。传统上，for 循环和foreach 循环等循环是对集合进行迭代的常用工具。然而，C# 引入了一种更优雅的解决方案，即在return语句中使用yield关键字，并使用 Inumerable接口。

yield return 语句的效率

yield return 是迭代器方法中使用的语句，其核心是提供一种更高效的方法来生成值序列。它允许你创建一个迭代器，而无需在内存中生成整个集合，因此对大型数据集或无限序列特别有用。

下面是一个简单的代码片段，用于说明 yield return 的基本用法：

public IEnumerable<int> GenerateNumbers(int start, int end)
{
    // for loop goes through numbers, start to end
    for (int i = start; i <= end; i++) 
    {
        yield return i; // returns each number without breaking the loop
    }
}

// Usage
// foreach loop calls the previous function
foreach (var number in GenerateNumbers(1, 5)) 
{
    Console.WriteLine(number); // Outputs numbers 1 - 5
}
public IEnumerable<int> GenerateNumbers(int start, int end)
{
    // for loop goes through numbers, start to end
    for (int i = start; i <= end; i++) 
    {
        yield return i; // returns each number without breaking the loop
    }
}

// Usage
// foreach loop calls the previous function
foreach (var number in GenerateNumbers(1, 5)) 
{
    Console.WriteLine(number); // Outputs numbers 1 - 5
}
Public Iterator Function GenerateNumbers(ByVal start As Integer, ByVal [end] As Integer) As IEnumerable(Of Integer)
	' for loop goes through numbers, start to end
	For i As Integer = start To [end]
		Yield i ' returns each number without breaking the loop
	Next i
End Function

' Usage
' foreach loop calls the previous function
For Each number In GenerateNumbers(1, 5)
	Console.WriteLine(number) ' Outputs numbers 1 - 5
Next number
VB   C#

在本例中，"GenerateNumbers "方法使用 "yield return "生成从 "start "到 "end "的数字序列。迭代器是懒散求值的，这意味着每个数字都是在迭代执行过程中按需生成的。

懒惰评估与效率

yield return 语句的一个显著优势是它能够支持懒评估。与在迭代前生成整个集合的传统方法不同，yield return 一次只生成一个值。这可以大大节省内存，尤其是在处理大型数据集时。

状态迭代：处理复杂场景

yield return "语句不仅限于生成简单的序列，它还能在迭代器块中处理更复杂的情况。通过在迭代过程中维护状态机，可以创建能够记住自己在序列中位置的迭代器。

public IEnumerable<string> GenerateFibonacci(int count)
{
    int a = 0, b = 1;
    for (int i = 0; i < count; i++)
    {
        yield return a.ToString(); // returns 'a' value in the middle of the for loop
        int temp = a;
        a = b;
        b = temp + b;
    }
}
// Usage
// foreach loop that calls the previous iterator function
foreach (var fibNumber in GenerateFibonacci(8))
{
    Console.WriteLine(fibNumber); // Outputs a Fibonacci number sequence
}
public IEnumerable<string> GenerateFibonacci(int count)
{
    int a = 0, b = 1;
    for (int i = 0; i < count; i++)
    {
        yield return a.ToString(); // returns 'a' value in the middle of the for loop
        int temp = a;
        a = b;
        b = temp + b;
    }
}
// Usage
// foreach loop that calls the previous iterator function
foreach (var fibNumber in GenerateFibonacci(8))
{
    Console.WriteLine(fibNumber); // Outputs a Fibonacci number sequence
}
Public Iterator Function GenerateFibonacci(ByVal count As Integer) As IEnumerable(Of String)
	Dim a As Integer = 0, b As Integer = 1
	For i As Integer = 0 To count - 1
		Yield a.ToString() ' returns 'a' value in the middle of the for loop
		Dim temp As Integer = a
		a = b
		b = temp + b
	Next i
End Function
' Usage
' foreach loop that calls the previous iterator function
For Each fibNumber In GenerateFibonacci(8)
	Console.WriteLine(fibNumber) ' Outputs a Fibonacci number sequence
Next fibNumber
VB   C#

在本例中，"GenerateFibonacci "方法使用 "yield return "创建斐波那契数列。在迭代之间保持状态，确保高效生成和输出斐波那契数字。

构建无限序列

yield return 的一个有趣应用是它能够创建无限的值序列。由于值是即时生成的，因此您可以在不消耗无限内存的情况下表示永无止境的序列。

public IEnumerable<int> GenerateEvenNumbers()
{
    int num = 0;
    while (true)
    {
        yield return num;
        num += 2;
    }
}

// Usage
var evenNumberIterator = GenerateEvenNumbers().GetEnumerator();
for (int i = 0; i < 5; i++)
{
    evenNumberIterator.MoveNext();
    Console.WriteLine(evenNumberIterator.Current);
}
public IEnumerable<int> GenerateEvenNumbers()
{
    int num = 0;
    while (true)
    {
        yield return num;
        num += 2;
    }
}

// Usage
var evenNumberIterator = GenerateEvenNumbers().GetEnumerator();
for (int i = 0; i < 5; i++)
{
    evenNumberIterator.MoveNext();
    Console.WriteLine(evenNumberIterator.Current);
}
Public Iterator Function GenerateEvenNumbers() As IEnumerable(Of Integer)
	Dim num As Integer = 0
	Do
		Yield num
		num += 2
	Loop
End Function

' Usage
Private evenNumberIterator = GenerateEvenNumbers().GetEnumerator()
For i As Integer = 0 To 4
	evenNumberIterator.MoveNext()
	Console.WriteLine(evenNumberIterator.Current)
Next i
VB   C#

在本例中，GenerateEvenNumbers 方法为偶数创建了一个迭代器，您可以根据需要对其进行迭代。您还可以使用 yield break 语句和 yield return 来停止并退出循环，为循环创建自定义迭代。

IronPDF 简介：强大的 C# 库

C# Yield Return（如何为开发人员工作）：图 1 - IronPDF 网页

IronPDF IronPDF 是一个多功能的 C# 库，旨在简化处理 PDF 的复杂性。无论您是要生成发票、报告还是任何其他文档，IronPDF 都能让您在 C# 应用程序中直接将 HTML 内容无缝转换为精美、专业的 PDF。

安装 IronPDF：快速入门

要将 IronPDF 纳入 C# 项目，可以快速安装 IronPDF NuGet 软件包。在软件包管理器控制台中执行以下命令：


安装 IronPDF 软件包

或者，您也可以在 NuGet 软件包管理器中找到 "IronPDF"，然后安装。

使用 IronPDF 生成 PDF

使用 IronPDF 创建 PDF 是一个简单明了的过程。让我们举一个基本的例子：

var htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>";
// Create a new PDF document
var pdfDocument = new IronPdf.ChromePdfRenderer();
pdfDocument.RenderHtmlAsPdf(htmlContent).SaveAs("C:/GeneratedDocument.pdf");
var htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>";
// Create a new PDF document
var pdfDocument = new IronPdf.ChromePdfRenderer();
pdfDocument.RenderHtmlAsPdf(htmlContent).SaveAs("C:/GeneratedDocument.pdf");
Dim htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>"
' Create a new PDF document
Dim pdfDocument = New IronPdf.ChromePdfRenderer()
pdfDocument.RenderHtmlAsPdf(htmlContent).SaveAs("C:/GeneratedDocument.pdf")
VB   C#

在上例中，IronPDF 用于渲染 将 HTML 内容转化为 PDF 文档**然后保存到指定位置。更多详细信息，请访问 文件 page.

yield return 与 IronPDF 的交集

现在，让我们来探讨一下 yield return 语句这一用于懒惰评估和高效迭代的强大工具能否与 IronPDF 无缝集成。

考虑这样一种情况：您需要使用 yield return 语句生成一个包含项目列表的 PDF 文档。您可以利用 yield 语句的优势动态生成内容，然后使用 IronPDF 将内容转换为 PDF。以下代码片段借助 "yield "语句生成 PDF 文档，以添加对 PDF 内容的动态控制：

class Program
{
    static void Main(string [] args)
    {
        public IEnumerable<string> GenerateDynamicContent()
        {
            yield return "Item 1";
            yield return "Item 2";
            yield return "Item 3";
        }

        // Usage
        var dynamicContent = GenerateDynamicContent();
        var dynamicPdfContent = $@"
            <html>
            <body>
                <h1>List of Items</h1>
                <ul>
                    {string.Join("", dynamicContent.Select(item => $"<li>{item}</li>"))}
                </ul>
            </body>
            </html>
        ";

        // Create a new PDF document with dynamically generated content
        var dynamicPdfDocument = new IronPdf.ChromePdfRenderer();
        dynamicPdfDocument.RenderHtmlAsPdf(dynamicPdfContent).SaveAs("C:/DynamicItems.pdf");
    }
}
class Program
{
    static void Main(string [] args)
    {
        public IEnumerable<string> GenerateDynamicContent()
        {
            yield return "Item 1";
            yield return "Item 2";
            yield return "Item 3";
        }

        // Usage
        var dynamicContent = GenerateDynamicContent();
        var dynamicPdfContent = $@"
            <html>
            <body>
                <h1>List of Items</h1>
                <ul>
                    {string.Join("", dynamicContent.Select(item => $"<li>{item}</li>"))}
                </ul>
            </body>
            </html>
        ";

        // Create a new PDF document with dynamically generated content
        var dynamicPdfDocument = new IronPdf.ChromePdfRenderer();
        dynamicPdfDocument.RenderHtmlAsPdf(dynamicPdfContent).SaveAs("C:/DynamicItems.pdf");
    }
}
Friend Class Program
	Shared Sub Main(ByVal args() As String)
'INSTANT VB TODO TASK: Local functions are not converted by Instant VB:
'		public IEnumerable(Of string) GenerateDynamicContent()
'		{
'			yield Return "Item 1";
'			yield Return "Item 2";
'			yield Return "Item 3";
'		}

		' Usage
		Dim dynamicContent = GenerateDynamicContent()
, String.Join(TangibleTempVerbatstring.Format(mDoubleQuote, dynamicContent.Select(Function(item) $TangibleTempVerbatimCloseTag"<li>{item}</li>")), TangibleStringInterpolationMarker) var dynamicPdfContent = $"TangibleTempVerbatimOpenTagTangibleTempVerbatimStringLiteralLineJoin            <html>TangibleTempVerbatimStringLiteralLineJoin            <body>TangibleTempVerbatimStringLiteralLineJoin                <h1>List of Items</h1>TangibleTempVerbatimStringLiteralLineJoin                <ul>TangibleTempVerbatimStringLiteralLineJoin                    {0}ignoreignoreignoreignoreignore</ul></body></html>"

		' Create a new PDF document with dynamically generated content
		Dim dynamicPdfDocument = New IronPdf.ChromePdfRenderer()
		dynamicPdfDocument.RenderHtmlAsPdf(dynamicPdfContent).SaveAs("C:/DynamicItems.pdf")
	End Sub
End Class
VB   C#

在本例中，"GenerateDynamicContent "方法利用 "yield return "提供了一系列动态项目。然后，生成的内容被纳入 HTML 结构，并由 IronPDF 用于创建 PDF 文档。

C# Yield Return（如何为开发人员工作）：图 2 - 前面代码的输出 PDF

结论

总之，"yield return "是 C# 中一个强大而优雅的功能，它改变了您处理迭代的方式。它能够支持懒惰评估、使用有状态迭代处理复杂情况并创建无限序列，因此是您编程工具包中的重要工具。无论您是处理大型数据集还是执行复杂的算法，yield return 都能让您编写出更高效、更具表现力的代码。

当 "yield return "帮助高效地按需生成内容时，IronPDF 会介入将这些内容无缝地转换为专业的 PDF 文档。无论您是动态创建列表、报告或任何其他文档，这种协同作用都能使您的 C# 文档生成能力达到新的高度。利用这对动态组合的潜力，让您的 PDF 文件在动态和高效生成的内容中大放异彩吧!

IronPDF 提供了一个 免费试用 测试其全部功能，就像在商业模式下一样。 许可证 从 $749 开始。

< 前一页
C# REPL（它对开发者的工作原理）
下一步 >
C# 数组排序（开发人员指南）

报告问题

准备开始了吗？ 版本： 2024.10 刚刚发布

免费NuGet下载 总下载量: 11,108,738 查看许可证 >

获取您的免费

30天试用密钥 立即。

15天试用密钥 立即。

bullet_checked无需信用卡或创建账户
试用表格已提交
成功地。

您的试用密钥应在电子邮件中。
如果不是，请联系
support@ironsoftware.com

子弹测试测试生产环境
无水印
子弹日历30天全功能使用
功能性产品
子弹支持24/5技术支持
试用期间的支持

谢谢！

您的许可证密钥已发送到所提供的电子邮件。联系我们

24小时升级优惠：

Save 50% 在一个
专业 升级

去 专业 支持10位开发者
和无限项目。

小时

:

分钟

:

秒

升级到Professional

升级

专业

$600 美元

$299 美元

  • 10位开发者
  • 10个位置
  • 10个项目
今天 只有

5个.NET产品，两件的价格

IronPDF IronOCR IronXL IronBarcode IronWebscraper

套件总价值：

$7,192 美元

升级价格

今天
只有

$499 美元

24小时后

$1,098 美元