CA1043 : Utiliser un argument de chaîne ou intégral pour les indexeurs

Cause

Un type public ou protégé contient un indexeur public ou protégé qui utilise un type d'index autre que System.Int32, System.Int64, System.Object ou System.String.

Description de la règle

Les indexeurs, c'est-à-dire les propriétés indexées, doivent utiliser des types entier ou de chaîne pour l'index. Ces types sont généralement utilisés pour indexer des structures de données et augmentent la facilité d'utilisation de la bibliothèque. L'utilisation du type Object doit se restreindre aux cas où le type entier ou de chaîne spécifique ne peut pas être spécifié au moment du design. Si le design nécessite d'autres types pour l'index, reconsidérez le fait que le type représente ou non un magasin de données logique. S'il ne représente pas un magasin de données logique, utilisez une méthode.

Comment corriger les violations

Pour corriger une violation de cette règle, changez l'index en un type entier ou un type de chaîne, ou utilisez une méthode au lieu de l'indexeur.

Quand supprimer les avertissements

Supprimez un avertissement de cette règle uniquement après avoir soigneusement envisagé la nécessité de l'indexeur non standard.

Exemple

L'exemple suivant présente un indexeur qui utilise un index Int32.

Imports System

Namespace DesignLibrary

    Public Class Months

        Private month() As String = {"Jan", "Feb", "..."}

        Default ReadOnly Property Item(index As Integer) As String
            Get
                Return month(index)
            End Get
        End Property

    End Class

End Namespace

using System;

namespace DesignLibrary
{
    public class Months
    {
        string[] month = new string[] {"Jan", "Feb", "..."};

        public string this[int index]
        {
            get
            {
                return month[index];
            }
        }
    }
}

using namespace System;

namespace DesignLibrary
{
    public ref class Months
    {
        array<String^>^ month;

    public:
        property String^ default[int]
        {
           String^ get(int index)
           {
              return month[index];
           }
           void set(int index, String^ value)
           {
              month[index] = value;
           }
        }

        Months()
        {
            month = gcnew array<String^>(12);
            month[0] = "Jan";
            month[1] = "Feb";
            //...;
        }
    };
}

Règles connexes

CA1023 : Les indexeurs ne doivent pas être multidimensionnels

CA1024 : Utiliser les propriétés lorsque cela est approprié