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