Éviter les interfaces vides
Mise à jour : novembre 2007
TypeName |
AvoidEmptyInterfaces |
CheckId |
CA1040 |
Catégorie |
Microsoft.CSharp |
Modification avec rupture |
Oui |
Cause
L'interface ne déclare aucun membre, ni n'implémente deux ou plusieurs autres interfaces.
Description de la règle
Les interfaces définissent des membres qui fournissent un comportement ou un contrat d'utilisation. Les fonctionnalités décrites par l'interface peuvent être adoptées par tout type, indépendamment de l'endroit où le type figure dans la hiérarchie d'héritage. Un type implémente une interface en fournissant des implémentations pour les membres de celle-ci. Une interface vide ne définit aucun membre. Elle ne définit donc aucun contrat pouvant être implémenté.
Si votre conception comprend des interfaces vides que les types sont censés implémenter, vous utilisez probablement une interface en tant que marqueur, ou comme un moyen d'identifier un groupe de types. Si cette identification se produit au moment de l'exécution, la manière correcte d'y parvenir consiste à utiliser un attribut personnalisé. Utilisez la présence ou l'absence de l'attribut, ou les propriétés de l'attribut, pour identifier les types cible. Si l'identification doit se produire au moment de la compilation, utiliser une interface vide est acceptable.
Comment corriger les violations
Supprimez l'interface ou ajoutez-lui des membres. Si l'interface vide est utilisée pour étiqueter un jeu de types, remplacez-la par un attribut personnalisé.
Quand supprimer les avertissements
Il est possible de supprimer sans risque un avertissement de cette règle si l'interface est utilisée pour identifier un jeu de types au moment de la compilation.
Exemple
L'exemple suivant présente une interface vide.
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
{
};
}