<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