ウォークスルー―C#/WinRT コンポーネントを作成し、C++/WinRT から使用する

C#/WinRT を使用すると、.NET を使用する開発者は、クラスライブラリプロジェクトを使用して C# で独自の Windows ランタイムコンポーネントを作成できます。作成されたコンポーネントは、ネイティブデスクトップアプリケーションでパッケージ参照として、またはいくつかの変更を加えたプロジェクト参照として使用できます。

このチュートリアルでは、C#/WinRT を使用して単純な Windows ランタイムコンポーネントを作成し、コンポーネントを NuGet パッケージとして配布し、C++/WinRT コンソールアプリケーションからコンポーネントを使用する方法について説明します。この記事のコードを提供する完全なサンプルについては、C#/WinRT 作成サンプルを参照してください。作成の詳細については、「作成コンポーネントを参照してください。

Windows App SDK アプリケーションで特に使用する C#/WinRT での WinUI コントロールの作成に関するチュートリアルについては、「チュートリアル: WinUI 3 コントロールを使用して C# コンポーネントを作成し、C++ Windows App SDK アプリケーションから使用する」記事を参照してください

[前提条件]

このチュートリアルでは、次のツールとコンポーネントが必要です。

Visual Studio 2022
.NET 6.0 SDK 以降
C++/WinRT VSIX の C++/WinRT プロジェクトテンプレート用

C#/WinRT を使用して単純な Windows ランタイムコンポーネントを作成する

まず、Visual Studio で新しいプロジェクトを作成します。プロジェクトテンプレートクラスライブラリを選択し、AuthoringDemoプロジェクトに名前を付けます。プロジェクトに次の追加と変更を加える必要があります。

TargetFramework ファイル内のを更新し、次の要素を PropertyGroupに追加します。
```
<PropertyGroup>
    <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
    <Platforms>x64</Platforms>
</PropertyGroup>
```
Windows ランタイムの種類にアクセスするには、TFM で特定の Windows SDK バージョンを設定する必要があります。サポートされているバージョンの詳細については、「.NET 6 以降: TFM オプション使用する」を参照してください。
Microsoft.Windows.CsWinRT NuGet パッケージをプロジェクトにインストールします。

a. ソリューションエクスプローラーで、プロジェクトノードを右クリックし、[NuGet パッケージの管理]選択します。

