<wellknown> 元素（客户端实例）

  • 项目

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

包含有关应用程序要使用的服务器激活（已知）对象的信息。当客户端使用 <wellknown> 元素时，其父元素 <client> 并不需要 url 特性。此元素可能出现在应用程序配置文件和计算机配置文件中。

Schema Hierarchy

<configuration>
  <system.runtime.remoting> 元素
    <application> 元素
      <client> 元素
        <wellknown> 元素（客户端实例）

语法

<wellknown  
   url="url" 
   displayName="displayName" 
   type="type,assembly"
/>

特性和元素

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

特性

特性 说明

type

必需的特性。

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

url

必需的特性。

指定服务器激活类型的完整 URL，包括对象的统一资源标识符 (URI)。

displayName

可选的特性。

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

子元素

无。

父元素

元素 说明

application

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

client

包含应用程序使用的对象。由于 url 特性是客户端激活类型所必需的，而不是服务器激活类型所必需的，因此每个唯一的 URL 都将有自己的 client 元素，该元素包含在该位置发布的客户端激活类型。

configuration

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

system.runtime.remoting

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

示例

下面的配置文件声明供使用的服务器激活（已知）远程类型，并指定客户端应用程序应使用 HttpChannel，但应允许 .NET Framework 远程处理系统为客户端查找合适的端口。

<configuration>
   <system.runtime.remoting>
      <application>
         <client>
            <wellknown 
               type="RemoteType, RemoteAssembly"
               url="http://computername:8080/RemoteType.rem"
            />
         </client>
         <channels>
            <channel
               ref="http" 
               port="0"
            />
         </channels>
      </application>
   </system.runtime.remoting>
</configuration>

另请参见

参考

远程处理设置架构

概念

激活远程对象

生成日期：2010-02-13