<endpoint> 元素

  • 發行項

指定服務端點的繫結、合約和位址屬性，以用於公開服務。

<configuration>
  <system.serviceModel>
    <services>
      <service>
        <endpoint>

Syntax

<endpoint address="String"
          behaviorConfiguration="String"
          binding="String"
          bindingConfiguration="String"
          bindingName="String"
          bindingNamespace="String"
          contract="String"
          endpointConfiguration="String"
          isSystemEndpoint="Boolean"
          kind="String"
          listenUriMode="Explicit/Unique"
          listenUri="Uri">
</endpoint>

屬性和項目

下列章節說明屬性、子元素和父元素。

屬性

屬性 描述
address 包含端點位址的字串。 位址可以指定為絕對或相對位址。 如果提供相對位址，主機必須為繫結中使用的傳輸配置提供適當的基底位址。 如果沒有設定位址，會將基底位址假設為該端點的位址。

預設為空字串。
behaviorConfiguration 字串，其中包含端點中所使用行為的名稱。
繫結 必要的字串屬性，其中指定要使用的繫結型別。 此型別必須要有註冊的組態區段，才能加以參考。 型別是以區段名稱進行註冊，而非以繫結的型別名稱進行註冊。
bindingConfiguration 字串，指定在產生端點時所使用繫結的繫結名稱。 繫結名稱必須在定義端點之處的範圍內。 預設為空字串。

這個屬性用於搭配 binding 使用，以參考組態檔中特定的繫結組態。 如果您要嘗試使用自訂繫結，請設定這個屬性。 否則，會擲回例外狀況。
bindingName 字串，指定透過 WSDL 匯出定義之繫結的唯一限定名稱。 預設為空字串。
bindingNamespace 字串，指定透過 WSDL 匯出定義之繫結的命名空間限定名稱。 預設為空字串。
合約 指示這個端點要公開 (Expose) 之合約的字串。 組件必須實作合約類型。 如果服務實作實作單一合約類型，便可省略這個屬性。 預設為空字串。
endpointConfiguration 字串，這個字串會指定 kind 屬性所設定的標準端點名稱，該屬性會參考這個標準端點的其他組態資訊。 必須在 <standardEndpoints> 區段中定義相同的名稱。
isSystemEndpoint 布林值，用於指定端點是否為基礎結構端點。
kind 字串，這個字串會指定所套用之標準端點的型別。 此型別必須在 <extensions> 區段或 machine.config 中註冊。如果未指定任何項目，即會建立一般服務端點。
listenUriMode 指定傳輸如何處理提供給服務接聽的 ListenUri。 有效值為

- 明確
- 唯一

預設值為 Explicit。
listenUri 字串，指定服務端點接聽的 URI。 預設為空字串。
NAME 選擇性屬性。 指定服務端點名稱的字串。 預設值是繫結名稱和合約描述名稱的串連。 服務可能會有多個端點，因此端點的 name 屬性會與服務的名稱有所區別。

子元素

元素 描述
<headers> 位址標頭的集合。
<identity> 身分識別，可讓其他端點與此端點交換訊息，以啟用端點的驗證。

父項目

元素 描述
<service> 組態區段，它會定義用戶端可以連線的端點清單。

範例

這是服務端點組態的範例。

<endpoint address="/HelloWorld/"
          bindingConfiguration="usingDefaults"
          bindingName="MyBinding"
          binding="customBinding"
          contract="HelloWorld">
  <headers>
    <region xmlns="http://tempuri.org/">EastCoast</region>
    <member xmlns="http://tempuri.org/">Gold</member>
  </headers>
</endpoint>

另請參閱