.NET Core용 WCF dotnet-svcutil 도구

아티클
01/10/2024

WCF(Windows Communication Foundation) dotnet-svcutil 도구는 네트워크 위치의 웹 서비스 또는 WSDL 파일에서 메타데이터를 검색하고, 해당 웹 서비스 작업에 액세스하는 클라이언트 프록시 메서드가 포함된 WCF 클래스를 생성하는 .NET 도구입니다.

.NET Framework 프로젝트용 서비스 모델 메타데이터 - svcutil 도구와 비슷하게, dotnet-svcutil은 .NET Core 및 .NET Standard 프로젝트와 호환되는 웹 서비스 참조를 생성하기 위한 명령줄 도구입니다.

dotnet-svcutil 도구는 Visual Studio 2017 버전 15.5에서 처음 제공된 WCF Web Service Reference Provider 도구 사용 Visual Studio 연결된 서비스 공급자의 대체 옵션입니다. .NET 도구인 dotnet-svcutil 도구는 Linux, macOS, Windows와 같은 여러 플랫폼에서 사용할 수 있습니다.

Important

신뢰할 수 있는 원본의 서비스만 참조해야 합니다. 신뢰할 수 없는 원본에서 참조를 추가하면 보안이 손상될 수 있습니다.

.NET Core 2.1 SDK 이상 버전
선호하는 코드 편집기

시작하기

다음 예제에서는 .NET Core 웹 프로젝트에 웹 서비스 참조를 추가하고 서비스를 호출하는 데 필요한 단계를 안내합니다. HelloSvcutil이라는 .NET Core 웹 애플리케이션을 만들고 다음 계약을 구현하는 웹 서비스에 대한 참조를 추가합니다.

[ServiceContract]
public interface ISayHello
{
    [OperationContract]
    string Hello(string name);
}

이 예제에서는 웹 서비스가 http://contoso.com/SayHello.svc 주소에서 호스트되는 것으로 가정합니다.

Windows, macOS 또는 Linux 명령 창에서 다음 단계를 수행합니다.

프로젝트에 대해 HelloSvcutil 디렉터리를 만들고 다음 예제와 같이 현재 디렉터리로 설정합니다.
```
mkdir HelloSvcutil
cd HelloSvcutil
```
다음과 같이 dotnet new 명령을 사용하여 이 디렉터리에서 새 C# 웹 프로젝트를 만듭니다.
```
dotnet new web
```
dotnet-svcutil NuGet 패키지를 CLI 도구로 설치합니다.
- dotnet-svcutil 2.x
- dotnet-svcutil 1.x
```
dotnet tool install --global dotnet-svcutil
```
편집기에서 HelloSvcutil.csproj 프로젝트 파일을 열고, Project 요소를 편집하고, 다음 코드를 사용하여 dotnet-svcutil NuGet 패키지를 CLI 도구 참조로 추가합니다.
```
<ItemGroup>
  <DotNetCliToolReference Include="dotnet-svcutil" Version="1.0.*" />
</ItemGroup>
```
그리고 다음과 같이 dotnet restore 명령을 사용하여 dotnet-svcutil 패키지를 복원합니다.
```
dotnet restore
```
다음과 같이 dotnet-svcutil 명령을 실행하여 웹 서비스 참조 파일을 생성합니다.
- dotnet-svcutil 2.x
- dotnet-svcutil 1.x
```
dotnet-svcutil http://contoso.com/SayHello.svc
```
```
dotnet svcutil http://contoso.com/SayHello.svc
```

생성된 파일은 HelloSvcutil/ServiceReference/Reference.cs로 저장됩니다. 또한 dotnet-svcutil 도구는 프록시 코드에 필요한 적절한 WCF 패키지를 프로젝트에 패키지 참조로 추가합니다.

서비스 참조 사용

다음과 같이 dotnet restore 명령을 사용하여 WCF 패키지를 복원합니다.
```
dotnet restore
```
사용하려는 클라이언트 클래스 및 작업의 이름을 찾습니다. Reference.cs는 System.ServiceModel.ClientBase에서 상속되는 클래스와 서비스에서 작업을 호출하는 데 사용할 수 있는 메서드를 포함합니다. 이 예제에서는 SayHello 서비스의 Hello 작업을 호출합니다. ServiceReference.SayHelloClient는 클라이언트 클래스의 이름이고, 작업을 호출하는 데 사용할 수 있는 HelloAsync라는 메서드를 갖습니다.
편집기에서 Startup.cs 파일을 열고 상단에 서비스 참조 네임스페이스를 위한 using 지시문을 추가합니다.
```
using ServiceReference;
```

Configure 메서드가 웹 서비스를 호출하도록 편집합니다. 이렇게 하려면 ClientBase에서 상속되는 클래스의 인스턴스를 만들고 클라이언트 개체에서 메서드를 호출합니다.

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }

    app.Run(async (context) =>
    {
        var client = new SayHelloClient();
        var response = await client.HelloAsync();
        await context.Response.WriteAsync(response);
    });
}

다음과 같이 dotnet run 명령을 사용하여 애플리케이션을 실행합니다.
```
dotnet run
```
웹 브라우저에서, 콘솔에 나열된 URL(예: http://localhost:5000)로 이동합니다.

“Hello dotnet-svcutil!” 출력이 표시됩니다.

dotnet-svcutil 도구 매개 변수에 대한 자세한 설명을 보려면 다음과 같이 help 매개 변수를 전달하는 도구를 호출합니다.

dotnet-svcutil 2.x
dotnet-svcutil 1.x

dotnet-svcutil --help

dotnet svcutil --help

사용자 의견 및 질문

질문이나 의견이 있는 경우 GitHub에서 문제를 엽니다. 또한 GitHub의 WCF 리포지토리에서 기존 질문이나 문제를 검토할 수 있습니다.

릴리스 정보

알려진 문제를 비롯한 업데이트된 릴리스 정보는 릴리스 정보를 참조하세요.

정보

dotnet-svcutil NuGet 패키지