Visual Studio のマルチ ターゲットの概要Visual Studio multi-targeting overview

Visual Studio では、プロジェクトの対象となる .NET Framework のバージョンまたはプロファイルを指定できます。In Visual Studio, you can specify the version or profile of the .NET Framework that you want your project to target. 別のコンピューター上で実行するアプリケーションについては、アプリケーションが対象とする .NET Framework バージョンが、コンピューターにインストールされている .NET Framework バージョンとの互換性を持っている必要があります。For an application to run on another computer, the Framework version that the application targets must be compatible with the Framework version that is installed on the computer.

異なるバージョンのフレームワークを対象とする複数のプロジェクトを含むソリューションを作成することもできます。You can also create a solution that contains projects that target different versions of the framework. フレームワークを対象にする機能は、指定したバージョンのフレームワークで利用できる機能のみをアプリケーションで使用することを保証するのに役立ちます。Framework targeting helps guarantee that the application uses only functionality that is available in the specified version of the framework.

ヒント

異なるプラットフォームに対応する複数のアプリケーションを対象にすることもできます。You can also target applications for different platforms. 詳細については、MSBuild のマルチ ターゲットに関する記事をご覧ください。For more information, see Multitargeting.

フレームワークの対象設定機能Framework targeting features

フレームワークの対象設定機能には、次の特徴があります。Framework targeting includes the following features:

  • 旧バージョンの .NET Framework.NET Framework を対象とするプロジェクトを開いたときに、Visual Studio でそのプロジェクトを自動的にアップグレードするか、前のバージョンを対象とした状態を維持することができます。When you open a project that targets an earlier version of the .NET Framework.NET Framework, Visual Studio can automatically upgrade it or leave the target as-is.

  • プロジェクトを作成するときに、対象とする .NET Framework.NET Framework のバージョンを指定できます。When you create a project, you can specify the version of the .NET Framework.NET Framework that you want to target.

  • 既存のプロジェクトの対象となっている .NET Framework.NET Framework のバージョンを変更できます。You can change the version of the .NET Framework.NET Framework that an existing project targets.

  • 同じソリューション内にある複数のプロジェクトのそれぞれで、異なるバージョンの .NET Framework.NET Framework を対象とすることができます。You can target a different version of the .NET Framework.NET Framework in each of several projects in the same solution.

  • プロジェクトの対象となる .NET Framework.NET Framework のバージョンを変更すると、Visual StudioVisual Studio では、参照ファイルおよび構成ファイルに対して必要な変更が加えられます。When you change the version of the .NET Framework.NET Framework that a project targets, Visual StudioVisual Studio makes any required changes to references and configuration files.

旧バージョンの .NET Framework.NET Framework を対象とするプロジェクトで作業する場合は、Visual Studio は開発環境で次のような変更を動的に行います。When you work on a project that targets an earlier version of the .NET Framework.NET Framework, Visual Studio dynamically changes the development environment, as follows:

  • [新しい項目の追加][新しい参照の追加][サービス参照の追加] の各ダイアログ ボックスの項目をフィルター処理して、対象のバージョンで使用できない選択肢を除外します。It filters items in the Add New Item dialog box, the Add New Reference dialog box, and the Add Service Reference dialog box to omit choices that are not available in the targeted version.

  • ツールボックス内のカスタム コントロールをフィルター処理し、対象のバージョンで使用できないコントロールを除外したり、複数のコントロールが使用可能である場合に最新のコントロールのみを表示したりします。It filters custom controls in the Toolbox to remove those that are not available in the targeted version and to show the only the most up-to-date controls when multiple controls are available.

  • IntelliSense をフィルター処理して、対象のバージョンで使用できない言語機能を除外します。It filters IntelliSense to omit language features that are not available in the targeted version.

  • プロパティ ウィンドウのプロパティをフィルター処理して、対象のバージョンで使用できないプロパティを除外します。It filters properties in the Properties window to omit those that are not available in the targeted version.

  • メニュー オプションをフィルター処理して、対象のバージョンで使用できないオプションを除外します。It filters menu options to omit options that are not available in the targeted version.

  • ビルドを行う場合は、対象のバージョンに適したコンパイラのバージョンおよびコンパイラ オプションを使用します。For builds, it uses the version of the compiler and the compiler options that are appropriate for the targeted version.

