Share via


웹 참조 추가 대화 상자

업데이트: 2007년 11월

웹 참조 추가 대화 상자에서는 웹 서비스를 찾아서 웹 사이트에 웹 참조를 추가할 수 있습니다. 웹 참조를 사용하면 웹 서비스에서 제공하는 개체와 메서드를 코드에 사용할 수 있습니다. 또한 회사의 LAN으로 구성된 서버 또는 로컬 컴퓨터에서 웹 서비스를 검색하거나 인터넷에서 상용 웹 서비스를 검색할 수 있습니다.

웹 참조 추가 대화 상자를 열려면

  • 솔루션 탐색기에서 웹 사이트의 이름을 마우스 오른쪽 단추로 클릭한 다음 웹 참조 추가를 클릭합니다.

    웹 참조 추가 대화 상자가 나타납니다.

현재 프로젝트에 웹 참조를 추가하면 해당 웹 서비스에서 제공하는 요소나 기능을 응용 프로그램에서 사용할 수 있습니다. 자세한 내용은 XML Web services 개요를 참조하십시오.

보안 정보:

편집을 위해 웹 참조가 포함된 프로젝트를 열면 신뢰된 사용자가 시작한 Devenv.exe 프로세스 인스턴스에서 웹 서비스의 로컬 프록시 파일이 실행됩니다. IDE(통합 개발 환경)에서 프로젝트나 구성 요소를 열면 로컬 컴퓨터에서 코드를 실행할 수 있습니다. 자세한 내용은 코드 액세스 보안을 참조하십시오.

