共用方式為

CA1040：避免空的介面

  • 發行項

型別名稱

AvoidEmptyInterfaces

CheckId

CA1040

分類

Microsoft.Design

中斷變更

中斷

原因

介面並未宣告任何成員或實作兩個以上的其他介面。

規則描述

介面是用來定義一組可提供行為或程式使用合約的成員。不論型別出現在繼承階層架構 (Inheritance Hierarchy) 中的何處，任何型別都可以採用介面所描述的功能。型別會實作介面，方法是提供介面成員的實作。空白介面不會定義任何成員。因此，也不會定義能夠實作的合約。

如果您的設計會包含預期要實作之型別的空介面，那麼或許是使用介面做為資料標記或識別型別群組的方式。如果此識別發生於執行階段，則完成這個工作的正確方式是使用自訂屬性 (Attribute)。利用屬性 (Attribute) 的出現與否，或屬性 (Attribute) 的屬性 (Property)，辨識目標型別。如果此識別必須發生於編譯時期，則可以接受使用空的介面。

如何修正違規

移除介面或將成員加入至其中。如果空的介面用於標記一組型別，請以自訂屬性取代此介面。

隱藏警告的時機

當介面是用來在編譯時期辨識一組型別時，您可以放心地隱藏這項規則的警告。

範例

下列範例顯示空的介面。

Imports System     

Namespace Samples         

    Public Interface IBadInterface  ' Violates rule         
    End Interface      

End Namespace

using System;

namespace DesignLibrary
{
   public interface IBadInterface  // Violates rule
   {
   }
}

#include "stdafx.h" 
using namespace System;

namespace Samples
{
    // Violates this rule 
    public interface class IEmptyInterface    
    {    
    };
}