WCF 데이터 서비스 참조 추가, 업데이트 또는 제거

.NET Framework 프로젝트의 경우 서비스 참조를 사용하면 프로젝트에서 하나 이상의 WCF Data Services에 액세스할 수 있습니다. 서비스 참조 추가 대화 상자를 사용하여 로컬로, 로컬 영역 네트워크에서 또는 인터넷에서 현재 솔루션의 WCF Data Services를 검색합니다.

.NET Core 프로젝트의 경우 솔루션 탐색기의 연결된 서비스 노드를 사용하여 Microsoft WCF Web Service Reference 공급자에 액세스할 수 있으며, 이를 통해 WCF(Windows Communication Foundation) 데이터 서비스 참조를 관리할 수 있습니다.

참고 항목

이 문서의 일부 Visual Studio 사용자 인터페이스 요소에 대한 다른 이름 또는 위치가 컴퓨터에 표시될 수 있습니다. 다른 버전의 Visual Studio 또는 다른 환경 설정을 사용 중일 수 있습니다. 자세한 내용은 IDE 개인 설정을 참조하세요.

필수 조건

WCF 도구는 .NET 워크로드와 함께 설치되지 않습니다. Visual Studio 설치 관리자를 사용하여 설치를 수정합니다. 설치 관리자에서 개별 구성 요소에서 Windows Communication Foundation을 선택합니다. Visual Studio 수정을 참조하세요.

WCF 서비스 참조 추가

외부 서비스에 대한 참조를 추가하려면(.NET Framework 프로젝트)

1. 솔루션 탐색기에서 서비스를 추가하려는 프로젝트의 이름을 마우스 오른쪽 단추로 클릭한 다음, 서비스 참조 추가를 클릭합니다.

   서비스 참조 추가 대화 상자가 나타납니다.

2. 주소 상자에 서비스의 URL을 입력한 다음, 이동을 클릭하여 서비스를 검색합니다. 서비스가 사용자 이름 및 암호 보안을 구현하는 경우 사용자 이름과 암호를 입력하라는 메시지가 표시될 수 있습니다. 자체 솔루션에서 서비스를 선택할 수도 있습니다. 검색 단추를 선택한 다음, 솔루션에서 서비스를 선택합니다.

   참고 항목

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

   유효한 서비스 메타데이터가 있었던 이전 15개 URL을 저장하는 주소 목록에서 URL을 선택할 수도 있습니다.

   검색을 수행하는 동안 진행률 표시줄이 표시됩니다. 중지를 클릭하여 언제든지 검색을 중지할 수 있습니다.

3. 서비스 목록에서 사용하려는 서비스의 노드를 확장하고 엔터티 집합을 선택합니다.

4. 네임스페이스 상자에 참조에 사용할 네임스페이스를 입력합니다.

5. 확인을 클릭하여 참조를 프로젝트에 추가합니다.

   서비스 클라이언트(프록시)가 생성되며 서비스를 설명하는 메타데이터가 app.config 파일에 추가됩니다.

외부 서비스에 대한 참조를 추가하려면(.NET 5 이상을 비롯한 .NET Core 프로젝트)

1. 솔루션 탐색기에서 연결된 서비스 노드를 두 번 클릭하거나 탭합니다.

   서비스 구성 탭이 열립니다.

2. Microsoft WCF Web Service Reference 공급자를 선택합니다.

   WCF Web Service Reference 구성 대화 상자가 표시됩니다.

   

3. URI 상자에 서비스의 URL을 입력한 다음, 이동을 클릭하여 서비스를 검색합니다. 서비스가 사용자 이름 및 암호 보안을 구현하는 경우 사용자 이름과 암호를 입력하라는 메시지가 표시될 수 있습니다.

   참고 항목

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

   유효한 서비스 메타데이터가 있었던 이전 15개 URL을 저장하는 URI 목록에서 URL을 선택할 수도 있습니다.

   검색을 수행하는 동안 진행률 표시줄이 표시됩니다. 중지를 클릭하여 언제든지 검색을 중지할 수 있습니다.

