重新命名端點的考量

更新：2007 年 11 月

在 [應用程式設計工具] 和 [系統設計工具] 中，視端點類型而定，您可以重新命名應用程式、系統和系統成員上的端點。重新命名端點時，請記住下列考量：

您必須為端點選擇唯一的名稱。端點名稱不得與資源名稱或 (如果在系統中) 系統成員的名稱衝突。
與系統定義模型 (SDM) 不相容的字元會從名稱中省略。如果產生的名稱與其他名稱或保留的 SDM 名稱衝突，則會將序數附加至名稱或進行遞增 (如果序數已存在的話)。如需 SDM 的詳細資訊，請參閱系統定義模型 (SDM) 概觀。
重新命名應用程式定義上的端點，便會重新命名在系統定義中所有使用該定義的端點。重新命名系統定義成員的端點，便會重新命名在應用系統定義上的端點，以及所有在其他系統定義中使用該定義的端點。
當您重新命名提供者端點時，除非應用程式圖表上已經有那些端點的連接，否則 Visual Studio 將不會更新對應的消費者端點值。

您可以視需要，在實作應用程式之前，先重新命名該應用程式定義上的端點。不過，一旦實作了應用程式後，視端點而定，重新命名端點會以不同的方式影響相關的專案檔。

例如，當您重新命名 .NET Web 服務提供者端點時，請記住下列考量：

如果 Web 服務類別名稱與端點名稱相同，則重新命名端點也會重新命名 Web 服務類別名稱。

注意事項：
如果 Web 服務類別檔案和 WSDL 服務的名稱與 Web 服務類別名稱相同，則重新命名 Web 服務類別名稱會使 Web 服務類別檔案和 WSDL 服務的名稱重新命名。如果 .asmx 檔案名稱和 WSDL 繫結名稱與 WSDL 服務名稱相同，則重新命名 WSDL 服務名稱會使 .asmx 檔案名稱和 WSDL 繫結名稱重新命名。

因此，如果您變更端點名稱，此變更可能會從端點名稱傳送到類別名稱，從類別名稱傳送到 WSDL 服務名稱，從 WSDL 服務名稱傳送到 .asmx 檔案名稱，然後再傳送到 WSDL 繫結名稱。

如果重新命名已實作的 Web 服務提供者端點會造成 .asmx 檔案名稱變更，則任何相關的 Web 參考和基礎 Proxy 類別都會遭到刪除，而這會導致對應的 Web 服務消費者端點成為未實作的狀態。您必須重新實作消費者端點，以產生新的 Web 參考。如果您正在使用原始程式碼控制，還必須簽入任何受影響的檔案，才能重新實作。若要重新實作 Web 服務消費者端點，請以滑鼠右鍵按一下端點，並選擇 [實作]。

如果重新命名已實作的 Web 服務提供者端點會造成 Web 服務名稱變更，則與 Web 服務之 Web 參考相關的 Proxy 類別將不再符合服務名稱。因此，可能不會編譯應用程式。若要解決這種狀況，請修正程式碼中會參考舊服務名稱的這些部分。

請參閱