方法とメタデータの要素の廃止

Microsoft コード ベースが進歩すると共に、いくつかのメソッドとメタデータ要素が不要になります。 Microsoft は、これらの古いメソッドとメタデータ要素を廃止とマークします。

• メソッドは SysObsolete 属性でマークされます。 通常、この属性は、代わりの方法を推奨します。
• メタデータ要素の場合、IsObsoleteプロパティがYesに設定されます。

廃止は、バイナリとデザイン時の両方と互換性があります。 参照元のコードは引き続き正常に機能し、当座はアクションは必要ありません。 コンパイル時、非推奨の成果物への参照がコンパイル警告として報告されます。

非推奨の要素のクリーンアップ

12 か月の期間後、Microsoft は古いメソッドおよびメタデータ要素を削除する可能性があります。

ただし、テレメトリが、古い形式のメソッドやメタデータ要素がまだ使用されていることを示す場合、Microsoft は、消費者の中断リスクを減らすため削除しません。

影響を受けるリスクを最小限にする

ここでは、メソッドおよびメタデータ要素が非推奨になるときに受ける影響を避けるために、Microsoft のコード ベースの消費者が使用できるヒントを示します。

• 少なくとも 12 か月ごとに、コード ベースを最新のコード ベースでコンパイルします。 非推奨の成果物が使用されるために警告が表示される場合は、できるだけ早く警告を解決します。
• 非推奨の成果物での新しい依存関係は避けてください。 リリースが利用可能になるタイミングとテレメトリが利用可能になるタイミングには時間差があるため、Microsoft は成果物を削除する可能性があります。

非推奨のメソッドとメタデータの要素のリスト

参考のため、各メジャー リリースで非推奨としてマークされているアーティファクトを示した Microsoft Excel ファイル ObsoleteElementsPerVersion.xlsx をダウンロードします。