방법: Windows Communication Foundation 클라이언트 만들기

아티클
09/12/2008

이 작업은 기본 WCF(Windows Communication Foundation) 서비스와 이 서비스를 호출할 수 있는 클라이언트를 만드는 데 필요한 6가지 작업 중 네 번째입니다. 6가지 작업의 개요를 모두 보려면 초보자를 위한 자습서 항목을 참조하십시오.

이 항목에서는 WCF 서비스에서 메타데이터를 검색하고 이를 사용하여 서비스에 액세스할 수 있는 WCF 프록시를 만드는 방법에 대해 설명합니다. 이 작업은 WCF에서 제공하는 ServiceModel Metadata Utility Tool (Svcutil.exe)를 사용하여 수행합니다. 이 도구는 서비스로부터 메타데이터를 가져와 사용자가 선택한 언어를 사용하여 프록시에 대한 관리되는 소스 코드 파일을 생성합니다. 클라이언트를 만드는 것 이외에 해당 도구는 클라이언트에 대한 구성 파일도 만듭니다. 이 구성 파일을 사용하여 클라이언트 응용 프로그램에서 해당 끝점 중 하나의 서비스에 연결할 수 있습니다.

클라이언트 응용 프로그램은 생성된 프록시를 사용하여 WCF 클라이언트 개체를 만듭니다. 이 절차에 대해서는 방법: Windows Communication Foundation 클라이언트 사용에서 설명합니다.

이 작업에서 생성된 클라이언트 코드는 다음 예제 절차에서 제공됩니다.

Windows Communication Foundation 클라이언트를 만들려면

Visual Studio 2008에서 다음 단계를 수행하여 클라이언트의 현재 솔루션에서 새 프로젝트를 만듭니다.
1. 서비스가 포함된 동일한 솔루션 내의 오른쪽 위에 있는 솔루션 탐색기에서 프로젝트가 아니라 현재 솔루션을 마우스 오른쪽 단추로 클릭하고 추가를 선택한 다음 새 프로젝트를 선택합니다.
2. 새 프로젝트 추가 대화 상자에서 Visual Basic 또는 **Visual C#**을 선택하고 콘솔 응용 프로그램 템플릿을 선택한 다음 이름을 Client로 지정합니다. 기본 위치를 사용합니다.
3. 확인을 클릭합니다.
다음과 같이 System.ServiceModel.dll에 대한 참조를 프로젝트에 추가합니다.
1. 솔루션 탐색기의 클라이언트 프로젝트 아래에서 참조 폴더를 마우스 오른쪽 단추로 클릭하고 참조 추가를 선택합니다.
2. 최근에 사용한 파일 탭을 선택하고 목록 상자에서 System.ServiceModel.dll을 선택한 다음 확인을 클릭합니다. 이 자습서의 첫 단계에서 이 어셈블리에 대한 참조를 이미 추가했으므로 최근 사용한 파일 탭에 이 어셈블리가 나열되어 있을 것입니다. 최근 사용한 파일 탭에서 보이지 않으면 찾아보기 탭을 클릭하고 C:\Windows\Microsoft.NET\Framework\v3.0\Windows Communication Foundation으로 이동하여 어셈블리를 선택합니다.
참고

Csc.exe 또는 Vbc.exe와 같은 명령줄 컴파일러를 사용하는 경우 어셈블리의 경로도 제공해야 합니다. 기본적으로 예를 들어 Windows Vista를 실행하는 컴퓨터에서 경로는 Windows\Microsoft.NET\Framework\v3.0\Windows Communication Foundation입니다.
생성된 Program.cs 또는 Program.vb 파일에 있는 System.ServiceModel 네임스페이스에 using 문(Visual Basic에서는 Imports)을 추가합니다.
```
Imports System.ServiceModel;
```
```
using System.ServiceModel;
```
이전 단계에서 만든 서비스를 시작합니다. 자세한 내용은 방법: 기본 Windows Communication Foundation 서비스 호스트 및 실행을 참조하십시오.
적절한 스위치로 Service Model Metadata Utility Tool (SvcUtil.exe)를 실행하고 다음 단계를 수행하여 클라이언트 코드 및 구성 파일을 만듭니다.
1. 시작 메뉴의 Microsoft Windows SDK 항목 아래에서 CMD 셸을 선택하여 Windows SDK 콘솔 세션을 시작합니다.
2. 클라이언트 노드를 배치할 디렉터리로 이동합니다. 기본값을 사용하여 클라이언트 프로젝트를 만든 경우 디렉터리는 C:\Users\<사용자 이름>\Documents\Visual Studio 2005\Projects\Service\Client입니다.
3. 적절한 스위치로 명령줄 도구 Service Model Metadata Utility Tool (SvcUtil.exe)를 사용하여 클라이언트 코드를 만듭니다. 다음 예제에서는 서비스에 대해 코드 파일 및 구성 파일을 생성합니다.
  [Visual Basic]
```
svcutil.exe /language:vb /out:generatedProxy.vb /config:app.config https://localhost:8000/ServiceModelSamples/service
```
  [C#]
```
svcutil.exe /language:cs /out:generatedProxy.cs /config:app.config https://localhost:8000/ServiceModelSamples/service
```
  기본적으로 클라이언트 프록시 코드 이름은 서비스 이름에 따라 지정됩니다. 예를 들어 이 경우에는 CalculatorService.cs 또는 CalculatorService.vb가 되며, 여기서 확장명은 프로그래밍 언어에 해당합니다( .vb는 Visual Basic, .cs는 C#). /out 스위치는 클라이언트 프록시 파일의 이름을 generatedProxy.cs로 변경하고 /config 스위치는 클라이언트 구성 파일의 이름을 기본 output.config에서 app.config로 변경합니다. 이 두 파일은 C:\Users\<사용자 이름>\Documents\Visual Studio 2005\Projects\Service\Client 디렉터리에 생성됩니다.
생성된 프록시를 Visual Studio의 클라이언트 프로젝트에 추가하려면 솔루션 탐색기에서 클라이언트 프로젝트를 마우스 오른쪽 단추로 클릭하고 추가를 선택한 다음 기존 항목을 선택합니다. 이전 단계에서 생성된 generatedProxy.cs 파일을 선택합니다.

예제

이 예제에서는 Service Model Metadata Utility Tool (Svcutil.exe)로 생성되는 클라이언트 코드를 보여 줍니다.

WCF(Windows Communication Foundation) 클라이언트를 만들었습니다. 클라이언트를 구성하는 절차인 방법: 기본 Windows Communication Foundation 클라이언트 구성을 진행합니다. 문제 해결 정보에 대한 자세한 내용은 초보자를 위한 자습서 문제 해결을 참조하십시오.

참고 항목

작업

방법: 구성 파일을 사용하여 서비스의 메타데이터 게시
방법: Svcutil.exe를 사용하여 메타데이터 문서 다운로드

기타 리소스

Service Model Metadata Utility Tool (Svcutil.exe)
Getting Started Sample
Self-Host

다음을 통해 공유

방법: Windows Communication Foundation 클라이언트 만들기

Windows Communication Foundation 클라이언트를 만들려면

예제

참고 항목

작업

기타 리소스

추가 리소스