특성 목록(Visual Basic)

  • 아티클

선언된 프로그래밍 요소에 적용할 특성을 지정합니다. 여러 특성은 쉼표로 구분합니다. 다음은 하나의 특성에 대한 구문입니다.

구문

[ attributemodifier ] attributename [ ( attributearguments | attributeinitializer ) ]

부분

요소 설명
attributemodifier 소스 파일의 시작 부분에 적용되는 특성에 필요합니다. 어셈블리 또는 모듈일 수 있습니다.
attributename 필수입니다. 특성 이름입니다.
attributearguments 선택 사항. 이 특성의 위치 인수 목록입니다. 여러 인수는 쉼표로 구분됩니다.
attributeinitializer 선택 사항. 이 특성의 변수 또는 속성 이니셜라이저 목록입니다. 여러 이니셜라이저는 쉼표로 구분됩니다.

설명

거의 모든 프로그래밍 요소(형식, 프로시저, 속성 등)에 하나 이상의 특성을 적용할 수 있습니다. 특성은 어셈블리의 메타데이터에 표시되며 코드에 주석을 달거나 특정 프로그래밍 요소를 사용하는 방법을 지정하는 데 도움이 될 수 있습니다. Visual Basic 및 .NET Framework에서 정의한 특성을 적용하고 고유한 특성을 정의할 수 있습니다.

특성을 사용하는 시기에 대한 자세한 내용은 특성 개요를 참조하세요. 특성 이름에 대한 자세한 내용은 선언된 요소 이름을 참조하세요.

규칙

  • 배치. 대부분의 선언된 프로그래밍 요소에 특성을 적용할 수 있습니다. 하나 이상의 특성을 적용하려면 요소 선언의 시작 부분에 특성 블록을 배치합니다. 특성 목록의 각 항목은 적용하려는 특성과 이 특성 호출에 사용하는 한정자와 인수를 지정합니다.

  • 꺾쇠괄호. 특성 목록을 제공하는 경우 꺾쇠괄호(“<” 및 “>”)로 묶어야 합니다.

  • 선언의 일부. 특성은 별도의 문이 아니라 요소 선언의 일부여야 합니다. 줄 연속 시퀀스(“ _”)를 사용하여 선언 문을 여러 소스 코드 줄로 확장할 수 있습니다.

  • 한정자. 소스 파일의 시작 부분에 있는 프로그래밍 요소에 적용되는 모든 특성에 특성 한정자(Assembly 또는 Module)가 필요합니다. 소스 파일의 시작 부분에 없는 요소에 적용된 특성에는 특성 한정자가 허용되지 않습니다.

  • 인수. 특성에 대한 모든 위치 인수는 변수 또는 속성 이니셜라이저보다 우선해야 합니다.

예시

다음 예제에서는 Function 프로시저의 기본 정의에 DllImportAttribute 특성을 적용합니다.

<DllImportAttribute("kernel32.dll", EntryPoint:="MoveFileW",
    SetLastError:=True, CharSet:=CharSet.Unicode,
    ExactSpelling:=True,
    CallingConvention:=CallingConvention.StdCall)>
Public Shared Function MoveFile(ByVal src As String,
  ByVal dst As String) As Boolean
    ' This function copies a file from the path src to the path dst.
    ' Leave this function empty. The DLLImport attribute forces calls
    ' to MoveFile to be forwarded to MoveFileW in KERNEL32.DLL.
End Function

DllImportAttribute는 특성 프로시저가 관리되지 않는 DLL(동적 연결 라이브러리)의 진입점을 나타낸다는 것을 나타냅니다. 이 특성은 DLL 이름을 위치 인수로, 다른 정보를 변수 이니셜라이저로 제공합니다.

참고 항목