WCF Web Service Reference Provider 도구 사용

아티클
02/27/2024

지난 몇 년 동안, 많은 Visual Studio 개발자가 .NET Framework 프로젝트에서 웹 서비스에 액세스해야 할 때 제공된 서비스 참조 추가 도구를 통해 생산성을 향상시킬 수 있었습니다.

WCF Web Service Reference 도구는 .NET 5+, .NET Core 또는 ASP.NET Core 프로젝트를 웹 서비스에 연결할 수 있는 Visual Studio 연결된 서비스 확장입니다. .NET Framework 프로젝트에만 해당되는 서비스 참조 추가 기능과 유사한 환경을 제공합니다. WCF Web Service Reference 도구는 현재 솔루션의 웹 서비스, 네트워크 위치 또는 WSDL 파일에서 메타데이터를 검색하고 .NET 앱이 웹 서비스에 액세스하는 데 사용할 수 있는 WCF(Windows Communication Foundation) 클라이언트 프록시 코드가 포함된 원본 파일을 생성합니다.

Important

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

필수 조건

Visual Studio 2017 버전 15.5 이상 버전

이 문서의 스크린샷은 Visual Studio 2022의 스크린샷입니다.

확장을 사용하는 방법

참고 항목

WCF Web Service Reference 도구는 ASP.NET Core 웹앱을 포함하여 C# .NET Core 및 .NET Standard 프로젝트에만 적용됩니다.

이 문서에서는 ASP.NET Core 웹 애플리케이션 프로젝트 템플릿을 예로 사용하여 프로젝트에 WCF 서비스 참조를 추가하는 방법을 안내합니다.

솔루션 탐색기에서 프로젝트의 연결된 서비스 노드를 두 번 클릭합니다. (.NET Core 또는 .NET Standard 프로젝트의 경우 프로젝트를 마우스 오른쪽 단추로 클릭하고 추가>연결된 서비스를 선택합니다.)

다음 이미지와 같이 연결된 서비스 페이지가 표시됩니다.
연결된 서비스 페이지에서 서비스 참조 추가를 선택합니다.

서비스 참조 추가 페이지가 열립니다.
WCF 웹 서비스를 선택한 다음 다음을 선택합니다.

그러면 새 WCF 웹 서비스 서비스 참조 마법사가 표시됩니다.
서비스를 선택합니다.

a. 다음과 같은 여러 서비스 검색 옵션을 사용할 수 있습니다.
- 현재 솔루션에 정의된 서비스를 검색하려면 검색 단추를 클릭합니다.
- 지정된 주소에서 호스트되는 서비스를 검색하려면 주소 상자에 서비스 URL을 입력하고 이동 단추를 클릭합니다.
- 웹 서비스 메타데이터 정보를 포함하는 WSDL 파일을 선택하려 찾아보기 단추를 클릭합니다.
b. 서비스 상자의 검색 결과 목록에서 서비스를 선택합니다. 필요한 경우 해당 네임스페이스 입력란에 생성된 코드에 대한 네임스페이스를 입력합니다.

c. 다음 단추를 클릭하여 데이터 형식 옵션 또는 클라이언트 옵션을 지정합니다. 또는 마침 단추를 클릭하고 기본 옵션을 사용합니다.
데이터 형식 옵션 페이지에서 생성된 서비스 참조 구성 설정을 구체화할 수 있습니다.

참고 항목

참조된 어셈블리의 형식 재사용 확인란 옵션은 서비스 참조 코드 생성에 필요한 데이터 형식이 프로젝트의 참조 어셈블리 중 하나에 정의될 때 유용합니다. 컴파일 시간 형식 충돌 또는 런타임 문제를 피하기 위해 기존 데이터 형식을 다시 사용하는 것이 중요합니다.

프로젝트 종속성 및 기타 시스템 성능 요소의 수에 따라 형식 정보가 로드되는 동안 지연이 있을 수 있습니다. 참조된 어셈블리의 형식 재사용 확인란을 선택 하면 로드 중에 마침 단추가 비활성화됩니다.
완료했으면 마침을 클릭합니다.