C# 引用（开发人员如何使用）

理解 ref 参数

ref参数是一个方法参数，它作为传入方法的变量的引用。 与标准的值参数不同，只传递变量的副本，ref参数允许被调用的方法修改原始变量的值。 当您需要方法更新传递给它的变量状态时，这种行为至关重要。

请看以下示例，以演示ref的基本用法，重点是如何在方法调用的整个过程中，一个引用类型变量保持其参数值在同一个对象中不变：

class Program
{
    static void Main()
    {
        int number = 100;
        ModifyNumber(ref number);
        Console.WriteLine(number); // Output: 200
    }

    // Method that modifies the original number through 'ref'
    static void ModifyNumber(ref int number)
    {
        number = 200; // Modifies the original value
    }
}

class Program
{
    static void Main()
    {
        int number = 100;
        ModifyNumber(ref number);
        Console.WriteLine(number); // Output: 200
    }

    // Method that modifies the original number through 'ref'
    static void ModifyNumber(ref int number)
    {
        number = 200; // Modifies the original value
    }
}

在此示例中，ref参数的形式传递。 在Main方法中的原始值中，并将200输出到控制台。

ref 参数如何工作

当您使用ref关键字声明一个方法参数时，您是在告诉编译器，该参数将引用原始变量而不是副本。 这通过传递变量的内存地址而不是实际值来实现。 调用方法和被调用方法都访问同一个内存位置，这意味着对参数所做的任何更改都直接对原始变量进行更改。

理解ref的关键是认识到它可以用于值类型和引用类型。值类型包括整数和结构体这样的简单数据类型，而引用类型包括对象和数组。 然而，尽管引用类型变量本质上持有内存地址，使用ref与引用类型一起使您可以修改实际的引用，而不仅仅是对象的内容。

ref 和 out 之间的区别

虽然out关键字都允许修改原始变量，但它们之间有重要区别。 out参数不需要在传递给方法之前进行初始化。 相反，ref参数要求在传递之前对变量进行初始化。 此外，使用out参数的方法必须在方法返回之前赋值。 此要求不适用于ref参数。

以下是使用out关键字的方法：

class Program
{
    static void Main()
    {
        int result;
        CalculateResult(out result);
        Console.WriteLine(result); // Output: 100
    }

    // Method that calculates a result and assigns it via 'out'
    static void CalculateResult(out int calculation)
    {
        calculation = 20 * 5; // Must initialize the out parameter
    }
}

class Program
{
    static void Main()
    {
        int result;
        CalculateResult(out result);
        Console.WriteLine(result); // Output: 100
    }

    // Method that calculates a result and assigns it via 'out'
    static void CalculateResult(out int calculation)
    {
        calculation = 20 * 5; // Must initialize the out parameter
    }
}

在这种情况下，Main反映了结果。

方法重载中 ref 的实际用途

ref关键字改变了方法签名。 方法签名由方法名称及其参数类型组成，包括参数是否通过引用(out参数传递。

考虑基于ref和值参数重载方法：

class Program
{
    static void Main()
    {
        int normalParameter = 10, refParameter = 10;
        IncrementValue(normalParameter);
        IncrementValue(ref refParameter);
        Console.WriteLine($"Normal: {normalParameter}, Ref: {refParameter}"); // Output: Normal: 10, Ref: 11
    }

    // Method that increments a copy of the integer
    static void IncrementValue(int number)
    {
        number++;
    }

    // Method that increments the original integer using 'ref'
    static void IncrementValue(ref int number)
    {
        number++;
    }
}

class Program
{
    static void Main()
    {
        int normalParameter = 10, refParameter = 10;
        IncrementValue(normalParameter);
        IncrementValue(ref refParameter);
        Console.WriteLine($"Normal: {normalParameter}, Ref: {refParameter}"); // Output: Normal: 10, Ref: 11
    }

    // Method that increments a copy of the integer
    static void IncrementValue(int number)
    {
        number++;
    }

    // Method that increments the original integer using 'ref'
    static void IncrementValue(ref int number)
    {
        number++;
    }
}

在这里，ref参数来重载。 ref版本递增原始变量，而普通版本只修改副本。

IronPDF简介

IronPDF for .NET PDF 解决方案是一个全面的 .NET 库，设计用于处理 PDF 文档。 它主要用 C# 构建，专注于简化从HTML 内容创建和操作 PDF。 通过采用 Chrome 渲染引擎，IronPDF 提供高质量的、像素完美的 PDF 文档，能够捕捉 HTML、CSS、JavaScript 和图像内容的细节。

此库通用，支持包括 .NET Framework、.NET Core 和 .NET Standard 在内的广泛 .NET 环境，使其适用于从桌面系统到基于 Web 的各种应用程序。 IronPDF 不仅支持 PDF 创建，还提供编辑、保护和将 PDF 转换为其他格式的功能。

这种功能扩展到提取文本和图像、填写表单，甚至应用数字签名，确保在 .NET 应用程序中全面处理 PDF 文档。

using IronPdf;
using System;

class Program
{
    static void Main(string[] args)
    {
        // Set your IronPDF license key
        License.LicenseKey = "License-Key";

        // Initialize the value
        int totalSales = 150;

        // Modify the value within the method using 'ref'
        AddMonthlyBonus(ref totalSales);

        // Use IronPDF to generate a PDF report
        var Renderer = new ChromePdfRenderer();
        var PDF = Renderer.RenderHtmlAsPdf($"<h1>Monthly Sales Report</h1><p>Total Sales, including bonus: {totalSales}</p>");

        // Save the PDF to a file
        PDF.SaveAs("MonthlySalesReport.pdf");

        // Confirm the PDF has been generated
        Console.WriteLine("PDF generated successfully. Check your project directory.");
    }

    // Method that adds a monthly bonus to sales using 'ref'
    static void AddMonthlyBonus(ref int sales)
    {
        // Assume a bonus of 10% of the sales
        sales += (int)(sales * 0.1);
    }
}

using IronPdf;
using System;

class Program
{
    static void Main(string[] args)
    {
        // Set your IronPDF license key
        License.LicenseKey = "License-Key";

        // Initialize the value
        int totalSales = 150;

        // Modify the value within the method using 'ref'
        AddMonthlyBonus(ref totalSales);

        // Use IronPDF to generate a PDF report
        var Renderer = new ChromePdfRenderer();
        var PDF = Renderer.RenderHtmlAsPdf($"<h1>Monthly Sales Report</h1><p>Total Sales, including bonus: {totalSales}</p>");

        // Save the PDF to a file
        PDF.SaveAs("MonthlySalesReport.pdf");

        // Confirm the PDF has been generated
        Console.WriteLine("PDF generated successfully. Check your project directory.");
    }

    // Method that adds a monthly bonus to sales using 'ref'
    static void AddMonthlyBonus(ref int sales)
    {
        // Assume a bonus of 10% of the sales
        sales += (int)(sales * 0.1);
    }
}

结论

理解C#中的ref关键字为管理数据在方法间的传递提供了一个有价值的工具。 通过允许方法直接修改传递给它们的参数的原始值，ref可以使您的方法更加灵活和强大。

随着您对ref的经验增加，您将更好地理解何时以及如何有效地使用它以满足您的编程需求。 IronPDF提供免费试用，以启动PDF能力，价格从$799开始。