UI 요소

  • 뒤로
    웹 참조 추가 뒤로 단추

    표시된 이전 페이지로 돌아갑니다.

  • 앞으로
    웹 참조 추가 전달 기호

    이전에 뒤로 단추를 클릭했을 때 표시된 페이지로 돌아갑니다.

  • 중지
    WebApplicationStopURLsymbol 스크린 샷

    웹 페이지 로드를 중지합니다.

  • 새로 고침
    AddWebReferenceRefreshButton 스크린 샷

    왼쪽 브라우저 창에 있는 활성 페이지의 내용을 새로 고칩니다.


  • 웹 리소스 추가 대화 상자 HomeSymbol

    왼쪽 브라우저 창에 웹 서비스 검색 시작 페이지를 표시합니다.

  • 이동
    웹 참조 추가 이동

    URL 필드에 입력한 주소에서 웹 서비스 검색을 활성화합니다.

  • URL
    응용 프로그램에서 사용할 웹 서비스의 URL을 표시합니다. 드롭다운 목록을 사용하여 이전에 사용한 서비스를 선택하거나 http:// 또는 ftp://로 시작하는 새 경로를 입력합니다. 전체 웹 참조 URL에는 도메인 이름, 웹 서비스 이름, .asmx, .wsdl, .disco 또는 .xsd 검색 파일 이름이 포함됩니다. 예를 들어, 다음을 입력할 수 있습니다.

    http://domainname/webservicename/discoveryfile.asmx

    웹 서비스 검색 시작 창에서는 이 경로에서 웹 서비스를 검색하고 검색한 서비스에 대한 설명을 표시합니다.

    참고:

    .NET Framework에서는 프록시 서버를 자동으로 검색하지 않습니다. 방화벽으로 보호된 컴퓨터에서 웹 응용 프로그램을 개발 중이고 해당 응용 프로그램이 방화벽 외부의 웹 서비스를 사용할 경우에는 네트워크 프록시 서버의 주소와 포트를 URL에 포함해야 합니다. 이 URL 경로 부분을 입력하려면 네트워크 관리자에게 문의하십시오. Machine.config 또는 Web.config 파일의 <defaultProxy> 요소(네트워크 설정) 요소를 설정할 수도 있습니다. 특정 값으로 설정된 Proxy 속성을 포함하지 않는 HttpWebRequest는 모두 기본 프록시를 사용합니다. 자세한 내용은 인터넷 응용 프로그램 구성을 참조하십시오.

  • 웹 서비스 검색 시작
    사용 가능한 웹 서비스 목록에 대한 링크를 제공합니다. 링크 중 하나를 클릭한 후 목록에 나열된 사용 가능한 웹 서비스 이름을 선택하여 해당 서비스의 WSDL(Web Services Description Language) 파일에서 지원되는 메서드에 대한 설명을 검색할 수 있습니다. 자세한 내용은 웹 서비스 찾기ASP.NET 웹 서비스에 대한 WSDL 파일 생성을 참조하십시오.

    이 창에 포함되어 있는 링크는 다음과 같습니다.

    • 이 솔루션의 웹 서비스   현재 솔루션에서 사용할 수 있는 웹 서비스를 보여 줍니다.

    • 로컬 컴퓨터의 웹 서비스   로컬 컴퓨터에서 사용 가능한 웹 서비스와 검색 문서 목록이 표시됩니다.

      이 링크에서 정보가 반환되게 하려면 로컬 컴퓨터에 IIS(인터넷 정보 서비스)와 같은 웹 서버가 실행되고 있어야 합니다. IIS에 대한 자세한 내용은 IIS Technical Library를 참조하십시오.

    • 로컬 네트워크의 UDDI 서버 검색   LAN에서 UDDI(Universal Description, Discovery, and Integration) 프로토콜을 사용하여 웹 서비스와 검색 문서를 제공하는 서버를 보여 줍니다.

      표준 UDDI 프로토콜을 사용하면 회사에서 사용 가능한 웹 서비스를 프로그래밍 방식으로 신속하게 검색할 수 있습니다. 자세한 내용은 Microsoft UDDI Web site를 참조하십시오.

  • 이 URL에서 찾은 웹 서비스
    지정한 URL에서 찾은 웹 서비스 이름을 나열합니다. 웹 참조를 만들면 웹 참조는 이 목록 전체를 참조합니다. 웹 서비스 하나를 격리시키려면 마우스 포인터로 이 목록에서 원하는 항목을 가리킵니다. 이렇게 하면 도구 설명에 원하는 서비스의 URL이 표시되므로 해당 서비스의 URL을 입력한 다음 이동을 누르면 목록에 원하는 웹 서비스만 표시됩니다. 그런 다음 이 서비스에 참조를 추가할 수 있습니다.

  • 웹 참조 이름
    선택한 웹 서비스에 프로그래밍 방식으로 액세스하기 위해 코드에 사용할 고유한 이름을 지정합니다. 입력한 이름이 기존 웹 서비스 이름과 일치하면 숫자를 추가하여 새 참조를 고유하게 만듭니다.

    기본적으로 웹 참조에는 서버 이름에 해당하는 네임스페이스가 할당됩니다. Visual Web Developer는 입력된 웹 참조 이름에 따라 App_WebReferences 폴더에 웹 참조를 만듭니다. App_WebReferences 폴더 내부에 웹 서비스를 참조하는 .wsdl 파일과 웹 서비스가 있는 위치 정보를 포함하는 검색 파일(.disco 및 .discomap)과 같은 지원 파일이 만들어집니다.

    웹 참조 이름에는 다음 규칙이 적용됩니다.

    • 이름에 / ? : \ * " < > 또는 | 문자를 포함할 수 없습니다.

    • 이름에 유니코드 제어 문자를 포함할 수 없습니다.

    • 이름이 "CON", "AUX", "PRN", "COM1" 및 "LPT2"와 같은 예약된 이름이 될 수 없습니다.

  • 참조 추가
    응용 프로그램에서 새 웹 참조를 만듭니다. URL 필드에 입력한 주소에서 사용할 수 있는 하나 이상의 웹 서비스가 이 URL에서 찾은 웹 서비스 필드에 표시되면 이 단추가 활성화됩니다. 웹 참조 이름 필드에 지정한 이름을 사용하는 새 웹 참조가 솔루션 탐색기에 현재 프로젝트의 Web References 노드 아래에 표시됩니다. 이 새 웹 참조를 사용하면 나열된 모든 웹 서비스를 응용 프로그램에서 사용할 수 있습니다.

    참고:

    .wsdl 설명 파일의 최신 복사본을 사용하여 웹 서비스의 프록시 클래스를 다시 생성하려면 솔루션 탐색기에서 웹 참조를 마우스 오른쪽 단추로 클릭한 다음 웹 참조 업데이트를 클릭합니다.

참고 항목

작업

방법: 웹 참조 추가 및 제거

개념

IIS의 원격 개체 호스팅

원격 서비스 예제: IIS에서 호스팅

인터넷 응용 프로그램 구성

참조

이 컴퓨터의 프록시 설정이 웹 검색에 적합하게 구성되지 않았습니다.

기타 리소스

관리 코드의 웹 서비스 액세스

프로젝트, 사용자 인터페이스 요소

Internet Information Services SDK

Internet Information Services 5.0 Documentation

World Wide Web Consortium

WSDL Specification

UDDI.org

Microsoft UDDI 웹 사이트