4. 서비스 목록에서 사용하려는 서비스의 노드를 확장하고 엔터티 집합을 선택합니다.

5. 네임스페이스 상자에 참조에 사용할 네임스페이스를 입력합니다.

6. 마침을 클릭하여 프로젝트에 대한 참조를 추가합니다.

   서비스 클라이언트(프록시)가 생성되며 서비스를 설명하는 메타데이터가 app.config 파일에 추가됩니다.

현재 솔루션의 서비스에 대한 참조를 추가하려면(.NET Framework 프로젝트)

1. 솔루션 탐색기에서 서비스를 추가하려는 프로젝트의 이름을 마우스 오른쪽 단추로 클릭한 다음, 서비스 참조 추가를 클릭합니다.

   서비스 참조 추가 대화 상자가 나타납니다.

2. 검색을 클릭합니다.

   현재 솔루션의 모든 서비스(WCF Data Services 및 WCF 서비스 모두)가 서비스 목록에 추가됩니다.

3. 서비스 목록에서 사용하려는 서비스의 노드를 확장하고 엔터티 집합을 선택합니다.

4. 네임스페이스 상자에 참조에 사용할 네임스페이스를 입력합니다.

5. 확인을 클릭하여 참조를 프로젝트에 추가합니다.

   서비스 클라이언트(프록시)가 생성되며 서비스를 설명하는 메타데이터가 app.config 파일에 추가됩니다.

현재 솔루션의 서비스에 대한 참조를 추가하려면(.NET Core 프로젝트)

1. 솔루션 탐색기에서 연결된 서비스 노드를 두 번 클릭하거나 탭합니다.

   서비스 구성 탭이 열립니다.

2. Microsoft WCF Web Service Reference 공급자를 선택합니다.

   WCF Web Service Reference 구성 대화 상자가 표시됩니다.

3. 검색을 클릭합니다.

   현재 솔루션의 모든 서비스(WCF Data Services 및 WCF 서비스 모두)가 서비스 목록에 추가됩니다.

4. 서비스 목록에서 사용하려는 서비스의 노드를 확장하고 엔터티 집합을 선택합니다.

5. 네임스페이스 상자에 참조에 사용할 네임스페이스를 입력합니다.

6. 마침을 클릭하여 프로젝트에 대한 참조를 추가합니다.

   서비스 클라이언트(프록시)가 생성되며 서비스를 설명하는 메타데이터가 app.config 파일에 추가됩니다.

서비스 참조 업데이트

WCF Data Services에 대한 엔터티 데이터 모델은 경우에 따라 변경됩니다. 이 경우 서비스 참조를 업데이트해야 합니다.

서비스 참조를 업데이트하려면

.NET Core 프로젝트의 경우 dotnet-svcutil 도구를 사용합니다. 설치 지침은 dotnet-svcutil를 참조하세요.

.NET Framework 프로젝트의 경우:

• 솔루션 탐색기에서 연결된 서비스 노드를 확장하고 서비스 참조를 마우스 오른쪽 단추로 클릭한 다음, 서비스 참조 업데이트를 클릭합니다.

  원래 위치에서 참조가 업데이트되는 동안 진행률 대화 상자가 표시되고 메타데이터의 변경 내용을 반영하도록 서비스 클라이언트가 다시 생성됩니다.

서비스 참조 제거

서비스 참조가 더 이상 사용되지 않는 경우 솔루션에서 제거할 수 있습니다.

서비스 참조를 제거하려면

• 솔루션 탐색기에서 서비스 참조를 마우스 오른쪽 단추로 클릭한 다음, 삭제를 클릭합니다.

  서비스 클라이언트가 솔루션에서 제거되고 서비스를 설명하는 메타데이터가 app.config 파일에서 제거됩니다.

  참고 항목

  서비스 참조를 참조하는 모든 코드는 수동으로 제거해야 합니다.

관련 콘텐츠

• Windows Communication Foundation 서비스 및 Visual Studio의 WCF 데이터 서비스