Windows Communication Foundation 샘플 빌드

아티클
03/02/2011

WCF(Windows Communication Foundation) 샘플은 Visual Studio 2005를 사용하거나 명령줄에서 msbuild 명령을 사용하여 빌드할 수 있습니다. 이 항목에서는 이 두 절차를 모두 설명합니다.

참고:
WCF 샘플을 빌드하거나 실행하기 전에 Windows Communication Foundation 샘플의 일회 설치 절차를 수행해야 합니다.

명령 프롬프트를 사용하여 샘플을 빌드하려면

관리자 권한으로 Visual Studio 2010 명령 프롬프트를 열고 샘플을 설치한 디렉터리 위치 아래의 언어별 하위 디렉터리로 이동합니다.
명령줄에서 msbuild를 입력합니다. 클라이언트 프로그램 파일이 client\bin에 빌드되고 서비스 프로그램 파일이 service\bin에 빌드됩니다. IIS(인터넷 정보 서비스)에서 서비스를 호스팅하는 경우에는 서비스 프로그램 파일이 servicemodelsamples 디렉터리와 \bin 하위 디렉터리에도 복사됩니다.

참고:
실행에 사용하는 계정에 수정 권한을 부여하도록 %systemdrive%\inetpub\wwwroot의 ACL을 설정해야 합니다. 그러지 않으면 일부 빌드 후 이벤트가 실패합니다. 또는 ACL을 그대로 두고 관리자로 SDK 명령 프롬프트를 실행할 수도 있습니다.

Visual Studio를 사용하여 샘플을 빌드하려면

Windows Vista, Windows Server 2008, Windows 7 또는 Windows Server 2008 R2를 사용하고 있고 Visual Studio 2010을 실행하는 경우에는 높은 권한으로 Visual Studio를 실행해야 합니다. 이렇게 하려면 시작 메뉴에서 아이콘을 마우스 오른쪽 단추로 클릭하고 관리자 권한으로 실행을 클릭합니다.
Visual Studio의 파일 메뉴에서 열기를 클릭한 다음 프로젝트/솔루션을 클릭합니다. 샘플을 설치한 디렉터리 아래에 있는 언어별 하위 디렉터리로 이동한 다음 .sln 파일 아이콘을 두 번 클릭하여 Visual Studio에서 솔루션을 엽니다.
빌드 메뉴에서 솔루션 다시 빌드를 선택합니다. 클라이언트 프로그램 파일이 client\bin에 빌드되고 서비스 프로그램 파일이 service\bin에 빌드됩니다. IIS에서 서비스를 호스팅하는 경우에는 서비스 프로그램 파일이 servicemodelsamples 디렉터리와 \bin 하위 디렉터리에도 복사됩니다.

참고:
실행에 사용하는 계정에 수정 권한을 부여하도록 %systemdrive%\inetpub\wwwroot의 ACL을 설정해야 합니다. 그러지 않으면 일부 빌드 후 이벤트가 실패합니다. 또는 ACL을 그대로 두고 관리자로 SDK 명령 프롬프트 또는 Visual Studio를 실행할 수도 있습니다. ASP.NET 작업자 프로세스에 디버거를 연결하는 등의 일부 Visual Studio 작업을 수행하는 데에도 관리자 권한이 필요합니다.

실행에 사용하는 계정에 수정 권한을 부여하도록 %systemdrive%\inetpub\wwwroot의 ACL을 설정해야 합니다. 그러지 않으면 일부 빌드 후 이벤트가 실패합니다. 또는 ACL을 그대로 두고 관리자로 SDK 명령 프롬프트 또는 Visual Studio를 실행할 수도 있습니다. ASP.NET 작업자 프로세스에 디버거를 연결하는 등의 일부 Visual Studio 작업을 수행하는 데에도 관리자 권한이 필요합니다.

배치 파일 및 스크립트 설치

