방법: Visual Studio에서 참조 추가 또는 제거

응용 프로그램에서 구성 요소를 사용하려면 먼저 해당 구성 요소에 대한 참조를 추가해야 합니다. Visual Studio의 참조 추가 대화 상자에는 다섯 가지 옵션이 있습니다.

  • .NET - 참조에 사용할 수 있는 .NET Framework 구성 요소를 모두 나열합니다.

  • COM - 참조에 사용할 수 있는 COM 구성 요소를 모두 나열합니다.

  • 프로젝트 - 로컬 프로젝트에서 만든 재사용 가능한 구성 요소를 모두 나열합니다.

  • 찾아보기 - 파일 시스템의 구성 요소를 찾아볼 수 있습니다.

  • 최근에 사용한 파일 - 최근에 컴퓨터의 프로젝트에 추가한 구성 요소 목록이 있습니다.

참조 추가 대화 상자의 위쪽에 있는 탭의 개수는 열린 프로젝트의 형식과 사용 중인 리소스에 따라 달라집니다. C++ 네이티브 프로젝트에는 프로젝트 탭만 포함됩니다.

프로젝트의 .NET Framework 버전에 따라 목록의 일부 구성 요소는 표시되지 않을 수 있습니다. 이 비동기화는 다음과 같은 경우에 발생할 수 있습니다.

  • 최신 버전의 .NET Framework를 사용하는 구성 요소는 이전 버전의 .NET Framework를 대상으로 하는 프로젝트와 호환되지 않습니다.

    프로젝트의 대상 .NET Framework 버전을 변경하는 방법에 대한 자세한 내용은 방법: 특정 .NET Framework 버전 또는 프로필을 대상으로 지정을 참조하십시오.

  • .NET Framework 4를 사용하는 구성 요소는 .NET Framework 4 Client Profile을 대상으로 하는 프로젝트와 호환되지 않습니다.

    새 응용 프로그램을 만들면 기본적으로 일부 프로젝트가 .NET Framework 4 Client Profile을 대상으로 합니다. 자세한 내용은 .NET Framework Client Profile을 참조하십시오.

전역 어셈블리 캐시는 완전히 런타임 환경의 일부이므로 전역 어셈블리 캐시에서 참조를 추가할 수 없습니다.

전역 어셈블리 캐시에 등록되어 있는 사용자 지정 구성 요소에 대한 참조가 포함된 응용 프로그램을 배포하거나 복사하는 경우 구성 요소는 Copy Local 설정과 관계없이 응용 프로그램과 함께 배포 또는 복사되지 않습니다. 자세한 내용은 프로젝트 참조를 참조하십시오.

다른 .NET Framework 버전을 대상으로 하는 프로젝트나 어셈블리를 참조하는 응용 프로그램을 만들 수 있습니다. 예를 들어, .NET Framework 버전 2.0을 대상으로 하는 어셈블리를 참조하는 .NET Framework 4 Client Profile을 대상으로 하는 응용 프로그램을 만들 수도 있습니다. 이전 버전의 .NET Framework를 대상으로 하는 프로젝트를 만드는 경우 해당 프로젝트에서 .NET Framework 4 Client Profile 또는 .NET Framework 버전 4를 대상으로 하는 프로젝트나 어셈블리에 대한 참조를 설정할 수 없습니다. 자세한 내용은 특정 .NET Framework 버전 또는 프로필을 대상으로 지정을 참조하십시오.

동일한 솔루션에 있는 다른 프로젝트의 출력에 대한 파일 참조를 추가하면 컴파일 오류가 발생할 수 있으므로 이 방법은 사용하지 않는 것이 좋습니다. 대신 참조 추가 대화 상자의 프로젝트 탭을 사용하여 프로젝트 간 참조를 만듭니다. 이렇게 하면 프로젝트에서 만드는 클래스 라이브러리를 보다 효율적으로 관리할 수 있으므로 개발 팀이 작업하기가 간편해집니다. 자세한 내용은 끊어진 참조 문제 해결을 참조하십시오.

참고

Visual Studio 2010에서는 한 프로젝트의 대상 .NET Framework 버전이 버전 4이고 다른 프로젝트의 대상 버전이 버전 2, 3 또는 3.5인 경우 프로젝트 참조 대신 파일 참조가 만들어집니다.

내부 매니페스트가 포함된 등록 COM DLL에 참조를 추가하려는 경우 해당 DLL의 등록을 먼저 해제해야 합니다. 이렇게 하지 않으면 네이티브 DLL 대신 ActiveX 구성 요소 같은 어셈블리 참조가 추가됩니다.

웹 참조 추가 대화 상자를 사용하여 웹 참조를 추가할 수도 있습니다. 자세한 내용은 방법: 웹 참조 추가 및 제거를 참조하십시오.

EnvDTE 네임스페이스(EnvDTE, EnvDTE80, EnvDTE90, EnvDTE90a 또는 EnvDTE100)에 대한 참조를 수동으로 추가할 때는 속성 창에서 참조의 Interop 형식 포함 속성을 False로 설정합니다. 이 속성을 True로 설정하면 포함할 수 없는 특정 EnvDTE 속성으로 인해 빌드 문제가 발생할 수 있습니다.

참고

모든 프로젝트에는 mscorlib에 대한 암시적 참조가 포함되어 있습니다. Visual Basic 프로젝트에는 Microsoft.VisualBasic에 대한 암시적 참조가 포함되어 있습니다.

Visual Studio 2010에서는 System.Core가 참조 목록에서 제거된 경우에도 모든 프로젝트에 System.Core에 대한 암시적 참조가 포함되어 있습니다.

