다음을 통해 공유


.NET Core용 WCF dotnet-svcutil 도구

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

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

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

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

  1. 프로젝트에 대해 HelloSvcutil 디렉터리를 만들고 다음 예제와 같이 현재 디렉터리로 설정합니다.

    mkdir HelloSvcutil
    cd HelloSvcutil
    
  2. 다음과 같이 dotnet new 명령을 사용하여 이 디렉터리에서 새 C# 웹 프로젝트를 만듭니다.

    dotnet new web
    
  3. dotnet-svcutil NuGet 패키지를 CLI 도구로 설치합니다.

    dotnet tool install --global dotnet-svcutil
    
  4. 다음과 같이 dotnet-svcutil 명령을 실행하여 웹 서비스 참조 파일을 생성합니다.

    dotnet-svcutil http://contoso.com/SayHello.svc
    

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

서비스 참조 사용

  1. 다음과 같이 dotnet restore 명령을 사용하여 WCF 패키지를 복원합니다.

    dotnet restore
    
  2. 사용하려는 클라이언트 클래스 및 작업의 이름을 찾습니다. Reference.csSystem.ServiceModel.ClientBase에서 상속되는 클래스와 서비스에서 작업을 호출하는 데 사용할 수 있는 메서드를 포함합니다. 이 예제에서는 SayHello 서비스의 Hello 작업을 호출합니다. ServiceReference.SayHelloClient는 클라이언트 클래스의 이름이고, 작업을 호출하는 데 사용할 수 있는 HelloAsync라는 메서드를 갖습니다.

  3. 편집기에서 Startup.cs 파일을 열고 상단에 서비스 참조 네임스페이스를 위한 using 지시문을 추가합니다.

    using ServiceReference;
    
  4. 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);
        });
    }
    
    
  5. 다음과 같이 dotnet run 명령을 사용하여 애플리케이션을 실행합니다.

    dotnet run
    
  6. 웹 브라우저에서, 콘솔에 나열된 URL(예: http://localhost:5000)로 이동합니다.

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

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

dotnet-svcutil --help

사용자 의견 및 질문

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

릴리스 정보

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

정보