CA1721：屬性名稱不能和其中有 get 的方法名稱相符

型別名稱	PropertyNamesShouldNotMatchGetMethods
CheckId	CA1721
分類	Microsoft.Naming
中斷變更	中斷

原因

公用或保護之成員的名稱是以 'Get' 開頭，否則需符合公用或保護之屬性的名稱。例如，包含名為 'GetColor' 的方法及名為 'Color' 的屬性的型別即違反這項規則。

規則描述

Get 方法和屬性的名稱應該清楚區別其功能。

命名慣例會為針對 Common Language Runtime 的程式庫提供通用的外觀。如此可縮短學習新軟體程式庫的時間，並讓客戶深信程式庫是由學有專長的人員以不斷開發的 Managed 程式碼開發而成。

如何修正違規

變更名稱，讓它不是以 'Get' 為字首的方法名稱。

隱藏警告的時機

請勿隱藏此規則的警告。

注意事項
如果是因為實作 IExtenderProvider 介面而導致 Get 方法，則可以排除這個警告。

範例

下列範例會包含違反這項規則的方法和屬性。

Imports System

Namespace NamingLibrary

Public Class Test

    Public ReadOnly Property [Date]() As DateTime
        Get
            Return DateTime.Today
        End Get
    End Property

     ' Violates rule: PropertyNamesShouldNotMatchGetMethods.
    Public Function GetDate() As String
        Return Me.Date.ToString()
    End Function 

End Class 

End Namespace

using System;

namespace NamingLibrary
{
    public class Test
    {
        public DateTime Date
        {
            get { return DateTime.Today; }
        }
         // Violates rule: PropertyNamesShouldNotMatchGetMethods.
        public string GetDate()
        {
            return this.Date.ToString();
        }
    }
}

相關規則

CA1024：建議在適當時使用屬性