次の方法で共有

SatelliteContractVersionAttribute クラス

  • [アーティクル]

ResourceManager に対し、アプリケーションのメイン アセンブリの更新を簡略化するために、特定バージョンのサテライト アセンブリを要求するように指示します。

この型のすべてのメンバの一覧については、SatelliteContractVersionAttribute メンバ を参照してください。

System.Object
   System.Attribute
      System.Resources.SatelliteContractVersionAttribute

<AttributeUsage(AttributeTargets.Assembly)>
NotInheritable Public Class SatelliteContractVersionAttribute   Inherits Attribute
[C#]
[AttributeUsage(AttributeTargets.Assembly)]
public sealed class SatelliteContractVersionAttribute : Attribute
[C++]
[AttributeUsage(AttributeTargets::Assembly)]
public __gc __sealed class SatelliteContractVersionAttribute :   public Attribute
[JScript]
public
   AttributeUsage(AttributeTargets.Assembly)
class SatelliteContractVersionAttribute extends Attribute

スレッドセーフ

この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

解説

SatelliteContractVersionAttribute は、メイン アセンブリとそのすべてのサテライトとの間にコントラクトを確立します。 ResourceManager がリソースを検索する場合は、この属性で指定されたサテライト バージョンをメイン アセンブリに明示的に読み込み、間接層によってバージョン管理シナリオを簡略化できるようにします。

メイン アセンブリが更新されると、そのアセンブリのバージョン番号がインクリメントされます。ただし、サテライト アセンブリの既存のコピーが十分なものであり、また製品の新しいバージョンとも互換性がある場合は、サテライト アセンブリの新しいコピーを使用しません。この場合、メイン アセンブリのバージョン番号はインクリメントしますが、サテライト コントラクトのバージョン番号は同じままにします。 ResourceManager は、既存のサテライト アセンブリを使用します。

メイン アセンブリではなく、サテライト アセンブリを改訂する必要がある場合は、サテライトのバージョン番号をインクリメントする必要があります。この場合は、新しいサテライト アセンブリが古いサテライト アセンブリと下位互換性を持つことを示し、サテライト アセンブリと共にポリシー アセンブリを使用します。 ResourceManager は、メイン アセンブリに書き込まれた古いコントラクト番号を引き続き使用しますが、ローダーはポリシー アセンブリで指定されたサテライト アセンブリのバージョンにバインドします。

発行元ポリシー アセンブリは、リリースされた特定バージョンのアセンブリに関する互換性についてのステートメントを、共有コンポーネントの販売元が作成する方法です。発行元ポリシー アセンブリは、 policy.<major>.<minor>.<ComponentAssemblyName> 形式の名前を使用した厳密な名前を持つアセンブリであり、 グローバル アセンブリ キャッシュ (GAC) に登録されます。発行元ポリシーは、 アセンブリ リンカ (Al.exe) ツールを使用して、XML 構成ファイル (<bindingRedirect> 要素 を参照) から生成されます。アセンブリ リンカが /link オプションと共に使用され、XML 構成ファイルがマニフェスト アセンブリにリンクします。その後、このファイルは GAC に格納されます。発行元ポリシー アセンブリは、販売元がバグ修正を含むメンテナンス リリース (Service Pack) を出荷するときに使用できます。

メモ   この属性をメイン アセンブリに適用して、このメイン アセンブリのバージョンで動作するサテライト アセンブリのバージョン番号を渡します。

必要条件

名前空間: System.Resources

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

アセンブリ: Mscorlib (Mscorlib.dll 内)

参照

SatelliteContractVersionAttribute メンバ | System.Resources 名前空間