重命名终结点的注意事项

更新：2007 年 11 月

在应用程序设计器和系统设计器中，可以重命名应用程序、系统和系统成员上的终结点，具体则取决于终结点的类型。重命名终结点时，请记住下列注意事项：

必须为终结点选择唯一的名称。终结点名称不得与资源名称或（如果在系统中）系统成员的名称冲突。
名称中不能有与系统定义模型 (SDM) 不兼容的字符。如果所得到的名称与另一个名称或保留的 SDM 名称冲突，将在名称末尾追加序号，如果已存在序号，将使序号递增。有关 SDM 的更多信息，请参见系统定义模型 (SDM) 概述。
重命名应用程序定义上的终结点时，将重命名该定义在系统定义中所有使用之处的终结点。重命名系统定义成员上的终结点时，将重命名应用程序定义以及该定义在其他系统定义中所有使用之处的终结点。
重命名提供方终结点时，Visual Studio 将不会更新相应的使用方终结点，除非这些终结点在应用程序关系图上已建立连接。

实现应用程序之前，可以根据需要重命名该应用程序定义上的终结点。但在实现该应用程序后，重命名终结点会以不同的方式（取决于终结点）影响关联的项目文件。

例如，重命名 .NET Web 服务提供方终结点时，请记住下列注意事项：

如果 Web 服务类名与终结点名称相同，则重命名终结点也会重命名 Web 服务类名。

说明：
重命名 Web 服务类名时，如果 Web 服务类文件名和 WSDL 服务名称与 Web 服务类名相同，将会重命名 Web 服务类文件名和 WSDL 服务名称。重命名 WSDL 服务名称时，如果 .asmx 文件名和 WSDL 绑定名称与 WSDL 服务名称相同，将会重命名 .asmx 文件名和 WSDL 绑定名称。

因此，如果更改终结点名称，那么此更改有可能从终结点名称传播到类名，再从类名传播到 WSDL 服务名称，从 WSDL 服务名称传播到 .asmx 文件名，最后传播到 WSDL 绑定名称。

如果重命名已实现的 Web 服务提供方终结点导致 .asmx 文件名更改，则任何关联的 Web 引用和基础代理类都将被删除，这将导致对应的 Web 服务使用方终结点变为未实现。您需要重新实现使用方终结点，才能生成新的 Web 引用。如果使用了源代码管理，则可能还需要在重新实现之前签入所有受影响的文件。若要重新实现 Web 服务使用方终结点，请右击终结点，然后选择“实现”。

如果重命名已实现的 Web 服务提供方终结点导致 Web 服务名称更改，则与对该 Web 服务的 Web 引用关联的代理类将不再与该服务名称匹配。结果，可能不会编译该应用程序。若要解决此情况，请修复代码中引用旧服务名称的那些地方。

请参见