.NET Framework 프로젝트의 경우 서비스 참조 를 사용하면 프로젝트가 하나 이상의 WCF Data Services에 액세스할 수 있습니다. 서비스 참조 추가 대화 상자를 사용하여 현재 솔루션, 로컬, 로컬 영역 네트워크 또는 인터넷에서 WCF Data Services를 검색합니다.
.NET Core 프로젝트의 경우 솔루션 탐색기의연결된 서비스 노드를 사용하여 WCF(Windows Communication Foundation) 데이터 서비스 참조를 관리할 수 있는 Microsoft WCF 웹 서비스 참조 공급자에 액세스할 수 있습니다.
비고
이 문서의 지침은 Visual Studio에서 사용할 수 있는 IDE(대화형 개발 환경)의 최신 버전을 보여 줍니다. 컴퓨터에 일부 사용자 인터페이스 요소에 대한 다른 이름 또는 위치가 표시될 수 있습니다. 다른 버전의 Visual Studio 또는 다른 환경 설정을 사용할 수 있습니다. 자세한 내용은 IDE 개인 설정참조하세요.
필수 조건
WCF 도구는 .NET 워크로드와 함께 설치되지 않습니다. Visual Studio 설치 관리자를 사용하여 설치를 수정합니다. 설치 관리자의 개별 구성 요소에서 Windows Communication Foundation 을 선택합니다. 을(를) 참조하여 Visual Studio을(를) 수정하세요.
WCF 서비스 참조 추가
외부 서비스에 대한 참조를 추가하려면(.NET Framework 프로젝트)
솔루션 탐색기에서 서비스를 추가할 프로젝트의 이름을 마우스 오른쪽 단추로 클릭한 다음 서비스 참조 추가를 선택합니다.
서비스 참조 추가 대화 상자가 나타납니다.
주소 상자에 서비스의 URL을 입력한 다음, [이동]을 선택하여 서비스를 검색합니다. 서비스에서 사용자 이름 및 암호 보안을 구현하는 경우 사용자 이름 및 암호를 묻는 메시지가 표시될 수 있습니다. 자체 솔루션에서 서비스를 선택할 수도 있습니다. 검색 단추를 선택한 다음 솔루션에서 서비스를 선택합니다.
비고
신뢰할 수 있는 원본의 서비스만 참조해야 합니다. 신뢰할 수 없는 원본에서 참조를 추가하면 보안이 손상될 수 있습니다.
유효한 서비스 메타데이터가 발견된 이전 15개의 URL을 저장하는 주소 목록에서 URL을 선택할 수도 있습니다.
검색을 수행할 때 진행률 표시줄이 표시됩니다. 언제든지 중지를 클릭하여 검색을 중지할 수 있습니다.
서비스 목록에서 사용하려는 서비스의 노드를 확장하고 엔터티 집합을 선택합니다.
네임스페이스 상자에 참조에 사용할 네임스페이스를 입력합니다.
확인을 클릭하여 프로젝트에 대한 참조를 추가합니다.
서비스 클라이언트(프록시)가 생성되고 서비스를 설명하는 메타데이터가 app.config 파일에 추가됩니다.
외부 서비스(.NET Core 프로젝트(.NET 5 이상 포함)에 대한 참조를 추가하려면
솔루션 탐색기에서 연결된 서비스 노드를 두 번 클릭하거나 탭합니다.
서비스 구성 탭이 열립니다.
Microsoft WCF 웹 서비스 참조 공급자를 선택합니다.
WCF 웹 서비스 참조 구성 대화 상자가 나타납니다.
URI 상자에 서비스의 URL을 입력한 다음, [이동]을 선택하여 서비스를 검색합니다. 서비스에서 사용자 이름 및 암호 보안을 구현하는 경우 사용자 이름 및 암호를 묻는 메시지가 표시될 수 있습니다.
비고
신뢰할 수 있는 원본의 서비스만 참조해야 합니다. 신뢰할 수 없는 원본에서 참조를 추가하면 보안이 손상될 수 있습니다.
유효한 서비스 메타데이터가 발견된 이전 15개의 URL을 저장하는 URI 목록에서 URL을 선택할 수도 있습니다.
검색을 수행할 때 진행률 표시줄이 표시됩니다. 언제든지 중지를 클릭하여 검색을 중지할 수 있습니다.
서비스 목록에서 사용하려는 서비스의 노드를 확장하고 엔터티 집합을 선택합니다.
네임스페이스 상자에 참조에 사용할 네임스페이스를 입력합니다.
마침을 클릭하여 프로젝트에 대한 참조를 추가합니다.
서비스 클라이언트(프록시)가 생성되고 서비스를 설명하는 메타데이터가 app.config 파일에 추가됩니다.
현재 솔루션의 서비스에 대한 참조를 추가하려면(.NET Framework 프로젝트)
솔루션 탐색기에서 서비스를 추가할 프로젝트의 이름을 마우스 오른쪽 단추로 클릭한 다음 서비스 참조 추가를 선택합니다.
서비스 참조 추가 대화 상자가 나타납니다.
검색을 클릭합니다.
현재 솔루션의 모든 서비스(WCF Data Services 및 WCF 서비스)가 서비스 목록에 추가됩니다.
서비스 목록에서 사용하려는 서비스의 노드를 확장하고 엔터티 집합을 선택합니다.
네임스페이스 상자에 참조에 사용할 네임스페이스를 입력합니다.
확인을 클릭하여 프로젝트에 대한 참조를 추가합니다.
서비스 클라이언트(프록시)가 생성되고 서비스를 설명하는 메타데이터가 app.config 파일에 추가됩니다.
현재 솔루션의 서비스에 대한 참조를 추가하려면(.NET Core 프로젝트)
솔루션 탐색기에서 연결된 서비스 노드를 두 번 클릭하거나 탭합니다.
서비스 구성 탭이 열립니다.
Microsoft WCF 웹 서비스 참조 공급자를 선택합니다.
WCF 웹 서비스 참조 구성 대화 상자가 나타납니다.
검색을 클릭합니다.
현재 솔루션의 모든 서비스(WCF Data Services 및 WCF 서비스)가 서비스 목록에 추가됩니다.
서비스 목록에서 사용하려는 서비스의 노드를 확장하고 엔터티 집합을 선택합니다.
네임스페이스 상자에 참조에 사용할 네임스페이스를 입력합니다.
마침을 클릭하여 프로젝트에 대한 참조를 추가합니다.
서비스 클라이언트(프록시)가 생성되고 서비스를 설명하는 메타데이터가 app.config 파일에 추가됩니다.
서비스 참조 업데이트
WCF Data Services에 대한 엔터티 데이터 모델은 때때로 변경됩니다. 이 경우 서비스 참조를 업데이트해야 합니다.
서비스 참조를 업데이트하려면
솔루션 탐색기에서 서비스 참조를 마우스 오른쪽 단추로 클릭한 다음 서비스 참조 업데이트를 선택합니다.
참조가 원래 위치에서 업데이트되고 메타데이터의 변경 내용을 반영하도록 서비스 클라이언트가 다시 생성되는 동안 진행률 대화 상자가 표시됩니다.
.NET Core 프로젝트에는 dotnet-svcutil 도구를 사용하십시오. 설치 및 지침은 dotnet-svcutil 을 참조하세요.
.NET Framework 프로젝트의 경우:
솔루션 탐색기에서 연결된 서비스 노드를 확장하고 서비스 참조를 마우스 오른쪽 단추로 클릭한 다음 서비스 참조 업데이트를 선택합니다.
참조가 원래 위치에서 업데이트되고 메타데이터의 변경 내용을 반영하도록 서비스 클라이언트가 다시 생성되는 동안 진행률 대화 상자가 표시됩니다.
서비스 참조 제거
서비스 참조가 더 이상 사용되지 않는 경우 솔루션에서 제거할 수 있습니다.
서비스 참조를 제거하려면
솔루션 탐색기에서 서비스 참조를 마우스 오른쪽 단추로 클릭한 다음 삭제를 선택합니다.
서비스 클라이언트가 솔루션에서 제거되고 서비스를 설명하는 메타데이터가 app.config 파일에서 제거됩니다.
비고
서비스 참조를 참조하는 모든 코드는 수동으로 제거해야 합니다.