注意

フレームワークの対象機能は、開発中のアプリケーションが正しく実行されることを保証するわけではありません。Framework targeting does not guarantee that your application will run correctly. 対象のバージョンで実行できるかどうかを確認するために、アプリケーションをテストする必要があります。You must test your application to make sure it runs against the targeted version. .NET Framework 2.0 より前のバージョンのフレームワークを対象にすることはできません。You cannot target framework versions that are earlier than the .NET Framework 2.0.

対象フレームワークのバージョンを選択するSelect a target framework version

プロジェクトを作成するときに、[新しいプロジェクト] ダイアログ ボックスで、対象の .NET Framework バージョンを選択します。When you create a project, select the target .NET Framework version in the New Project dialog box. 使用できる Framework のリストには、選択したテンプレートの種類に適用されるインストール済みの Framework バージョンが表示されます。The list of available frameworks includes the installed framework versions that are applicable to the selected template type. .NET Core テンプレートなどの .NET Framework を必要としないテンプレートの種類の場合、[Framework] ドロップダウン リストは表示されません。For template types that don't require .NET Framework, for example .NET Core templates, the Framework drop-down list is hidden.

[新しいプロジェクト] ダイアログ ボックスの [Framework] ドロップダウン リスト

既存のプロジェクトでは、プロジェクトのプロパティ ダイアログ ボックス内で、対象となる .NET Framework.NET Framework のバージョンを変更できます。In an existing project, you can change the target .NET Framework.NET Framework version in the project properties dialog box. 詳細については、「方法: .NET Framework のバージョンをターゲットにする」を参照してください。For more information, see How to: Target a version of the .NET Framework.

システム参照およびユーザー アセンブリ参照の解決Resolve system and user assembly references

.NET Framework の特定のバージョンを対象にするには、最初に適切なアセンブリ参照をインストールする必要があります。To target a .NET Framework version, you must first install the appropriate assembly references. .NET ダウンロード ページでさまざまなバージョンの .NET Framework の開発者向けパックをダウンロードすることができます。You can download developer packs for different versions of the .NET Framework on the .NET downloads page.

[参照の追加] ダイアログ ボックスでは、対象の .NET Framework.NET Framework のバージョンに関係しないシステム アセンブリが無効にされます。その結果、それらのアセンブリをプロジェクトに誤って追加することはありません The Add Reference dialog box disables system assemblies that do not pertain to the target .NET Framework.NET Framework version so that they cannot be added to a project inadvertently. (システム アセンブリとは、.NET Framework.NET Framework バージョンの一部である .dll ファイルのことです)。対象より新しいバージョンのフレームワークに属する参照は解決されず、そのような参照に依存するコントロールを追加することはできません。(System assemblies are .dll files that are included in a .NET Framework.NET Framework version.) References that belong to a framework version that is later than the targeted version will not resolve, and controls that depend on such a reference cannot be added. このような参照を有効にするには、プロジェクトの対象である .NET Framework.NET Framework を、その参照を含むバージョンに再設定します。If you want to enable such a reference, reset the .NET Framework.NET Framework target of the project to one that includes the reference. 詳細については、「方法: .NET Framework のバージョンをターゲットにする」を参照してください。For more information, see How to: Target a version of the .NET Framework.

アセンブリ参照の詳細については、「デザイン時のアセンブリの解決」を参照してください。For more information about assembly references, see Resolve assemblies at design time.

LINQ を有効にするEnable LINQ

.NET Framework Version 3.5 以降を対象にする場合は、System.Core の参照と System.Linq のプロジェクトレベル インポート (Visual Basic のみ) が自動的に追加されます。When you target the .NET Framework 3.5 or later, a reference to System.Core and a project-level import for System.Linq (in Visual Basic only) are added automatically. LINQ 機能を使用する場合は、Option Infer もオンにする必要があります (Visual Basic のみ)。If you want to use LINQ features, you must also turn Option Infer on (in Visual Basic only). 対象をそれより前のバージョンの .NET Framework に変更すると、この参照とインポートは自動的に削除されます。The reference and import are removed automatically if you change the target to an earlier .NET Framework version. 詳細については、「LINQ の使用」を参照してください。For more information, see Work with LINQ.

関連項目See also