WsdCodeGen 구성 파일

  • 아티클

WsdCodeGen 구성 파일은 일반적으로 WsdCodeGen 도구에서 생성됩니다. 구성 파일을 수동으로 만들 수 있지만 파일의 복잡성과 길이는 일반적으로 손 코딩을 배제합니다. WsdCodeGen을 사용하여 파일을 생성하는 것이 좋습니다. 구성 파일 생성에 대한 자세한 내용은 WsdCodeGen 및 WsdCodeGen 명령줄 구문 사용을 참조하세요.

생성된 구성 파일을 검사하고 필요한 경우 소스 코드를 만들기 전에 수정해야 합니다. WsdCodeGen에서 생성된 구성 파일은 일반적으로 대부분의 클라이언트 개발에 충분합니다.

서버 개발에 구성 파일을 사용하려면 일부 수정이 필요합니다. 호스팅이 사용하도록 설정된 경우(예: "all" 또는 "host" 모드가 선택된 경우) 필요에 따라 ThisModelMetadata 요소 및 해당 자식 요소의 내용을 수정합니다. 또한 필요에 따라 ThisModelMetadata 요소 또는 Hosted 요소 내에서 PnPXDeviceCategory, PnPXHardwareId 및 PnPXCompatibleId 요소를 수정하거나 제거합니다.

구성 파일은 코드 생성을 위해 입력 데이터를 제공하는 요소 시퀀스 및 생성할 파일을 설명하는 파일 요소의 수로 구성됩니다. 입력 데이터에는 WSDL, XSD 및 관리되는 어셈블리에 표현된 형식에 대한 몇 가지 전역 속성 및 참조가 포함됩니다. 파일 요소의 텍스트 및 CDATA는 수정 없이 생성된 파일에 기록됩니다. 파일 요소의 다른 요소는 생성된 파일에서 생성된 코드로 대체됩니다.

XML 구성 파일은 코드 생성기 유틸리티에 사용할 수 있도록 적절한 형식을 지정하려면 몇 가지 일반적인 규칙을 따라야 합니다. 이러한 방법은 다음과 같습니다.

  • 모든 구성 파일의 루트 요소는 wsdCodeGen입니다.

  • 단순 데이터 형식을 포함하는 요소는 특성과 교환할 수 있습니다. 예:

    <wsdCodeGen>
    <layerNumber>1</layerNumber>
</wsdCodeGen>

    이는 다음과 동등합니다.

    <wsdCodeGen layerNumber="1"/>

  • 일반적으로 요소 순서에는 제약 조건이 없습니다. 예:

    <wsdCodeGen>
    <layerNumber>1</layerNumber>
    <layerPrefix>MEDIA_</layerPrefix>
</wsdCodeGen>

    이는 다음과 동등합니다.

    <wsdCodeGen>
    <layerPrefix>MEDIA_</layerPrefix>
    <layerNumber>1</layerNumber>
</wsdCodeGen>

    그러나 코드 생성기는 구성 파일을 단일 패스로 처리하며 순서 지정에는 몇 가지 관련성이 있습니다. 예를 들어 특정 포트 형식과 관련된 코드를 생성하는 파일 요소는 코드 생성기에 포트 형식 계약을 읽도록 지시하는 요소 다음에 발생해야 합니다.

WsdCodeGen 구성 파일에 사용되는 요소의 전체 목록은 WsdCodeGen 구성 파일 XML 참조를 참조하세요.

샘플 구성 파일은 Windows SDK에 포함됩니다. 자세한 내용은 WSDAPI 샘플을 참조하세요.

WsdCodeGen 정보

WSDAPI 샘플