<wellknown> 元素（服务实例）

  • 项目

本主题介绍一项传统技术，保留该技术是为了向后兼容现有的应用程序，不建议对新的开发使用该技术。现在应该使用  Windows Communication Foundation (WCF) 来开发分布式应用程序。

包含有关应用程序向客户端公开的服务器激活（已知）对象的信息。此元素可能出现在应用程序配置文件和计算机配置文件中。

Schema Hierarchy

<configuration>
  <system.runtime.remoting> 元素
    <application> 元素
      <service> 元素
        <wellknown> 元素（服务实例）

语法

<wellknown  
   mode="Singleton|SingleCall"
   displayName="name"
   type="type,assembly" 
      objectUri="objectUri" 
/>

特性和元素

以下几节描述了特性、子元素和父元素。

特性

特性 说明

mode

必需的特性。

指示对象是一个 Singleton 对象还是一个 SingleCall 对象。必须选择一个选项。有关详细信息，请参见激活。

objectUrl

必需的特性。

指定对象的统一资源标识符 (URI) 的终结点。

type

必需的特性。

指定对象的完整类型名和类型实现的程序集名称。如果包含程序集位于全局程序集缓存中，则此信息包括版本、区域性和公钥信息。

displayName

可选的特性。

由 .NET Framework 配置工具用来创建向此服务器注册要发布的服务器激活对象的列表。.NET Framework 远程处理系统不使用此特性。

子元素

无。

父元素

元素 说明

application

包含有关应用程序使用和公开的远程对象的信息。

configuration

公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中的根元素。

service

包含应用程序向其他应用程序域或上下文公开的对象。

system.runtime.remoting

包含有关远程对象和信道的信息。

备注

当对象承载于 Internet 信息服务 (IIS) 中时，objectUri 扩展名必须为 .soap 或 .rem，以便将请求路由到 .NET Framework 远程处理 IHttpHandler。

示例

下面的配置文件声明一个服务器激活（已知）类型、该类型所在的对象 URI 以及控制实例激活的 WellKnownObjectMode。

<configuration>
   <system.runtime.remoting>
      <application>
         <service>
            <wellknown 
               type="ServerActivatedType, RemoteAssembly" 
               objectUri="ServerType.rem" 
               mode="Singleton" 
            />
         </service>
      </application>
   </system.runtime.remoting>
</configuration>

另请参见

参考

远程处理设置架构

概念

激活远程对象
远程应用程序的配置

生成日期：2010-02-13