转换参数重构

此重构可帮助您通过转换参数快速更改方法签名，例如，去除 出 参数，将参数包装在元组或新类中，等等。并自动更新解决方案中方法的所有用法。

此重构允许您执行以下转换：

将输入参数封装到参数对象中。重构将创建一个新类，其中包含与所选输入参数对应的公共字段或自动属性。
将返回值和 出 参数封装到返回对象中。重构将创建一个元组或新类，其中包含与所选返回组件和输出参数对应的公共字段或自动属性。
将部分返回元组组件转换为 出 参数，反之亦然。重构将使用所选输出值扩展返回元组，并从未选择的值创建 出 参数。
将 ref 参数的输入部分封装到参数对象中。重构将为与 ref 参数对应的未选择输出值替换修饰符为 出。
将 ref 参数的输出部分封装到返回元组或对象中。重构将删除与 ref 参数对应的未选择输入值的修饰符。
将参数和返回值封装到单个参数对象中。重构将为与所选返回组件和 出 参数对应的返回值创建额外的可写字段或属性。

以下示例展示了多种转换的组合——我们将 出 参数替换为方法返回值，并将另外两个参数包装到一个新类中：

            
class TestClass
{
  public void DrawCircle(Point ctr, float rad, out bool res)
  {
    // draw...
    res = true;
  }
}

        
  

            
class TestClass
{
  public bool DrawCircle(Circle circle)
  {
    // draw... .
    var res = true;
    return res;
  }
}

internal class Circle
{
  public Circle(Point ctr, float rad)
  {
    Ctr = ctr;
    Rad = rad;
  }

  public Point Ctr { get; private set; }
  public float Rad { get; private set; }
}

        
  

转换方法参数

将插入符号放置在编辑器中方法的声明或用法处，或在结构窗口窗口中选择该方法。或者，将插入符号放置在任意方法参数处。
请执行以下操作之一：
- 按 Alt+Enter 并选择转换形参。
- 按 Ctrl+Alt+Shift+T 然后选择转换形参。
- 在主菜单中选择重构 | 转换参数。
转换形参对话框将打开。
选择您想要转换的参数。
根据所选的输入/出 参数，JetBrains Rider 启用方法接收和/或方法返回选择器。使用这些选择器选择输入/出 参数的转换方式。如果您选择为参数创建一个新类，您将能够在其右侧的字段中指定其名称。
要应用重构，请点击下一步。
如果未发现冲突，JetBrains Rider会立即执行重构。否则，它会提示您解决冲突。
重构完成后，所有更改（包括其他文件中的更改）都会作为单个操作注册。因此，您可以使用撤销操作 Ctrl+Z ，通过单个按键撤销所有这些更改。

最后修改日期： 2025年 9月 26日