<wellknown> 元素(服务实例)

包含有关应用程序向客户端公开的服务器激活(已知)对象的信息。

<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>

请参见

参考

远程处理设置架构

概念

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

Footer image

版权所有 (C) 2007 Microsoft Corporation。保留所有权利。