共用方式為


<endpoint> 元素

規範服務端點的綁定、合約及位址屬性,用於暴露服務。

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

語法

<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>

屬性和項目

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

Attributes

Attribute Description
address 一個包含端點位址的字串。 位址可指定為絕對位址或相對位址。 若提供相對位址,主機應提供適合綁定傳輸方案的基底位址。 如果未設定位址,則會假設基位址是該端點的位址。

預設值是空字串。
行為組態 一個包含端點要使用的行為名稱的字串。
繫結 需要一個字串屬性,指定要使用的綁定類型。 該型別必須有註冊的組態區段才能被引用。 類型是以區名註冊,而非以裝訂的類型名稱註冊。
bindingConfiguration 一個字串,指定綁定名稱,當端點實例化時使用。 綁定名稱必須在端點定義時的範圍內。 預設值是空字串。

此屬性與配置檔中的特定綁定設定搭配使用 binding 。 如果你想使用自訂綁定,請設定這個屬性。 否則,可能會拋出例外。
綁定名稱 一個字串,指定綁定的唯一限定名稱,以便透過 WSDL 匯出定義。 預設值是空字串。
綁定命名空間 一個字串,指定綁定命名空間的限定名稱,以便透過 WSDL 匯出定義。 預設值是空字串。
合約 一個字串,表示此端點正在暴露的是哪個契約。 組裝必須實作該合約類型。 如果服務實作實作單一合約類型,則可以省略這個屬性。 預設值是空字串。
endpointConfiguration 一個字串,指定由 kind 屬性設定的標準端點名稱,並參考該標準端點的額外配置資訊。 該區段必須定義 <standardEndpoints> 相同名稱。
isSystemEndpoint 一個布林值,用來指定一個端點是否為基礎架構端點。
類型 一個字串,用來指定所套用的標準端點類型。 該類型必須在該 <extensions> 區或 machine.config中註冊。若未指定,則建立一個共用服務端點。
listenUriMode 規定運輸如何對待服務的監聽對象 ListenUri 。 有效的數值為

- 明確
- 獨特

預設值為明確。
聽著Uri 一個字串,指定服務端點所監聽的 URI。 預設值是空字串。
名稱 選擇性屬性。 一個字串,指定服務端點的名稱。 預設值是綁定名稱與合約描述名稱的串接。 服務可能有多個端點,因此端點的 name 屬性與服務名稱不同。

子專案

元素 Description
<標頭> 一組位址標頭。
<身份> 一種身份,讓其他端點能夠透過交換訊息來驗證該端點。

父項目

元素 Description
<服役> 一個設定區段,定義了客戶端可連接的端點清單。

Example

這是一個服務端點配置的範例。

<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>

另請參閱