大网数据广告活动
.NET 与 C# 开发

如何:创建发行者策略

· 52CE 我爱测

程序集的供应商可以声明应用程序应通过包括发布服务器策略文件与升级后的程序集使用的程序集的较新版本。 发布服务器策略文件指定程序集重定向和基本代码设置,并为应用程序配置文件使用相同的格式。 发布服务器策略文件编译到程序集中,放置在全局程序集缓存中。

程序集的供应商可以声明应用程序应通过包括发布服务器策略文件与升级后的程序集使用的程序集的较新版本。 发布服务器策略文件指定程序集重定向和基本代码设置,并为应用程序配置文件使用相同的格式。 发布服务器策略文件编译到程序集中,放置在全局程序集缓存中。

创建发布者策略时涉及的是三个步骤:

  1. 创建发布服务器策略文件。

  2. 创建发行者策略程序集。

  3. 将发行者策略程序集添加到全局程序集缓存中。

发布服务器策略的架构所述重定向程序集版本。 下面的示例显示了发布服务器策略文件,将重定向的一个版本myAssembly到另一个。

<configuration>  
   <runtime>  
      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">  
       <dependentAssembly>  
         <assemblyIdentity name="myAssembly"  
                           publicKeyToken="32ab4ba45e0a69a1"  
                           culture="en-us" />  
         <!-- Redirecting to version 2.0.0.0 of the assembly. -->  
         <bindingRedirect oldVersion="1.0.0.0"  
                          newVersion="2.0.0.0"/>  
       </dependentAssembly>  
      </assemblyBinding>  
   </runtime>  
</configuration>  

若要了解如何指定基本代码,请参阅指定程序集位置。

创建发行者策略程序集

使用程序集链接器 (Al.exe)创建发行者策略程序集。

若要创建发行者策略程序集
  1. 在命令提示符下键入以下命令:

    al /link: publisherPolicyFile /out: publisherPolicyAssemblyFile /keyfile: keyPairFile /platform: processorArchitecture

    在此命令:

    • PublisherPolicyFile参数是发布服务器策略文件的名称。

    • PublisherPolicyAssemblyFile参数是此命令生成的发布服务器策略程序集的名称。 程序集文件名称必须遵循格式:

      策略。 majorNumber 。 minorNumber 。 mainAssemblyName .dll

    • KeyPairFile参数是包含密钥对的文件的名称。 您必须签署的程序集和发行者策略程序集具有相同的密钥对。

    • ProcessorArchitecture参数标识的特定于处理器的程序集的目标平台。

      NOTE 面向特定的处理器体系结构的功能是.NET Framework 2.0 版中的新增功能。

    以下命令创建名为的发行者策略程序集policy.1.0.myAssembly发布服务器策略文件中名为pub.config,为使用的密钥对中的程序集分配强名称sgKey.snk文件,并指定该程序集针对 x86处理器体系结构。

    al /link:pub.config /out:policy.1.0.myAssembly.dll /keyfile:sgKey.snk /platform:x86  
    

    发行者策略程序集必须与它适用于该程序集的处理器体系结构匹配。 因此,如果您的程序集具有xref:System.Reflection.AssemblyName.ProcessorArchitecture*的值xref:System.Reflection.ProcessorArchitecture.MSIL,该程序集的发布服务器策略程序集必须使用创建/platform:anycpu。 必须提供一个单独的每个特定于处理器的程序集的发行者策略程序集。

    此规则的结果是版本号的,若要更改的程序集的处理器体系结构,必须更改的主要或次要组成部分,以便你可以提供具有正确的处理器体系结构的新发布服务器策略程序集。 一旦您的程序集具有不同处理器体系结构,旧的发行者策略程序集不能处理该程序集。

    另一个后果是版本 2.0 链接器不能用于创建编译使用早期版本的.NET Framework 中,因为它始终指定处理器体系结构的程序集的发行者策略程序集。

将发行者策略程序集添加到全局程序集缓存

使用全局程序集缓存工具 (Gacutil.exe)将发行者策略程序集添加到全局程序集缓存。

若要将发行者策略程序集添加到全局程序集缓存
  1. 在命令提示符下键入以下命令:

    gacutil /i publisherPolicyAssemblyFile

    以下命令将添加policy.1.0.myAssembly.dll到全局程序集缓存。

    gacutil /i policy.1.0.myAssembly.dll  
    

    IMPORTANT 发行者策略程序集不能添加到全局程序集缓存中,除非原始发布服务器策略文件位于与该程序集相同的目录中。

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。