b。 Microsoft.Windows.CsWinRT NuGet パッケージを検索し、最新バージョンをインストールします。このチュートリアルでは、C#/WinRT バージョン 1.4.1 を使用します。
PropertyGroup プロパティを設定する新しい CsWinRTComponent 要素を追加します。プロジェクトをビルドするときに .winmd ファイルが生成されるように、プロジェクトが Windows ランタイムコンポーネントであることを指定します。
```
<PropertyGroup>   
    <CsWinRTComponent>true</CsWinRTComponent>
</PropertyGroup>
```
C#/WinRT プロジェクトのプロパティの完全な一覧については、C#/WinRT NuGet のドキュメントを参照してください。
ライブラリ .cs クラスファイルを使用してランタイムクラスを作成できます。 Class1.cs ファイルを右クリックし、Example.csに名前を変更します。このファイルに次のコードを追加します。これにより、ランタイムクラスにパブリックプロパティとメソッドが追加されます。ランタイムコンポーネントで公開するクラスは必ず publicとしてマークしてください。
```
namespace AuthoringDemo
{
    public sealed class Example
    {
        public int SampleProperty { get; set; }

        public static string SayHello()
        {
            return "Hello from your C# WinRT component";
        }
    }
}
```
これで、プロジェクトをビルドして、コンポーネントの .winmd ファイルを生成できるようになりました。ソリューションエクスプローラーのでプロジェクト右クリックし、[ビルドクリックします。生成された AuthoringDemo.winmd ファイルがビルド出力フォルダーに表示されます。

コンポーネントの NuGet パッケージを生成する

ほとんどの開発者は、Windows ランタイムコンポーネントを NuGet パッケージとして配布して共有したいと考えています。もう 1 つのオプションは、コンポーネントをプロジェクト参照として使用することです。次の手順では、AuthoringDemo コンポーネントをパッケージ化する方法を示します。パッケージを生成すると、C#/WinRT は、ネイティブアプリケーションからの使用を可能にするために、パッケージ内のコンポーネントとホスティングアセンブリを構成します。

NuGet パッケージを生成するには、いくつかの方法があります。

プロジェクトをビルドするたびに NuGet パッケージを生成する場合は、次のプロパティを AuthoringDemo プロジェクトファイルに追加し、プロジェクトをリビルドします。
```
<PropertyGroup>
    <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
</PropertyGroup>
```
または、ソリューションエクスプローラーので AuthoringDemo プロジェクトを右クリックし、 Packを選択して、NuGet パッケージを生成することもできます。

パッケージをビルドすると、ビルド ウィンドウに、NuGet パッケージ AuthoringDemo.1.0.0.nupkg が正常に作成されたことを示す必要があります。 .NET CLI を使用した NuGet パッケージのプロパティの詳細については、「dotnet CLI を使用してパッケージを作成する」を参照してください。

C++/WinRT アプリからコンポーネントを使用する

C#/WinRT で作成された Windows ランタイムコンポーネントは、任意の Windows ランタイム (WinRT) 互換言語から使用できます。次の手順では、C++/WinRT コンソールアプリケーションで上記の作成済みコンポーネントを呼び出す方法を示します。

注

C#/.NET アプリからの C#/WinRT コンポーネントの使用は、パッケージ参照とプロジェクト参照の両方でサポートされています。このシナリオは、通常の C# クラスライブラリを使用することと同じであり、ほとんどの場合、WinRT のアクティブ化は含まれません。 C#/WinRT 1.3.5 以降では、C# コンシューマーのプロジェクト参照には .NET 6 が必要です。

新しい C++/WinRT コンソールアプリケーション プロジェクトをソリューションに追加します。選択した場合、このプロジェクトは別のソリューションの一部になることもあります。

a. ソリューションエクスプローラーで、ソリューションノードを右クリックし、[ の追加 ] - [新しいプロジェクト]クリックします。

b。 [新しいプロジェクトの追加] ダイアログボックスで、C++/WinRT コンソールアプリケーション プロジェクトテンプレートを検索します。テンプレートを選択し、[次へ]をクリックします。

c. 新しいプロジェクトを CppConsoleApp と名前付けして、作成をクリックします。
NuGet パッケージまたはプロジェクト参照として AuthoringDemo コンポーネントへの参照を追加します。
- オプション 1 (パッケージリファレンス):
  
  a. CppConsoleApp プロジェクトを右クリックし、[NuGet パッケージの管理]を選択します。 AuthoringDemo NuGet パッケージへの参照を追加するようにパッケージソースを構成する必要がある場合があります。これを行うには、NuGet パッケージマネージャーの [設定] アイコンをクリックし、適切なパスにパッケージソースを追加します。
  
  b。パッケージソースを構成したら、AuthoringDemo パッケージを検索し、[インストール]をクリックします。
  
  をインストールする
- オプション 2 (プロジェクトリファレンス):
  
  a. CppConsoleApp プロジェクトを右クリックし、[ の追加 ] - [参照選択します。 [プロジェクト] ノードで、AuthoringDemo プロジェクトへの参照を追加します。
コンポーネントをホストするには、アクティブ化可能なクラス登録用のマニフェストファイルを追加する必要があります。マネージドコンポーネントホスティングの詳細については、「マネージドコンポーネントホスティング参照してください。

a. マニフェストファイルを追加するには、もう一度プロジェクトを右クリックし、[追加] - [新しい項目選択します。 テキストファイル テンプレートを検索し、CppConsoleApp.exe.manifestに名前を付けます。アクティブ化可能なクラス登録エントリを使用してランタイムクラスを指定する次の内容を貼り付けます。
```
<?xml version="1.0" encoding="utf-8"?>
<assembly manifestVersion="1.0" xmlns="urn:schemas-microsoft-com:asm.v1">
    <assemblyIdentity version="1.0.0.0" name="CppConsoleApp"/>
    <file name="WinRT.Host.dll">
        <activatableClass
            name="AuthoringDemo.Example"
            threadingModel="both"
            xmlns="urn:schemas-microsoft-com:winrt.v1" />
    </file>
</assembly>
```
パッケージ化されていないアプリには、アプリケーションマニフェストファイルが必要です。パッケージアプリケーションの場合、アプリの利用者は、アクティブ化可能なクラスを Package.appxmanifest パッケージマニフェストファイルに登録する必要があります。詳細は「チュートリアル: WinUI 3 コントロールを使用して C# コンポーネントを作成し、C++ Windows App SDK アプリケーションから利用する」で説明されています。

b。プロジェクトを配置するときに、出力にマニフェストファイルを含むようにプロジェクトを変更します。ソリューションエクスプローラーので CppConsoleApp.exe.manifest ファイルをクリックし、コンテンツプロパティを True設定します。この例を次に示します。

の展開をする
プロジェクトのヘッダーファイル pch.h を開き、コンポーネントを含める次のコード行を追加します。
```
#include <winrt/AuthoringDemo.h>
```

プロジェクトのソースファイルの下にある main.cpp を開き、次の内容に置き換えます。

#include "pch.h"
#include "iostream"

using namespace winrt;
using namespace Windows::Foundation;

int main()
{
    init_apartment();

    AuthoringDemo::Example ex;
    ex.SampleProperty(42);
    std::wcout << ex.SampleProperty() << std::endl;
    std::wcout << ex.SayHello().c_str() << std::endl;
}

CppConsoleApp プロジェクトをビルドして実行します。次の出力が表示されます。

サンプルコード
オーサリングコンポーネント
マネージドコンポーネントのホスティング

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-08-13

次の方法で共有

ウォークスルー―C#/WinRT コンポーネントを作成し、C++/WinRT から使用する

[前提条件]

C#/WinRT を使用して単純な Windows ランタイム コンポーネントを作成する

コンポーネントの NuGet パッケージを生成する

C++/WinRT アプリからコンポーネントを使用する

関連トピック

フィードバック

その他のリソース

C#/WinRT を使用して単純な Windows ランタイムコンポーネントを作成する