共用方式為


方法 (C# 程式設計手冊)

更新:2007 年 11 月

「方法」(Method) 是包含一系列陳述式 (Statement) 的程式碼區塊。程式會「呼叫」(Calling) 方法並指定所有必要的方法引數,藉以執行陳述式。在 C# 中,每個執行的指令都會在方法的內容中執行。Main 方法是所有 C# 應用程式的進入點,當程式啟動時,是由 Common Language Runtime (CLR) 所呼叫。

注意事項:

本主題將會討論具名方法。如需「匿名函式」(Anonymous Function) 的詳細資訊,請參閱匿名函式 (C# 程式設計手冊)

方法簽章

藉由指定 public 或 private 之類的存取層級、abstract 或 sealed 之類的選擇性修飾詞 (Modifier)、傳回值、方法名稱,以及任一方法參數,便可在類別建構中宣告方法。這些部分會共同組成該方法的「簽章」(Signature)。

注意事項:

方法的傳回型別,並不是可做為方法多載之用的方法簽章部分。然而,當判斷委派 (Delegate) 以及其所指向之方法之間的相容性時,它就是方法簽章的一部分。

方法參數會以括號括住且以逗號隔開。空白的括號表示該方法不需要參數。此類別包含三種方法:

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);            
    }
}

方法參數和引數的比較

方法定義會指定任何必要「參數」(Parameter) 的名稱和型別。當進行呼叫的程式碼呼叫方法時,會提供每個參數的具體值,此稱為「引數」(Argument)。引數必須與參數型別相容,但呼叫程式碼中使用的引數名稱 (如果有的話) 不必與方法中定義的參數名稱相同。例如:

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 evaulates to int.
    productC = Square(productA * 3);
}

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

以傳址方式傳遞和以傳值方式傳遞的比較

根據預設,當實值型別傳遞至方法時,所傳遞的是複本而非物件本身。所以對引數所做的變更在呼叫的方法內不會對原始複本造成任何影響。您可以使用 ref 關鍵字,以傳址 (By Reference) 方式傳遞實值型別。如需詳細資訊,請參閱傳遞實值型別的參數 (C# 程式設計手冊)。如需內建實值型別的清單,請參閱實值型別表 (C# 參考)

「參考型別」(Reference Type) 會以傳址方式傳遞。將參考型別的物件傳遞給方法時,參考是指向原始物件,而不是複本。所以,此參考所造成的變更將會反映在呼叫方法中。參考型別是使用 class 關鍵字建立的,如下列範例所示:

public class SampleRefType
{
    public int value;
}

現在,如果以這個型別為基礎的物件傳遞至某個方法,該物件就會以傳址方式傳遞。例如:

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 所做的修改就會對由 TestRefType 方法所建立的物件進行。因此,TestRefType 方法會顯示值 33。

如需詳細資訊,請參閱傳遞參考型別的參數 (C# 程式設計手冊)參考型別 (C# 參考)

傳回值

方法可將值傳回呼叫端。如果傳回型別 (也就是列在方法名稱前面的型別) 不是 void,該方法即可使用 return 關鍵字傳回值。只要在陳述式加上關鍵字 return,後面接著符合傳回型別的值,就會將該值傳回方法呼叫端。return 關鍵字也可以用來停止執行方法。如果傳回型別為 void,您仍可以使用未包含任何值的 return 陳述式來停止執行方法。若沒有關鍵字 return,方法將會在到達程式碼區塊結尾時停止執行。若方法的傳回型別為非 void,就必須使用 return 關鍵字才能傳回值。例如,這兩種方法使用 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);
obj.SquareANumber(result);
obj.SquareANumber(obj.AddTwoNumbers(1, 2));

在上面的程式碼中,並不一定要使用 result 這個區域變數來儲存值。不過,這個變數會讓程式碼更具可讀性,而且如果您要在整個程式碼範圍中儲存引數的原始值,就有必要使用這個變數。

如需詳細資訊,請參閱 return (C# 參考)

C# 語言規格

如需詳細資料,請參閱 C# 語言規格中的下列章節:

  • 1.6.6 方法

  • 10.6 方法

請參閱

概念

C# 程式設計手冊

參考

類別和結構 (C# 程式設計手冊)

存取修飾詞 (C# 程式設計手冊)

靜態類別和靜態類別成員 (C# 程式設計手冊)

繼承 (C# 程式設計手冊)

抽象和密封類別以及類別成員 (C# 程式設計手冊)

params (C# 參考)

return (C# 參考)

out (C# 參考)

ref (C# 參考)

傳遞參數 (C# 程式設計手冊)