메서드(C# 프로그래밍 가이드)

메서드는 일련의 문을 포함하는 코드 블록입니다. 프로그램을 통해 메서드를 호출하고 필요한 메서드 인수를 지정하여 문을 실행합니다. C#에서는 실행된 모든 명령이 메서드의 컨텍스트에서 수행됩니다.

Main 메서드는 모든 C# 애플리케이션의 진입점이고 프로그램이 시작될 때 CLR(공용 언어 런타임)에서 호출됩니다. 최상위 문을 사용하는 애플리케이션에서 Main 메서드는 컴파일러에 의해 생성되며 모든 최상위 문을 포함합니다.

메서드 시그니처

메서드는 클래스, 구조체 또는 인터페이스에서 액세스 수준(예: public 또는 private), 선택적 한정자(예: abstract 또는 sealed), 반환 값, 메서드 이름 및 기타 메서드 매개 변수를 지정하여 선언합니다. 이들 파트는 함께 메서드 서명을 구성합니다.

메서드 매개 변수는 괄호로 묶고 쉼표로 구분합니다. 빈 괄호는 메서드에 매개 변수가 필요하지 않음을 나타냅니다. 이 클래스에는 다음 네 개의 메서드가 있습니다.

abstract class Motorcycle
{
    // Anyone can call this.
    public void StartEngine() {/* Method statements here */ }

    // Only derived classes can call this.
    protected void AddGas(int gallons) { /* Method statements here */ }

    // Derived classes can override the base class implementation.
    public virtual int Drive(int miles, int speed) { /* Method statements here */ return 1; }

    // Derived classes must implement this.
    public abstract double GetTopSpeed();
}

메서드 액세스

개체에 대한 메서드 호출은 필드 액세스와 비슷합니다. 개체 이름 뒤에 마침표, 메서드 이름 및 괄호를 추가합니다. 인수는 괄호 안에 나열되고 쉼표로 구분합니다. Motorcycle 클래스의 메서드는 다음 예제와 같이 호출될 수 있습니다.

class TestMotorcycle : Motorcycle
{
    public override double GetTopSpeed()
    {
        return 108.4;
    }

    static void Main()
    {
        TestMotorcycle moto = new TestMotorcycle();

        moto.StartEngine();
        moto.AddGas(15);
        moto.Drive(5, 20);
        double speed = moto.GetTopSpeed();
        Console.WriteLine("My top speed is {0}", speed);
    }
}

메서드 매개 변수 및 인수

메서드 정의는 필요한 모든 매개 변수의 이름 및 형식을 지정합니다. 호출하는 코드에서 메서드를 호출할 때 해당 코드는 각 매개 변수에 대한 인수라는 구체적인 값을 제공합니다. 인수는 매개 변수 형식과 호환되어야 하지만 호출하는 코드에 사용된 인수 이름(있는 경우)은 메서드에 정의된 명명된 매개 변수와 동일할 필요가 없습니다. 예를 들어:

public void Caller()
{
    int numA = 4;
    // Call with an int variable.
    int productA = Square(numA);

    int numB = 32;
    // Call with another int variable.
    int productB = Square(numB);

    // Call with an integer literal.
    int productC = Square(12);

    // Call with an expression that evaluates to int.
    productC = Square(productA * 3);
}

int Square(int i)
{
    // Store input argument in a local variable.
    int input = i;
    return input * input;
}

참조로 전달할 것인지, 아니면 값으로 전달할 것인지 선택

기본적으로 값 형식의 인스턴스가 메서드에 전달될 때 인스턴스 자체가 아닌 해당 복사본이 전달됩니다. 따라서 인수에 대한 변경 내용은 호출하는 메서드의 원래 인스턴스에 영향을 주지 않습니다. 참조를 통해 값 형식 인스턴스를 전달하려면 ref 키워드를 사용합니다. 자세한 내용은 값 형식 매개 변수 전달을 참조하세요.

참조 형식의 개체가 메서드에 전달될 때 개체에 대한 참조가 전달됩니다. 즉, 메서드는 개체 자체가 아니라 개체의 위치를 나타내는 인수를 수신합니다. 이 참조를 사용하여 개체의 멤버를 변경하면 개체를 값으로 전달하더라도 변경 내용은 호출하는 메서드의 인수에 반영됩니다.

다음 예제와 같이 class 키워드를 사용하여 참조 형식을 만듭니다.

public class SampleRefType
{
    public int value;
}

이제 이 형식에 기반을 둔 개체를 메서드에 전달하면 개체에 대한 참조가 전달됩니다. 다음 예제에서는 SampleRefType 형식의 개체를 ModifyObject 메서드에 전달합니다.

public static void TestRefType()
{
    SampleRefType rt = new SampleRefType();
    rt.value = 44;
    ModifyObject(rt);
    Console.WriteLine(rt.value);
}

static void ModifyObject(SampleRefType obj)
{
    obj.value = 33;
}

이 예제는 인수를 값으로 메서드에 전달한다는 점에서 기본적으로 이전 예제와 같은 작업을 수행합니다. 그러나 참조 형식이 사용되므로 결과가 다릅니다. ModifyObject 에서 매개 변수 value 의 obj필드에 대해 수정한 내용으로 인해 value 메서드에서 rt인수의 TestRefType 필드도 변경됩니다. TestRefType 메서드는 출력으로 33을 표시합니다.

참조 형식을 참조 및 값으로 전달하는 방법에 대한 자세한 내용은 참조-형식 매개 변수 전달 및 참조 형식을 참조하세요.

반환 값

메서드는 호출자에 값을 반환할 수 있습니다. 메서드 이름 앞에 나열된 반환 형식이 void가 아니면 메서드는 return 문을 사용하여 값을 반환할 수 있습니다. return 키워드에 이어 반환 형식과 일치하는 값을 포함하는 문은 메서드 호출자에 값을 반환합니다.

호출자에게 값으로 또는 참조로 값을 반환할 수 있습니다. ref 키워드가 메서드 시그니처에 사용되고 각 return 키워드 뒤에 오면 값이 호출자에게 참조로 반환됩니다. 예를 들어 다음 메서드 시그니처 및 return 문은 메서드가 호출자를 참조하여 estDistance라는 변수를 반환함을 나타냅니다.

public ref double GetEstimatedDistance()
{
    return ref estDistance;
}

return 키워드는 메서드 실행을 중지합니다. 반환 형식이 void이면 값이 없는 return 문을 사용하여 메서드 실행을 중지할 수 있습니다. return 키워드를 사용하지 않으면 메서드는 코드 블록 끝에 도달할 때 실행을 중지합니다. return 키워드를 사용하여 값을 반환하려면 void가 아닌 반환 값을 포함한 메서드가 필요합니다. 예를 들어 이들 두 메서드에서는 return 키워드를 사용하여 정수를 반환합니다.

class SimpleMath
{
    public int AddTwoNumbers(int number1, int number2)
    {
        return number1 + number2;
    }

    public int SquareANumber(int number)
    {
        return number * number;
    }
}

메서드에서 반환된 값을 사용하려면 호출하는 메서드에서 같은 형식의 값으로 충분한 모든 경우에 메서드 호출 자체를 사용하면 됩니다. 반환 값을 변수에 할당할 수도 있습니다. 예를 들어 다음 두 코드 예제에서는 같은 목표를 달성합니다.

int result = obj.AddTwoNumbers(1, 2);
result = obj.SquareANumber(result);
// The result is 9.
Console.WriteLine(result);

result = obj.SquareANumber(obj.AddTwoNumbers(1, 2));
// The result is 9.
Console.WriteLine(result);

지역 변수(이 경우 result)를 사용하여 값을 저장하는 것은 선택 사항입니다. 코드의 가독성에 도움이 될 수 있고 전체 메서드 범위에 대해 인수의 원래 값을 저장해야 할 경우 필요할 수도 있습니다.

메서드에서 참조로 반환된 값을 사용하려면 해당 값을 수정하려는 경우 참조 지역 변수를 선언해야 합니다. 예를 들어 Planet.GetEstimatedDistance 메서드가 Double 값을 참조로 반환하는 경우 다음과 같은 코드를 사용하여 참조 지역 변수로 정의할 수 있습니다.

ref double distance = ref Planet.GetEstimatedDistance();

호출하는 함수가 배열을 M에 전달한 경우에는 배열 내용을 수정하는 M 메서드에서 다차원 배열을 반환할 필요가 없습니다. 좋은 스타일이나 값의 기능 흐름을 위해 M의 결과 배열을 반환할 수 있지만, C#에서는 모든 참조 형식을 값으로 전달하고 배열 참조의 값이 배열에 대한 포인터이기 때문에 필요하지 않습니다. 다음 예제와 같이 M 메서드의 배열 내용에 대한 변경 사항은 배열에 대한 참조가 있는 모든 코드에서 관찰할 수 있습니다.

static void Main(string[] args)
{
    int[,] matrix = new int[2, 2];
    FillMatrix(matrix);
    // matrix is now full of -1
}

public static void FillMatrix(int[,] matrix)
{
    for (int i = 0; i < matrix.GetLength(0); i++)
    {
        for (int j = 0; j < matrix.GetLength(1); j++)
        {
            matrix[i, j] = -1;
        }
    }
}

비동기 메서드

비동기 기능을 사용하면 명시적 콜백을 사용하거나 수동으로 여러 메서드 또는 람다 식에 코드를 분할하지 않고도 비동기 메서드를 호출할 수 있습니다.

메서드에 async 한정자를 표시하면 메서드에서 await 연산자를 사용할 수 있습니다. 컨트롤이 비동기 메서드의 await 식에 도달하면 컨트롤이 호출자로 돌아가고 대기 중인 작업이 완료될 때까지 메서드의 진행이 일시 중단됩니다. 작업이 완료되면 메서드가 실행이 다시 시작될 수 있습니다.

비동기 메서드는 일반적으로 반환 형식이 Task<TResult>, Task, IAsyncEnumerable<T> 또는 void입니다. void 반환 형식은 기본적으로 void 반환 형식이 필요할 때 이벤트 처리기를 정의하는 데 사용됩니다. void를 반환하는 비동기 메서드는 대기할 수 없고 void를 반환하는 메서드의 호출자는 메서드가 throw하는 예외를 catch할 수 없습니다. 비동기 메서드에는 작업과 유사한 반환 형식이 있을 수 있습니다.

다음 예제에서 DelayAsync 는 반환 형식이 Task<TResult>인 비동기 메서드입니다. DelayAsync 에는 정수를 반환하는 return 문이 포함됩니다. 따라서 DelayAsync 의 메서드 선언의 반환 형식은 Task<int>여야 합니다. 반환 형식이 Task<int>이므로 await 의 DoSomethingAsync 식 계산에서 다음 문과 같이 정수가 생성됩니다. int result = await delayTask.

Main 메서드는 반환 형식이 Task인 비동기 메서드의 한 가지 예입니다. DoSomethingAsync 메서드로 이동하며, 해당 메서드는 한 줄로 표현되므로 async 및 await 키워드를 생략할 수 있습니다. DoSomethingAsync 는 비동기 메서드이므로 다음 문과 같이 DoSomethingAsync 호출에 대한 작업을 기다려야 합니다. await DoSomethingAsync();.

class Program
{
    static Task Main() => DoSomethingAsync();

    static async Task DoSomethingAsync()
    {
        Task<int> delayTask = DelayAsync();
        int result = await delayTask;

        // The previous two statements may be combined into
        // the following statement.
        //int result = await DelayAsync();

        Console.WriteLine($"Result: {result}");
    }

    static async Task<int> DelayAsync()
    {
        await Task.Delay(100);
        return 5;
    }
}
// Example output:
//   Result: 5

비동기 메서드는 모든 ref 또는 out 매개 변수를 선언할 수 없지만, 이러한 매개 변수가 있는 메서드를 호출할 수는 있습니다.

비동기 메서드에 관한 자세한 내용은 async 및 await를 사용한 비동기 프로그래밍 및 비동기 반환 형식을 참조하세요.

식 본문 정의

일반적으로 식의 결과와 함께 바로 반환되거나 단일 문이 메서드 본문으로 포함된 메서드 정의가 있습니다. =>를 사용하여 해당 메서드를 속성을 정의하기 위한 구문 바로 가기는 다음과 같습니다.

public Point Move(int dx, int dy) => new Point(x + dx, y + dy);
public void Print() => Console.WriteLine(First + " " + Last);
// Works with operators, properties, and indexers too.
public static Complex operator +(Complex a, Complex b) => a.Add(b);
public string Name => First + " " + Last;
public Customer this[long id] => store.LookupCustomer(id);

메서드가 void 를 반환하거나 비동기 메서드이면 메서드 본문은 문 식이어야 합니다(람다에서와 같음). 속성 및 인덱서의 경우 읽기 전용이어야 하며, get 접근자 키워드를 사용하지 않습니다.

Iterators

반복기는 배열 목록과 같은 컬렉션에 대해 사용자 지정 반복을 수행합니다. 반복기는 yield return 문을 사용하여 각 요소를 따로따로 반환할 수 있습니다. yield return 문에 도달하면 코드의 현재 위치가 기억됩니다. 다음에 반복기가 호출되면 해당 위치에서 실행이 다시 시작됩니다.

foreach 문을 사용하여 클라이언트 코드에서 반복기를 호출합니다.

반복기의 반환 형식은 IEnumerable, IEnumerable<T>, IAsyncEnumerable<T>, IEnumerator 또는 IEnumerator<T>일 수 있습니다.

자세한 내용은 반복기를 참조하세요.

C# 언어 사양

자세한 내용은 C# 언어 사양을 참조하세요. 언어 사양은 C# 구문 및 사용법에 대 한 신뢰할 수 있는 소스 됩니다.

참고 항목

• C# 형식 시스템
• 액세스 한정자
• 정적 클래스 및 정적 클래스 멤버
• 상속
• 추상/봉인된 클래스 및 클래스 멤버
• params
• out
• ref
• 메서드 매개 변수