참조 추가 대화 상자에서 어셈블리를 표시하려면

  • 다음 위치 중 하나로 어셈블리를 이동하거나 복사합니다.

    • 현재 프로젝트 디렉터리. 이 어셈블리는 찾아보기 탭을 통해 찾을 수 있습니다.

    • 같은 솔루션에 있는 다른 프로젝트 디렉터리. 이 어셈블리는 프로젝트 탭을 통해 찾을 수 있습니다.

    -또는-

  • 표시할 어셈블리의 위치를 지정하는 레지스트리 키를 설정합니다.

    32비트 운영 체제의 경우 다음 레지스트리 키 중 하나를 추가합니다.

    • [HKEY_CURRENT_USER\SOFTWARE\Microsoft\.NETFramework\VersionMinimum\AssemblyFoldersEx\MyAssemblies]@="AssemblyLocation"

    • [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\VersionMinimum\AssemblyFoldersEx\MyAssemblies]@="AssemblyLocation"

    64비트 운영 체제의 경우에는 32비트 레지스트리 하이브에 포함된 다음 레지스트리 키 중 하나를 추가합니다.

    • [HKEY_CURRENT_USER\SOFTWARE\Wow6432Node\Microsoft\.NETFramework\VersionMinimum\AssemblyFoldersEx\MyAssemblies]@="AssemblyLocation"

    • [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\.NETFramework\VersionMinimum\AssemblyFoldersEx\MyAssemblies]@="AssemblyLocation"

    VersionMinimum은 적용되는 최하위 .NET Framework 버전입니다. VersionMinimum이 v3.0인 경우 AssemblyFoldersEx에 지정된 폴더는 .NET Framework 3.0 이상을 대상으로 하는 프로젝트에 적용됩니다.

    AssemblyLocation은 참조 추가 대화 상자에 표시하려는 어셈블리의 디렉터리(예: C:\MyAssemblies\)입니다.

    HKEY_LOCAL_MACHINE 노드 아래에 레지스트리 키를 만들면 모든 사용자가 참조 추가 대화 상자에서 지정된 위치의 어셈블리를 볼 수 있습니다. HKEY_CURRENT_USER 노드 아래에 레지스트리 키를 만들면 현재 사용자에 대한 설정에만 영향을 줍니다.

    참조 추가 대화 상자를 다시 엽니다. 어셈블리가 .NET 탭에 나타나야 합니다. 어셈블리가 나타나지 않으면 지정된 AssemblyLocation 디렉터리에 어셈블리가 있는지 확인하고 Visual Studio를 다시 시작한 후 다시 시도합니다.

Visual Basic에서 참조를 추가하려면

  1. 솔루션 탐색기에서 프로젝트의 My Project 노드를 두 번 클릭합니다.

  2. 프로젝트 디자이너에서 참조 탭을 클릭합니다.

  3. 추가 단추를 클릭하여 참조 추가 대화 상자를 엽니다.

  4. 참조 추가 대화 상자에서 참조할 구성 요소의 종류를 나타내는 탭을 선택합니다.

  5. 참조할 구성 요소를 선택한 다음 확인을 클릭합니다.

    구성 요소가 모두 같은 탭에 있으면 Ctrl 키를 누른 채 여러 구성 요소를 선택할 수 있습니다.

Visual C#에서 참조를 추가하려면

  1. 솔루션 탐색기에서 프로젝트 노드를 마우스 오른쪽 단추로 클릭하고 참조 추가를 클릭합니다.

  2. 참조 추가 대화 상자에서 참조할 구성 요소의 종류를 나타내는 탭을 선택합니다.

  3. 참조할 구성 요소를 선택한 다음 확인을 클릭합니다.

    구성 요소가 모두 같은 탭에 있으면 Ctrl 키를 누른 채 여러 구성 요소를 선택할 수 있습니다.

Visual Basic에서 참조를 제거하려면

  1. 솔루션 탐색기에서 프로젝트의 My Project 노드를 두 번 클릭합니다.

  2. 프로젝트 디자이너에서 참조 탭을 클릭합니다.

  3. 참조 목록에서 제거할 참조를 선택합니다.

  4. 제거 단추를 클릭합니다.

    프로젝트에 사용되지 않는 참조가 있는지 검사하여 한꺼번에 제거할 수도 있습니다. 자세한 내용은 방법: 사용하지 않는 참조 제거(Visual Basic)를 참조하십시오.

Visual C#에서 참조를 제거하려면

  1. 솔루션 탐색기에서 프로젝트 노드 아래의 참조 노드를 엽니다.

  2. 참조를 마우스 오른쪽 단추로 클릭하고 제거를 클릭합니다.

참고 항목

작업

끊어진 참조 문제 해결

방법: 가져온 네임스페이스 추가 또는 제거(Visual Basic)

방법: 사용하지 않는 참조 제거(Visual Basic)

방법: 참조의 로컬 복사 속성 설정

방법: 새 프로젝트 항목 추가

방법: 웹 참조 추가 및 제거

방법: 참조 경로 설정(C#)

참조

프로젝트 디자이너, 응용 프로그램 페이지(C#)

고급 컴파일러 설정 대화 상자(Visual Basic)

개념

프로젝트 참조

Visual Studio의 웹 참조

Visual Studio 다중 대상 지정 개요

.NET Framework 대상 지정 오류 문제 해결

기타 리소스

참조 관리

네임스페이스 및 구성 요소 참조

특정 .NET Framework 버전 또는 프로필을 대상으로 지정