시그니처 변경Change Signature

대상: 함수의 매개 변수를 수정할 수 있습니다.What: Lets you modify a function's parameters.

시기: 다양한 위치에서 현재 사용 중인 함수의 매개 변수를 다시 정렬하거나, 다시 이동하거나, 수정하려고 합니다.When: You want to re-order, add, remove, or modify a function's parameters that is currently being used in a variety of locations.

이유: 이러한 매개 변수를 수동으로 제거한 다음, 해당 함수에 대한 모든 호출을 찾아 하나씩 변경할 수 있지만 오류가 발생할 수 있습니다.Why: You could manually change these parameters yourself, and then find all calls to that function and change them one-by-one, but that could lead to errors. 이 리팩터링 도구는 작업을 자동으로 수행합니다.This refactoring tool will perform the task automatically.

방법:How:

  1. 수정할 메서드 또는 해당 사용 중 하나의 이름 내부에 텍스트 또는 마우스 커서를 놓습니다.Place the text or mouse cursor inside the name of the method to modify, or one of its usages:

    강조 표시된 코드

  2. 다음 작업 중 하나를 수행합니다.Next, do one of the following:

    • 키보드Keyboard
      • Ctrl+R을 누른 다음, Ctrl+O를 누릅니다.Press Ctrl+R, then Ctrl+O. 바로 가기 키는 선택한 프로필에 따라 다를 수 있습니다.(Note that your keyboard shortcut may be different based on which profile you've selected.)
      • Ctrl+. 를 눌러Press Ctrl+. 빠른 작업 및 리팩터링 메뉴를 트리거하고, 팝업 메뉴에서 서명 변경을 선택합니다.to trigger the Quick Actions and Refactorings menu and select Change Signature from the context menu.
    • 마우스Mouse
      • 편집 > 리팩터링 > 매개 변수 다시 정렬을 선택합니다.Select Edit > Refactor > Reorder Parameters.
      • 코드를 마우스 오른쪽 단추로 클릭하고, 빠른 작업 및 리팩터링 메뉴를 선택하고, 팝업 메뉴에서 서명 변경을 선택합니다.Right-click the code, select the Quick Actions and Refactorings menu and select Change Signature from the context menu.
  3. 표시되는 시그니처 변경 대화 상자에서 오른쪽 단추를 사용하여 메서드 시그니처를 변경할 수 있습니다.In the Change Signature dialog that pops up, you can use the buttons on the right side to change the method signature:

    시그니처 변경 대화 상자

    단추Button 설명Description
    위쪽/아래쪽Up/Down 선택한 매개 변수를 목록에서 위아래로 이동합니다.Move the selected parameter up and down the list
    추가Add 목록에 새 매개 변수 추가Add a new parameter to the list
    제거Remove 목록에서 선택한 매개 변수를 제거합니다.Remove the selected parameter from the list
    수정Modify 해당 형식, 이름, 선택 사항 여부 및 삽입된 값을 변경하여 선택한 매개 변수를 수정합니다.Modify the selected parameter by changing its type, name, and whether it is optional, and what its injected value would be
    되돌리기Revert 선택한 매개 변수를 원래 상태로 복원합니다.Restore the selected parameter its original state
    모두 되돌리기Revert All 모든 매개 변수를 원래 상태로 복원합니다.Restore all parameters to their original state

    모든 참조를 확인하는 경우 미리 보기 참조 변경 내용 건너뛰기 확인란을 선택하여 미리 보기 창을 먼저 팝업하지 않고 즉시 변경할 수 있습니다.Use the Skip preview reference changes if all references are confirmed checkbox to make the changes immediately without the preview window popping up first.

    매개 변수를 추가하거나 수정하는 경우 매개 변수 추가 또는 매개 변수 편집 창이 표시됩니다.When adding or modifying a parameter, you will see the Add Parameter or Edit Parameter window.

    매개 변수 추가/수정

    여기에서 다음 작업을 수행할 수 있습니다.Here, you can do the following:

    입력Entry 설명Description
    TypeType 매개 변수의 형식(int, double, float 등)The type of the parameter (int, double, float, etc.)
    이름Name 매개 변수의 이름입니다.The name of the parameter
    선택적 매개 변수Optional Parameter 필요에 따라 매개 변수를 지정합니다.Makes the parameter optionally specified
    삽입된 값Injected Value 매개 변수를 지정하지 않은 함수에 대한 모든 호출에 삽입된 값입니다(추가의 경우에만 유효).The value inserted into any calls to the function where the parameter isn't specified (only valid for Add)
    기본값Default value 호출자가 지정하지 않은 경우 함수에서 사용하는 값입니다(선택적 매개 변수의 경우에만 유효).The value used by the function if the caller doesn't specify one (only valid for Optional Parameters)
  4. 검색 범위 드롭다운을 사용하 변경 내용이 프로젝트 또는 전체 솔루션에 적용되는지를 선택합니다.Use the Search scope drop down to select if the changes will apply to the project or the entire solution.

  5. 완료되면 확인 단추를 눌러 변경합니다.When you are finished, press the OK button to make the changes. 요청한 변경 내용이 적절하게 수행되었는지 확인합니다.Ensure that the changes you are requesting are being made appropriately. 창의 상단 중간에 있는 확인란을 사용하여 모든 항목의 이름 바꾸기를 사용하거나 사용하지 않도록 설정합니다.Use the checkboxes in the top half of the window to enable or disable the renaming of any item.

    서명 변경 미리 보기

  6. 모든 것이 문제 없는 경우 적용 단추를 클릭하면 함수가 소스 코드에서 변경됩니다.When everything looks good, click the Apply button and the function will be changed in your source code.

    시그니처 변경 결과