Setup.exe 및 Cleanup.exe 배치 파일과 스크립트는 Visual Studio 명령 프롬프트에서 실행해야 합니다. 일부 설치 및 정리 파일은 관리자 권한이 필요한 작업을 수행하므로 관리자 권한으로 실행해야 합니다.

메타데이터 끝점에 대한 중요한 보안 정보

중요한 서비스 메타데이터를 실수로 공개하는 일이 발생하지 않도록 WCF(Windows Communication Foundation) 서비스의 기본 구성에서는 메타데이터 게시를 사용하지 않도록 설정합니다. 이 동작은 기본적으로 안전하지만 구성에서 서비스의 메타데이터 게시 동작이 명시적으로 사용하도록 설정되어 있지 않은 경우 Svcutil.exe 등의 메타데이터 가져오기 도구를 사용하여 서비스를 호출하는 데 필요한 클라이언트 코드를 생성할 수 없습니다. 샘플로 보다 쉽게 작업할 수 있도록 거의 모든 샘플에서는 보안되지 않은 메타데이터 게시 끝점을 노출합니다. 이러한 끝점은 인증되지 않은 익명의 소비자가 사용할 수 있으므로 이러한 끝점을 배포하기 전에 서비스의 메타데이터를 공개하는 것이 적절한지 주의를 기울여야 합니다. 서비스 메타데이터 게시에 대한 자세한 내용은 Metadata Publishing Behavior 샘플을 참조하십시오. 메타데이터 끝점의 보안을 설정하는 샘플을 보려면 Custom Secure Metadata Endpoint 샘플을 참조하십시오.

예외 처리

일반적으로 이러한 샘플에는 코드가 샘플의 주제 위주로 작동하도록 예외 처리가 포함되어 있지 않습니다. 예외 처리에 대한 자세한 내용은 Expected Exceptions 샘플을 참조하십시오.

Svcutil을 사용하여 클라이언트 및 구성 다시 생성

ServiceModel Metadata 유틸리티 도구(Svcutil.exe)를 사용하여 대부분의 샘플의 클라이언트 코드 및 구성을 다시 생성할 수 있습니다. 일부 샘플에서는 구성을 수동으로 편집해야 합니다. 예를 들어, Svcutil.exe를 사용하여 클라이언트 인증서 자격 증명을 사용하는 샘플의 구성을 다시 생성하는 경우 이전에 구성된 자격 증명을 수동으로 지정해야 합니다. 일부 샘플에서는 생성된 코드에 영향을 주기 위해 특정 Svcutil.exe 옵션을 사용하며, 이러한 옵션은 특정 샘플 항목에 지정되어 있습니다.

클라이언트 및 구성 파일을 다시 생성하려면

SDK 명령 프롬프트를 열고 샘플을 설치한 디렉터리 위치 아래의 언어별 하위 디렉터리로 이동합니다.

웹 호스팅 서비스의 경우 다음 명령을 사용합니다.

svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" https://localhost/servicemodelsamples/service.svc/mex /out:generatedClient.cs

자체 호스팅 서비스의 경우 다음 명령을 입력합니다.

svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" https://localhost:8000/servicemodelsamples/service.svc/mex /out:generatedClient.cs

https://localhost:8000/ServiceModelSamples/service.svc/mex를 자체 호스팅 서비스의 mex 끝점 주소로 바꿉니다.

Visual Basic 형식에서 클라이언트를 생성하려면 다음 명령을 사용합니다.

svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" https://localhost/servicemodelsamples/service.svc/mex /l:vb /out:generatedClient.vb

자체 호스팅 서비스의 경우 다음 명령을 사용합니다.

svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" https://localhost:8000/servicemodelsamples/service.svc/mex /l:vb /out:generatedClient.vb

참고:
클라이언트 구성의 생성을 건너뛰려면 /noConfig 옵션을 추가합니다.

참고 항목

개념

Running the Windows Communication Foundation Samples
ServiceModel Metadata 유틸리티 도구(Svcutil.exe)

다음을 통해 공유