다음을 통해 공유


Imports 문(.NET 네임스페이스 및 형식)

업데이트: 2007년 11월

현재 프로젝트 또는 참조된 프로젝트 및 어셈블리에 정의된 네임스페이스 또는 프로그래밍 요소를 가져옵니다.

Imports [ aliasname = ] namespace
-or-
Imports [ aliasname = ] namespace.element

구성 요소

  • aliasname
    선택적 요소이며 코드에서 전체 한정 문자열 대신 namespace를 참조할 수 있는 이름 또는 가져오기 별칭입니다. 선언 요소 이름을 참조하십시오.

  • namespace
    필수적 요소이며 가져올 네임스페이스의 정규화된 이름입니다. 모든 수준에 중첩된 네임스페이스의 문자열일 수 있습니다.

  • element
    선택적 요소이며 네임스페이스에 선언된 프로그래밍 요소의 이름입니다. 임의의 컨테이너 요소일 수 있습니다.

설명

각 소스 파일에 여러 개의 Imports 문을 포함할 수 있습니다. 이 문을 사용하려면 Option Strict 문과 같은 옵션 선언 규칙을 따라야 하며 Module 또는 Class 문과 같은 프로그래밍 요소 선언 앞에 와야 합니다.

Imports는 파일 수준에서만 사용할 수 있습니다. 즉, 가져오기에 대한 선언 컨텍스트는 소스 파일이어야 하며 네임스페이스, 클래스, 구조체, 모듈, 인터페이스, 프로시저 또는 블록이 될 수 없습니다.

가져오기 별칭은 하나 이상의 네임스페이스에서 선언된 같은 이름의 항목을 사용해야 하는 경우에 유용합니다. 자세한 내용 및 예제는 여러 변수의 이름이 같은 경우의 참조 확인에서 "이름이 같은 클래스" 항목을 참조하십시오.

Imports 문을 사용하여 사용자의 프로젝트에서 다른 프로젝트 및 어셈블리의 요소를 사용 가능하게 만들 수 없습니다. 이 문으로 참조 설정을 대신할 수는 없습니다. 프로젝트에 이미 사용 가능한 이름을 한정할 때만 제거됩니다. 자세한 내용은 여러 변수의 이름이 같은 경우의 참조 확인에서 "포함하는 요소 가져오기" 항목을 참조하십시오.

참고:

가져오기 별칭의 선언에 사용되는 구문은 XML 네임스페이스 접두사 가져오기에 사용되는 구문과 비슷하지만 결과는 서로 다릅니다. 가져오기 별칭은 코드에서 식으로 사용할 수 있는 반면, XML 네임스페이스 접두사는 XML 리터럴 또는 XML 축 속성에서 정규화된 요소 또는 특성 이름의 접두사로만 사용할 수 있습니다.

규칙

  • **별칭 이름.**aliasname과 같은 이름으로 멤버를 모듈 수준에서 선언하면 안 됩니다. 이렇게 하면 Visual Basic 컴파일러는 선언된 멤버에 대해서만 aliasname을 사용하며 이 멤버를 더 이상 가져오기 별칭으로 인식하지 않습니다.

  • 네임스페이스 이름. 단일 네임스페이스 이름 또는 중첩된 네임스페이스의 문자열을 제공할 수 있습니다. 중첩된 각 네임스페이스는 다음 예제와 같이 다음 수준의 네임스페이스에서 마침표(.)를 사용하여 구분됩니다.

    Imports System.Collections.Generic

  • **요소 형식.**element를 제공하는 경우 다른 요소를 포함할 수 있는 프로그래밍 요소인 컨테이터 요소를 나타내야 합니다. 컨테이너 요소에는 클래스, 구조체, 모듈, 인터페이스 및 열거형이 포함됩니다.

동작

  • **범위.**Imports 문에 의해 사용 가능하게 된 요소의 범위는 element를 지정했는지 여부에 따라 다릅니다. namespace만 지정한 경우 해당 네임스페이스에 있는 고유한 이름의 모든 멤버와 해당 네임스페이스 내에 있는 컨테이너 요소의 멤버를 한정자 없이도 사용할 수 있습니다. namespace 및 element를 모두 지정한 경우에는 해당 요소의 멤버만 한정자 없이 사용할 수 있습니다.

  • 한정자. 일반적으로 네임스페이스 또는 컨테이너 요소 외부에 있는 코드는 컨테이터 요소의 해당 네임스페이스에 대한 이름으로 멤버의 이름을 한정해야 합니다. 사용자의 프로젝트가 이름이 같은 다른 멤버에 액세스할 수 없는 경우에는 Imports 문에서 이러한 한정을 반드시 수행하지 않아도 됩니다. 이 경우 각 Imports 문에 aliasname을 지정할 수 있습니다. 그러면 같은 이름의 멤버를 한정할 때만 가져오기 별칭이 필요합니다.

예제

다음 예제에서는 Microsoft.VisualBasic.Strings 클래스를 가져온 다음 Left 메서드에 액세스하는 데 사용할 수 있는 별칭인 str을 할당합니다.

' Place Imports statements at the top of your program.
Imports str = Microsoft.VisualBasic.Strings
Class testClass1
    Sub showHello()
        ' Display only the word "Hello"
        MsgBox(str.Left("Hello World", 5))
    End Sub
End Class

위의 예제에서는 Microsoft 내의 VisualBasic 내에 있는 Strings인 중첩된 네임스페이스를 가져옵니다. MsgBox 함수(Visual Basic)Left 메서드에 액세스하는 경우 전체 한정 문자열인 Microsoft.VisualBasic.Strings 대신 별칭 str를 사용할 수 있습니다.

참고 항목

개념

Visual Studio의 .NET Framework 클래스 라이브러리 소개

Visual Basic의 네임스페이스

참조

Namespace 문

Imports 문(XML 네임스페이스)

기타 리소스

Visual Basic 및 .NET Framework