CA1039: リストは厳密に型指定されています

[アーティクル]
08/09/2011

TypeName	ListsAreStronglyTyped
CheckId	CA1039
カテゴリ	Microsoft.Design
互換性に影響する変更点	あり

原因

パブリック型またはプロテクト型で System.Collections.IList が実装されていますが、次の 1 つ以上の対象に厳密に型指定されたメソッドがありません。

IList.Item
IList.Add
IList.Contains
IList.IndexOf
IList.Insert
IList.Remove

規則の説明

この規則では、IList で厳密に型指定されたメンバーを実装する必要があります。これは、ユーザーがインターフェイスに備わっている機能を使用するときに、必ずしも引数を System.Object 型にキャストするとは限らないためです。 IList インターフェイスは、インデックスからアクセスできるオブジェクトのコレクションで実装されます。この規則では、IList を実装する型でこの処理を行って、Object よりも厳密な型のインスタンスコレクションを管理すると想定しています。

IList は、System.Collections.ICollection インターフェイスと System.Collections.IEnumerable インターフェイスを実装します。 IList を実装する場合、ICollection に必要な厳密に型指定されたメンバーを提示します。コレクション内のオブジェクトで System.ValueType を拡張する場合、GetEnumerator に厳密に型指定したメンバーを提示します。これによって、ボックス化によるパフォーマンスの低下を防ぐことができます。コレクションのオブジェクトが参照型である場合、この処理は必要ありません。

この規則を順守するには、InterfaceName.InterfaceMemberName の形式の名前 (たとえば Add) で、インターフェイスのメンバーを明示的に実装します。明示的なインターフェイスメンバーでは、インターフェイスで宣言されたデータ型を使用します。 Add などのインターフェイスメンバー名を使用して、厳密に型指定されたメンバーを実装します。厳密に型指定されたメンバーをパブリックと宣言し、パラメーターと戻り値は、コレクションで管理される厳密な型になるように宣言します。インターフェイスで宣言されている Object や Array などの弱い型は、厳密な型で置換されます。

違反の修正方法

この規則違反を修正するには、IList メンバーを明示的に実装し、上記のメンバーを厳密に型指定したメンバーで置き換えます。 IList インターフェイスを適切に実装し、必要な厳密に型指定されたメンバーを提示したコードについては、以下の例を参照してください。

警告を抑制する状況

リンクされるリストは、新しいコレクションを拡張する型によって厳密な型が決まります。このように新しいオブジェクトベースのコレクションを実装する場合は、この規則による警告を抑制します。このような型では、この規則を順守し、厳密に型指定されたメンバーを公開します。

使用例

次の例では、型 YourType によって System.Collections.CollectionBase を拡張し、すべてのコレクションが厳密に型指定されます。 CollectionBase は、IList インターフェイスを明示的に実装しています。そのため、IList と ICollection に対して、厳密に型指定されたメンバーのみを提示する必要があります。

using System;
using System.Collections;
namespace DesignLibrary
{
   public class YourType
   {
      // Implementation for your strong type goes here.

      public YourType() {}
   }

   public class YourTypeCollection : CollectionBase
   {
      // Provide the strongly typed members for IList.
      public YourType this[int index]
      {
         get 
         {
            return (YourType) ((IList)this)[index];
         }
         set 
         {
            ((IList)this)[index] =  value;
         }
      }

      public int Add(YourType value)
      {
         return ((IList)this).Add ((object) value);
      }

      public bool Contains(YourType value) 
      {
         return ((IList)this).Contains((object) value);
      }

      public void Insert(int index, YourType value) 
      {
         ((IList)this).Insert(index, (object) value);
      }

      public void Remove(YourType value) 
      {
         ((IList)this).Remove((object) value);
      }

      public int IndexOf(YourType value) 
      {
         return ((IList)this).IndexOf((object) value);
      }

      // Provide the strongly typed member for ICollection.

      public void CopyTo(YourType[] array, int index)
      {
         ((ICollection)this).CopyTo(array, index);
      }
   }
}