CA1043：必須針對索引子使用整數類或字串引數
型別名稱 |
UseIntegralOrStringArgumentForIndexers |
CheckId |
CA1043 |
分類 |
Microsoft.Design |
中斷變更 |
中斷 |
原因
公用或保護的型別所包含之公用或保護的索引子，使用了 System.Int32、System.Int64、System.Object 或 System.String 以外的索引型別。
規則描述
索引子 (也就是索引的屬性) 應該使用整數型別 (Integer Type) 或字串型別的索引。 這些型別通常會用於資料結構的索引，並且可以提升程式庫的可用性。 Object 型別的使用應限制於無法在設計階段指定特定整數型別或字串型別的情況。 如果設計需要使用其他型別的索引，請考慮該型別是否表示邏輯資料存放區。 如果不表示邏輯資料存放區的話，請使用方法。
如何修正違規
若要修正此規則的違規情形，請將索引變更為整數型別或字串型別，或使用方法來替代索引子。
隱藏警告的時機
只有在仔細考慮確實需要非標準索引子之後，才能隱藏此規則的警告。
範例
在下列範例中，程式碼會顯示使用 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";
//...;
}
};
}