Indexadores não devem ser multidimensionais

TypeName

IndexersShouldNotBeMultidimensional

CheckId

CA1023

Category (Categoria)

Microsoft.Design

Quebrando alterar

Quebrando

Causa

Um tipo público ou protegido contém um indexador público ou protegido que usa mais de um índice.

Descrição da regra

Os indexadores, isto é, propriedades indexadas, devem usar um único índice.Indexadores multidimensionais podem reduzir consideravelmente a usabilidade da biblioteca.Se o projeto requer vários índices, reconsidere se o tipo de um armazenamento de dados lógico representa.Caso contrário, use um método.

Como corrigir violações

Para corrigir uma violação dessa regra, altere o design para usar um único inteiro ou índice de seqüência ou use um método em vez do indexador.

Quando suprimir avisos

Elimina um aviso esta regra somente após considerar cuidadosamente a necessidade do indexador não padrão.

Exemplo

O exemplo a seguir mostra um tipo, DayOfWeek03, com um indexador multidimensional que viola a regra. O indexador pode ser visto sistema autônomo um tipo de conversão e, portanto, mais apropriado é exposto sistema autônomo um método.O tipo é redesenhado em RedesignedDayOfWeek03 para satisfazer a regra.

Imports System

Namespace DesignLibrary

    Public Class DayOfWeek03

        Private dayOfWeek(,) As String = {{"Wed", "Thu", "..."}, _
                                          {"Sat", "Sun", "..."}}
                                          ' ...

        Default ReadOnly Property Item(month As Integer, day As Integer) As String
            Get
                Return dayOfWeek(month - 1, day - 1)
            End Get
        End Property

    End Class

    Public Class RedesignedDayOfWeek03

        Private dayOfWeek() As String = _
            {"Tue", "Wed", "Thu", "Fri", "Sat", "Sun", "Mon"}
        Private daysInPreviousMonth() As Integer = _
            {0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30}

        Function GetDayOfWeek(month As Integer, day As Integer) As String
            Return dayOfWeek((daysInPreviousMonth(month - 1) + day) Mod 7)
        End Function

    End Class

End Namespace
using System;

namespace DesignLibrary
{
    public class DayOfWeek03
    {
        string[,] dayOfWeek = {{"Wed", "Thu", "..."}, 
                               {"Sat", "Sun", "..."}};
                               // ...

        public string this[int month, int day]
        {
            get
            {
                return dayOfWeek[month - 1, day - 1];
            }
        }
    }

    public class RedesignedDayOfWeek03
    {
        string[] dayOfWeek = 
            {"Tue", "Wed", "Thu", "Fri", "Sat", "Sun", "Mon"};

        int[] daysInPreviousMonth = 
            {0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30};

        public string GetDayOfWeek(int month, int day)
        {
            return dayOfWeek[(daysInPreviousMonth[month - 1] + day) % 7];
        }
    }
}
using namespace System;

namespace DesignLibrary
{
    public ref class DayOfWeek03
    {
        array<String^, 2>^ dayOfWeek;

    public:
        property String^ default[int,  int]
        {
            String^ get(int month, int day)
            {
                return dayOfWeek[month - 1, day - 1];
            }
        }

        DayOfWeek03()
        {
            dayOfWeek = gcnew array<String^, 2>(12, 7);
            dayOfWeek[0,0] = "Wed";
            dayOfWeek[0,1] = "Thu";
            // ...
            dayOfWeek[1,0] = "Sat";
            dayOfWeek[1,1] = "Sun";
            // ...
        }
    };

    public ref class RedesignedDayOfWeek03
    {
        static array<String^>^ dayOfWeek = 
            {"Tue", "Wed", "Thu", "Fri", "Sat", "Sun", "Mon"};

        static array<int>^ daysInPreviousMonth = 
            {0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30};

    public:
        String^ GetDayOfWeek(int month, int day)
        {
            return dayOfWeek[(daysInPreviousMonth[month - 1] + day) % 7];
        }
    };
}

Regras relacionadas

Utilize argumento integrais ou de seqüência de caracteres para os indexadores

Use propriedades onde for apropriado