リモート API は旧型式

  • [アーティクル]

一部のリモート処理関連の API は古いものとしてマークされており、コンパイル時に SYSLIB0010 警告が生成されます。 これらの API は、将来のバージョンの .NET で削除される可能性があります。

変更内容

次のリモート API は、古いものとしてマークされています。

API 古いものとしてマークされる対象
MarshalByRefObject.GetLifetimeService() 5.0 RC1
MarshalByRefObject.InitializeLifetimeService() 5.0 RC1

.NET Framework 2.x から 4.x では、GetLifetimeService() および InitializeLifetimeService() メソッドによって、.NET リモート処理に関するインスタンスの有効期間が制御されます。 .NET Core 2.x から 3.x では、これらのメソッドによって常に、実行時に PlatformNotSupportedException がスローされます。

.NET 5 以降のバージョンでは、GetLifetimeService() および InitializeLifetimeService() メソッドは古いものとしてマークされ、警告が示されますが、実行時には引き続き PlatformNotSupportedException がスローされます。

// MemoryStream, like all Stream instances, subclasses MarshalByRefObject.
MemoryStream stream = new MemoryStream();
// Throws PlatformNotSupportedException; also produces warning SYSLIB0010.
obj.InitializeLifetimeService();

これは、コンパイル時のみの変更です。 実行時については、以前のバージョンの .NET Core からの変更はありません。

変更理由

.NET リモート処理はレガシ テクノロジです。 これにより、(異なるコンピューター上にある可能性があっても) 別のプロセスでオブジェクトをインスタンス化し、通常のインプロセス .NET オブジェクト インスタンスの場合と同じように、そのオブジェクトとやりとりすることができます。 .NET リモート処理インフラストラクチャは .NET Framework 2.x から 4.x にのみ存在します。 .NET Core および .NET 5 以降のバージョンで .NET リモート処理はサポートされておらず、リモート API が存在しないか、常にこれらのランタイムで例外がスローされます。

開発者がこれらの API を使用しないようにするために、選択されたリモート処理関連の API を古いものと見なしています。 これらの API は、将来のバージョンの .NET で完全に削除される可能性があります。

導入されたバージョン

.NET 5.0

  • 他のアプリケーションの、または複数のコンピューターのオブジェクトと通信する場合は、WCF または HTTP ベースの REST サービスの使用を検討してください。 詳細については、.NET Core で使用できない .NET Framework テクノロジに関するページを参照してください。

  • 古い API を引き続き使用する必要がある場合は、コードで SYSLIB0010 警告を抑制することができます。

    MarshalByRefObject obj = GetMarshalByRefObj();
#pragma warning disable SYSLIB0010 // Disable the warning.
obj.InitializeLifetimeService(); // Still throws PNSE.
obj.GetLifetimeService(); // Still throws PNSE.
#pragma warning restore SYSLIB0010 // Reenable the warning.

    プロジェクト ファイルで警告を抑制することもできます。これにより、プロジェクト内のすべてのソース ファイルに対して警告が無効になります。

    <Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
   <TargetFramework>net5.0</TargetFramework>
   <!-- NoWarn below will suppress SYSLIB0010 project-wide -->
   <NoWarn>$(NoWarn);SYSLIB0010</NoWarn>
  </PropertyGroup>
</Project>

    SYSLIB0010 を抑制すると、リモート API が古いという警告のみが無効になります。 それ以外の警告は無効になりません。 また、常に PlatformNotSupportedException をスローするハードコーディングされた実行時の動作は変更されません。

影響を受ける API