ターゲット プラットフォームにプロジェクトを構成する

Configuration Manager を使用したターゲット プラットフォーム

Configuration Manager には、プロジェクトを対象とする新しいプラットフォームをすばやく追加する方法が用意されています。 Visual Studio に含まれているプラットフォームのいずれかを選択した場合、選択したプラットフォームのプロジェクトをビルドするための構成が設定されます。

プロジェクト デザイナーまたはプロジェクト プロパティ UI のターゲット プラットフォーム

プロジェクト デザイナーまたはプロジェクト プロパティ UI には、プロジェクトを使用してさまざまなプラットフォームをターゲットにする方法も用意されています。 [ 新しいソリューション プラットフォーム ] ダイアログ ボックスの一覧に含まれるプラットフォームのいずれかを選択しても、ソリューションに対して機能しない場合は、カスタム構成名を作成し、[ プロジェクトのプロパティ] の設定を変更して、適切なプラットフォームをターゲットにすることができます。

このタスクの実行は、使用しているプログラミング言語によって異なります。 詳細については、次のリンクを参照してください。

• Visual Basic プロジェクトについては、「 /platform (Visual Basic)」を参照してください。

• C# プロジェクトについては、「 ビルド」ページ、プロジェクト デザイナー (C#) を参照してください。

32 ビット設定を優先する

.NET Framework 4.5 以降のプロジェクト のプロジェクト デザイナーの [ビルド] ページの [32 ビットの優先] 設定では、AnyCPU構成をビルドするが、アプリケーションが 32 ビット モードと 64 ビット モードの両方をサポートするプラットフォームで実行される場合は、アプリケーションを 32 ビット モードで実行する必要がある場合を処理します。 このチェック ボックスをオンにすると、 PlatformTarget ビルド プロパティが anycpu32bitpreferred に設定されます。 C# 用 PlatformTarget と Visual Basic 用 /platform に関するコメントを参照してください。

プロジェクト ファイルを手動で編集する

場合によっては、カスタム構成のためにプロジェクト ファイルを手動で編集する必要があります。 たとえば、2 つの異なるプラットフォームで異なる参照や、COM に公開するために特定のプラットフォームに登録する必要があるアセンブリなど、IDE で指定できない条件がある場合です。 プロジェクト ファイルを処理するツールは MSBuild です。

COM 登録

.NET アセンブリをビルドして COM に公開している場合、Visual Studio は、プラットフォーム アーキテクチャごとに異なるレジストリの場所 ( x86 や x64など) があるため、アセンブリを特定のプラットフォーム アーキテクチャに登録します。 アセンブリが既に特定のプラットフォームを対象とする場合、それが使用されますが、 Any CPU用にビルドされた .NET アセンブリを登録する場合、MSBuild は既定で MSBuild の現在のランタイムに登録します。 Visual Studio でビルドする場合、Visual Studio 2022 以降では x64 が使用され、それ以前の Visual Studio 2019 では x86 が使用されます。 この記事で既に説明した方法を使用してプラットフォーム アーキテクチャを設定した場合、またはプロジェクト ファイルで別の PlatformTarget を指定した場合、MSBuild は登録時にこれを考慮します。 この動作をオーバーライドするように設定できるプロパティ RegisterAssemblyMSBuildArchitecture。 RegisterAssemblyMSBuildArchitectureをプロジェクト ファイルの最上位レベルのx86要素に追加することで、目的のプラットフォーム アーキテクチャ (x64やPropertyGroupなど) に設定できます。

x86 および x64 アセンブリと DLL の参照

x86 と x64 の両方のバージョンを持つ .NET アセンブリまたは DLL がある場合があります。 これらの参照を使用するようにプロジェクトを設定するには、最初に参照を追加してから、プロジェクト ファイルを開いて編集し、構成とターゲット プラットフォームの両方を参照する条件を持つ ItemGroup を追加します。 たとえば、参照しているバイナリが ClassLibrary1 であり、デバッグ構成とリリース構成、および x86 バージョンと x64 バージョンのパスが異なるとします。 次に、次のように、設定のすべての組み合わせで 4 つの ItemGroup 要素を使用します。

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>netcoreapp2.0</TargetFramework>
    <Platforms>AnyCPU;x64;x86</Platforms>
  </PropertyGroup>

  <ItemGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|x64'">
    <Reference Include="ClassLibrary1">
      <HintPath>..\..\ClassLibrary1\ClassLibrary1\bin\x64\Debug\netstandard2.0\ClassLibrary1.dll</HintPath>
    </Reference>
  </ItemGroup>

  <ItemGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|x64'">
    <Reference Include="ClassLibrary1">
      <HintPath>..\..\ClassLibrary1\ClassLibrary1\bin\x64\Release\netstandard2.0\ClassLibrary1.dll</HintPath>
    </Reference>
  </ItemGroup>

  <ItemGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|x86'">
    <Reference Include="ClassLibrary1">
      <HintPath>..\..\ClassLibrary1\ClassLibrary1\bin\x86\Debug\netstandard2.0\ClassLibrary1.dll</HintPath>
    </Reference>
  </ItemGroup>
  
  <ItemGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|x86'">
    <Reference Include="ClassLibrary1">
      <HintPath>..\..\ClassLibrary1\ClassLibrary1\bin\x86\Release\netstandard2.0\ClassLibrary1.dll</HintPath>
    </Reference>
  </ItemGroup>
</Project>

プロジェクト ファイルの詳細については、 MSBuild プロジェクト ファイルのスキーマ リファレンスを参照してください。

関連コンテンツ

• /platform (C# コンパイラ オプション)
• 64 ビット アプリケーション
• Visual Studio IDE 64 ビット サポート
• プロジェクト ファイルについて