規範通道端點的合約、綁定及位址屬性,用戶端用此端點連接伺服器上的服務端點。
<組態>
<system.service模型>
<客戶端>
<終點>
語法
<endpoint address="String"
behaviorConfiguration="String"
binding="String"
bindingConfiguration="String"
contract="String"
endpointConfiguration="String"
kind="String"
name="String">
</endpoint>
屬性和項目
下列章節說明屬性、子元素和父元素。
Attributes
| Attribute | Description |
|---|---|
| address | 必要的字串屬性。 指定端點的位址。 預設值是空字串。 地址必須是絕對的URI。 |
| 行為組態 | 一個包含用來實例化端點的行為名稱的字串。 行為名稱必須在服務定義時仍在範圍內。 預設值是空字串。 |
| 繫結 | 必要的字串屬性。 一串指示要使用的綁定類型。 該型別必須有註冊的組態區段才能被引用。 類型是以區名註冊,而非裝訂的類型名稱。 |
| bindingConfiguration | 選擇性。 一個包含綁定設定名稱的字串,該組在端點實例化時會使用。 綁定配置必須在定義端點的範圍內。 預設值是空字串。 此屬性與配置檔中的特定綁定設定搭配使用 binding 。 如果你想使用自訂綁定,請設定這個屬性。 否則,可能會拋出例外。 |
| 合約 | 必要的字串屬性。 一個字串,表示此端點正在暴露的是哪個契約。 組裝必須實作該合約類型。 |
| endpointConfiguration | 一個字串,指定由 kind 屬性設定的標準端點名稱,並參考該標準端點的額外配置資訊。 該區段必須定義 <standardEndpoints> 相同名稱。 |
| 類型 | 一個字串,用來指定所套用的標準端點類型。 該類型必須在該 <extensions> 區或 machine.config中註冊。若未指定,則建立一個共同通道端點。 |
| 名稱 | 選擇性字串屬性。 此屬性唯一識別給定契約的端點。 你可以為同一合約類型定義多個客戶。 每個定義都必須以唯一的配置名稱來區分。 若省略此屬性,對應端點將作為與指定合約類型相關的預設端點。 預設值是空字串。name綁定的屬性用於透過 WSDL 匯出定義。 |
子專案
| 元素 | Description |
|---|---|
| <標頭> | 一組位址標頭。 |
| <身份> | 一種身份,讓其他端點能夠透過交換訊息來驗證該端點。 |
父項目
| 元素 | Description |
|---|---|
| <客戶端> | 一個設定區段,定義了客戶端可連接的端點清單。 |
Example
這是通道端點配置的範例。
<endpoint address="/HelloWorld/"
bindingConfiguration="usingDefaults"
name="MyBinding"
binding="customBinding"
contract="HelloWorld">
</endpoint>