CA2225：運算子多載必須有具名的替代方法

原因

偵測到運算子多載，且找不到預期的具名替代方法。

規則描述

運算子多載容許使用符號來表示型別的計算。例如，針對加法而多載加號 (+) 的型別通常會有名稱為 'Add' 的替代成員。具名的替代成員會提供與運算子相同的功能存取，並且可供以不支援多載運算子 (Overloaded Operator) 的語言設計程式的開發人員使用。

此規則會檢查下表所列的運算子。

N/A == 在選取的語言中不能多載。

此規則也會檢查名為 ToSomeType 和 FromSomeType 的方法，以檢查型別 (SomeType) 中的隱含和明確轉型運算子。

在 C# 中，當二元 (Binary) 運算子為多載時，同時隱含對應的指派運算子 (若有的話) 為多載。

如何修正違規

若要修正此規則的違規情形，請實作運算子的替代方法，即使用建議的替代名稱加以命名。

隱藏警告的時機

如果您正在實作共用程式庫，請勿隱藏此規則的警告。應用程式可忽略此規則的警告。

範例

下列範例會定義違反此規則的結構。若要修正範例，請在結構中加入公用 Add(int x, int y) 方法。

using System;

namespace UsageLibrary
{
    public struct Point
    {
        private int x,y;

        public Point(int x, int y)
        {
            this.x = x;
            this.y = y;
        }

        public override string ToString()
        {
            return String.Format("({0},{1})",x,y);
        }

        // Violates rule: OperatorOverloadsHaveNamedAlternates. 
        public static Point operator+(Point a, Point b)
        { 
            return new Point(a.x + b.x, a.y + b.y);
        }

        public int X {get {return x;}}
        public int Y {get {return x;}}
    }
}

相關規則

CA1046：請勿多載參考類型上的等號比較運算子

CA2226：運算子應該有對稱的多載

CA2224：多載等號比較運算子時必須一併覆寫 Equals

CA2218：覆寫 Equals 時必須一併覆寫 GetHashCode

CA2231：覆寫 ValueType.Equals 時必須一併多載等號比較運算子