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

특성 및 요소

다음 섹션에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.

특성

attribute Description
address 엔드포인트의 주소를 포함하는 문자열입니다. 주소는 절대 주소 또는 상대 주소로 지정할 수 있습니다. 상대 주소가 제공되는 경우 호스트는 바인딩에 사용된 전송 체계에 적합한 기본 주소를 제공합니다. 주소가 구성되지 않으면 해당 엔드포인트의 주소를 기본 주소로 가정합니다.

기본값은 빈 문자열입니다.
behaviorConfiguration 엔드포인트에 사용할 동작의 이름을 포함하는 문자열입니다.
바인딩 사용할 바인딩 형식을 지정하는 필수 문자열 특성입니다. 형식에 등록된 구성 섹션이 있어야 형식을 참조할 수 있습니다. 이 형식은 바인딩의 형식 이름이 아니라 섹션 이름으로 등록됩니다.
bindingConfiguration 엔드포인트가 인스턴스화될 때 사용하는 바인딩의 바인딩 이름을 지정하는 문자열입니다. 바인딩 이름은 엔드포인트가 정의된 지점의 범위에 속해야 합니다. 기본값은 빈 문자열입니다.

이 특성은 구성 파일에서 특정 바인딩 구성을 참조하기 위해 binding과 함께 사용됩니다. 사용자 지정 바인딩을 사용하려는 경우 이 특성을 설정하세요. 그렇지 않으면 예외가 throw될 수 있습니다.
bindingName WSDL을 통해 정의를 내보내기 위한 바인딩의 정규화된 고유 이름을 지정하는 문자열입니다. 기본값은 빈 문자열입니다.
bindingNamespace WSDL을 통해 정의를 내보내기 위한 바인딩 네임스페이스의 정규화된 이름을 지정하는 문자열입니다. 기본값은 빈 문자열입니다.
계약 이 엔드포인트가 공개하는 계약을 나타내는 문자열입니다. 어셈블리는 계약 형식을 구현해야 합니다. 서비스 구현에서 단일 계약 형식을 구현하는 경우 이 속성을 생략할 수 있습니다. 기본값은 빈 문자열입니다.
endpointConfiguration 이 표준 엔드포인트의 추가 구성 정보를 참조하는 kind 특성에 의해 설정되는 표준 엔드포인트의 이름을 지정하는 문자열입니다. 이와 동일한 이름이 <standardEndpoints> 섹션에서 정의되어야 합니다.
isSystemEndpoint 엔드포인트가 인프라 엔드포인트인지 여부를 지정하는 부울 값입니다.
kind 적용되는 표준 엔드포인트의 형식을 지정하는 문자열입니다. 형식은 <extensions> 섹션 또는 machine.config에 등록해야 합니다. 지정하지 않으면 일반 서비스 엔드포인트가 만들어집니다.
listenUriMode 서비스에서 수신하도록 제공된 ListenUri를 전송에서 처리하는 방법을 지정합니다. 유효한 값은 다음과 같습니다.

- 명시적
- 고유

기본값은 Explicit입니다.
listenUri 서비스 엔드포인트가 수신하는 URI를 지정하는 문자열입니다. 기본값은 빈 문자열입니다.
name 선택적 특성입니다. 서비스 엔드포인트의 이름을 지정하는 문자열입니다. 기본값은 바인딩 이름과 계약 설명 이름을 연결한 값입니다. 서비스에 엔드포인트가 여러 개일 수 있으므로 엔드포인트의 name 특성은 서비스 이름과 구분됩니다.

자식 요소

요소 Description
<headers> 주소 헤더 컬렉션입니다.
<identity> 한 엔드포인트에서 다른 엔드포인트와 메시지를 교환할 때 상대 엔드포인트를 인증할 수 있도록 하는 ID입니다.

부모 요소

요소 Description
<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>

참고 항목