Вопросы переименования конечных точек

Обновлен: Ноябрь 2007

В конструкторе приложений и конструкторе систем можно переименовать конечные точки для приложений, систем и элементов этих систем, в зависимости от типа конечной точки. В ходе переименования конечной точки следует учитывать следующие факторы.

• Необходимо выбрать уникальное имя для конечной точки. Имена конечных точек не должны конфликтовать с именами ресурсов, а при использовании в системе — с именами элементов системы.

• Из имен исключаются символы, несовместимые с моделью определения системы (SDM). Если полученное в результате имя вызывает конфликт с другим именем или зарезервированным именем модели SDM, то к имени добавляется порядковый номер или увеличивается существующий порядковый номер. Дополнительные сведения о модели SDM см. в разделе Общие сведения о модели определения системы (SDM).

• Переименование конечной точки в определении приложения распространяется на все случаи использования этого определения в определениях системы. Переименование конечной точки в элементе определения системы распространяется на конечную точку в определении приложения и на все случаи использования этого определения в определениях других систем.

• Во время переименования конечной точки поставщика среда Visual Studio не выполняет обновление соответствующей конечной точки потребителя, если между этими конечными точками на диаграмме приложения еще не существует подключение.

• Перед реализацией приложения можно необходимым образом переименовать конечные точки в определении этого приложения. Однако после реализации этого приложения переименование конечной точки по-разному влияет на сопоставленные файлы проекта, в зависимости от конечной точки.

  Например, в ходе переименования конечной точки поставщика веб-службы .NET следует учитывать следующие факторы.

  • По умолчанию имя конечной точки создается на основе имени службы WSDL. Например, если сначала выполнить реконструирование конечной точки веб-службы .NET, то имя конечной точки будет основано на имени службы WSDL.

  • Если имя класса веб-службы совпадает с именем конечной точки, то в результате переименования конечной точки будет переименован класс веб-службы.

    Примечание.
    Когда изменяется имя класса веб-службы, также изменяется имя файла класса веб-службы и имя службы WSDL, если эти имена совпадают с именем класса веб-службы. Когда изменяется имя службы WSDL, также изменяется имя ASMX-файла и имя привязки WSDL, если эти имена совпадают с именем службы WSDL.

    Поэтому, если изменить имя конечной точки, то это изменение может распространиться с имени конечной точки на имя класса, с имени класса на имя службы WSDL, затем на имя ASMX-файла и далее на имя привязки WSDL.

  • Если в результате переименования реализованной конечной точки поставщика веб-службы изменяется имя ASMX-файла, то удаляются все сопоставленные веб-ссылки и базовые прокси-класса, и в результате соответствующие конечные точки потребителя веб-службы становятся нереализованными. Чтобы создать новые веб-ссылки, необходимо заново реализовать конечные точки потребителя. Если используется управление исходным кодом, перед повторной реализацией также может понадобиться вернуть файлы, затронутые переименованием. Чтобы повторно реализовать конечную точку потребителя веб-службы, щелкните ее правой кнопкой мыши и выберите пункт Реализовать.

• Если в результате переименования реализованной конечной точки поставщика веб-службы изменяется имя веб-службы, то прокси-классы, сопоставленные с веб-ссылками на веб-службу, больше не будут соответствовать имени службы. В результате компиляция приложения может оказаться невозможной. Чтобы разрешить эту ситуацию, исправьте в коде места, которые ссылаются на старые имена служб.

См. также

Задачи

Практическое руководство. Переименование конечных точек в приложениях