CA1903: 対象のフレームワークから API のみを使用します

原因

メンバーまたは型が、プロジェクトの対象のフレームワークに含まれていない Service Pack で導入されたメンバーまたは型を使用しています。

規則の説明

新しいメンバーと種類が、.NET Framework 2.0 Service Pack 1 および 2、.NET Framework 3.0 Service Pack 1 および 2、および .NET Framework 3.5 Service Pack 1 に含まれました。 メジャー バージョンの .NET Framework を対象にしたプロジェクトは、これらの新しい API に意図せず依存する可能性があります。 このような依存関係を回避するために、この規則は、既定でプロジェクトのターゲット フレームワークに含まれなかったすべての新しいメンバーと型の使用に適用されます。

ターゲット フレームワークと Service Pack の依存関係

プロジェクトのターゲット フレームワークを変更するには、「対象となる特定の .NET Framework のバージョンまたはプロファイルの指定」を参照してください。

違反の修正方法

Service Pack への依存関係を削除するには、新しいメンバーまたは型のすべての使用を削除します。 これが意図的な依存関係である場合は、警告を抑制するか、この規則を無効にします。

警告を抑制する状況

指定した Service Pack への意図的な依存関係でない場合は、この規則による警告を抑制しないでください。 この場合、この Service Pack がインストールされていないシステムでは、アプリケーションを実行できないことがあります。 これが意図的な依存関係である場合は、警告を抑制するか、この規則を無効にします。

使用例

次の例は、.NET 2.0 Service Pack 1 でのみ使用できる DateTimeOffset 型を使用するクラスを示しています。 この例では、[プロジェクトのプロパティ] の [ターゲット フレームワーク] ボックスの一覧で .NET Framework 2.0 を選択しておく必要があります。

using System;
namespace Samples
{
    public class LibraryBook
    {
        private readonly string _Title;
        private DateTimeOffset _CheckoutDate;   // Violates this rule
        public LibraryBook(string title)
        {
            _Title = title;
        }
        public string Title
        {
        get { return _Title; }
        }
        public DateTimeOffset CheckoutDate      // Violates this rule
        {
            get { return _CheckoutDate; }
            set { _CheckoutDate = value; }
        }
    }
}

DateTimeOffset 型を DateTime 型の使用に置き換えて、前に説明した違反を修正する例を次に示します。

using System;
namespace Samples
{
    public class LibraryBook
    {
        private readonly string _Title;
        private DateTime _CheckoutDate;
        public LibraryBook(string title)
        {
            _Title = title;
        }
        public string Title
        {
            get { return _Title; }
        }
        public DateTime CheckoutDate
        {
            get { return _CheckoutDate; }
            set { _CheckoutDate = value; }
        }
    }
}

参照

その他の技術情報

移植性に関する警告

対象となる特定の .NET Framework のバージョンまたはプロファイルの指定