다음을 통해 공유


Sub 문(Visual Basic)

Sub 프로시저를 정의하는 이름, 매개 변수 및 코드를 선언합니다.

구문

[ <attributelist> ] [ Partial ] [ accessmodifier ] [ proceduremodifiers ] [ Shared ] [ Shadows ] [ Async ]
Sub name [ (Of typeparamlist) ] [ (parameterlist) ] [ Implements implementslist | Handles eventlist ]
    [ statements ]
    [ Exit Sub ]
    [ statements ]
End Sub

부분

  • attributelist

    선택 사항. 특성 목록을 참조하세요.

  • Partial

    선택 사항. 부분 메서드의 정의를 나타냅니다. 부분 메서드를 참조하세요.

  • accessmodifier

    선택 사항. 다음 중 하나일 수 있습니다.

    Access levels in Visual Basic을 참조하세요.

  • proceduremodifiers

    선택 사항. 다음 중 하나일 수 있습니다.

  • Shared

    선택 사항. 공유를 참조하세요.

  • Shadows

    선택 사항. Shadows를 참조하세요.

  • Async

    선택 사항. 비동기를 참조하세요.

  • name

    필수입니다. 프로시저의 이름입니다. Declared Element Names을 참조하세요. 클래스에 대한 생성자 프로시저를 만들려면 Sub 프로시저의 이름을 New 키워드로 설정합니다. 자세한 내용은 개체 수명: 개체 만들기 및 제거 방법을 참조하세요.

  • typeparamlist

    선택 사항. 제네릭 프로시저의 형식 매개 변수 목록입니다. 형식 목록을 참조하세요.

  • parameterlist

    선택 사항. 이 프로시저의 매개 변수를 나타내는 지역 변수 이름 목록입니다. 매개 변수 목록을 참조하세요.

  • Implements

    선택 사항. 이 프로시저가 하나 이상의 Sub 프로시저를 구현함을 나타냅니다. 각 프로시저는 이 프로시저를 포함하는 클래스 또는 구조체에 의해 구현된 인터페이스에 정의됩니다. Implements 문을 참조하세요.

  • implementslist

    Implements가 제공된 경우 필수입니다. 구현할 Sub 프로시저 목록입니다.

    implementedprocedure [ , implementedprocedure ... ]

    implementedprocedure에는 다음과 같은 구문과 요소가 있습니다.

    interface.definedname

    요소 설명
    interface 필수입니다. 이 프로시저를 포함하는 클래스 또는 구조체에 의해 구현된 인터페이스의 이름입니다.
    definedname 필수입니다. 프로시저가 interface에 정의되는 이름입니다.
  • Handles

    선택 사항. 이 프로시저가 하나 이상의 특정 이벤트를 처리할 수 있음을 나타냅니다. 핸들을 참조하세요.

  • eventlist

    Handles가 제공된 경우 필수입니다. 이 프로시저가 처리하는 이벤트 목록입니다.

    eventspecifier [ , eventspecifier ... ]

    eventspecifier에는 다음과 같은 구문과 요소가 있습니다.

    eventvariable.event

    요소 설명
    eventvariable 필수입니다. 이벤트를 발생시키는 클래스 또는 구조체의 데이터 형식으로 선언된 개체 변수입니다.
    event 필수입니다. 이 프로시저가 처리하는 이벤트의 이름입니다.
  • statements

    선택 사항. 이 프로시저 내에서 실행할 문 블록입니다.

  • End Sub

    이 프로시저의 정의를 종료합니다.

설명

모든 실행 코드는 프로시저 내부에 있어야 합니다. 호출 코드에 값을 반환하지 않으려면 Sub 프로시저를 사용합니다. 값을 반환하려면 Function 프로시저를 사용합니다.

하위 프로시저 정의

모듈 수준에서만 Sub 프로시저를 정의할 수 있습니다. 따라서 하위 프로시저의 선언 컨텍스트는 클래스, 구조체, 모듈 또는 인터페이스여야 하며 원본 파일, 네임스페이스, 프로시저 또는 블록이 될 수 없습니다. 자세한 내용은 선언 컨텍스트 및 기본 액세스 수준을 참조하세요.

Sub 프로시저는 기본적으로 공용 액세스로 설정됩니다. 액세스 한정자를 사용하여 액세스 수준을 조정할 수 있습니다.

프로시저가 Implements 키워드를 사용하는 경우 포함 클래스 또는 구조체에는 Class 또는 Structure 문 바로 뒤에 오는 Implements 문이 있어야 합니다. Implements 문은 implementslist에 지정된 각 인터페이스를 포함해야 합니다. 그러나 인터페이스가 definedname에 있는 Sub를 정의하는 이름이 name에 있는 이 프로시저의 이름과 일치할 필요는 없습니다.

하위 프로시저에서 복귀

Sub 프로시저가 호출 코드로 반환되면 이를 호출한 문 뒤의 문으로 실행이 계속됩니다.

다음 예에서는 Sub 프로시저의 반환을 보여 줍니다.

Sub mySub(ByVal q As String)
    Return
End Sub

Exit SubReturn 문은 Sub 프로시저를 즉시 종료합니다. Exit SubReturn 문은 프로시저의 어느 위치에나 나타날 수 있으며, Exit SubReturn 문을 혼합할 수 있습니다.

하위 프로시저 호출

문에서 프로시저 이름을 사용한 다음 해당 이름 뒤에 인수 목록을 괄호 안에 넣어서 Sub 프로시저를 호출합니다. 인수를 제공하지 않는 경우에만 괄호를 생략할 수 있습니다. 그러나 항상 괄호를 포함하면 코드를 더 쉽게 읽을 수 있습니다.

Sub 프로시저와 Function 프로시저에는 매개 변수가 있고 일련의 문을 수행할 수 있습니다. 그러나 Function 프로시저는 값을 반환하고 Sub 프로시저는 값을 반환하지 않습니다. 따라서 식에서 Sub 프로시저를 사용할 수 없습니다.

Sub 프로시저를 호출할 때 Call 키워드를 사용할 수 있지만 해당 키워드는 대부분의 용도에 권장되지 않습니다. 자세한 내용은 Call 문을 참조하세요.

Visual Basic에서는 내부 효율성을 높이기 위해 산술 식을 다시 정렬하는 경우가 있습니다. 따라서 인수 목록에 다른 프로시저를 호출하는 식이 포함되어 있는 경우 해당 식이 특정 순서로 호출될 것이라고 가정하면 안 됩니다.

비동기 하위 프로시저

비동기 함수를 사용하면 명시적 콜백을 사용하거나 코드를 여러 함수 또는 람다 식에 수동으로 분할하지 않고도 비동기 함수를 호출할 수 있습니다.

Async 한정자로 프로시저를 표시하면 프로시저에서 Await 연산자를 사용할 수 있습니다. 제어가 Async 프로시저의 Await 식에 도달하면 제어가 호출자에게 반환되고 대기 중인 작업이 완료될 때까지 프로시저의 진행이 일시 중단됩니다. 작업이 완료되면 프로시저에서 실행이 다시 시작될 수 있습니다.

참고 항목

아직 완료되지 않은 첫 번째 대기 개체가 발견되거나 Async 프로시저의 끝에 도달하는 경우 중 먼저 발생하는 경우 Async 프로시저가 호출자에게 반환됩니다.

Async 한정자를 사용하여 Function 문을 표시할 수도 있습니다. Async 함수는 Task<TResult> 또는 Task 반환 형식을 가질 수 있습니다. 이 항목 뒷부분의 예에서는 반환 형식이 Task<TResult>Async 함수를 보여 줍니다.

AsyncSub 프로시저는 주로 값을 반환할 수 없는 이벤트 처리기에 사용됩니다. AsyncSub 프로시저를 기다릴 수 없으며 AsyncSub 프로시저 호출자는 Sub 프로시저에서 throw되는 예외를 catch할 수 없습니다.

Async 프로시저는 ByRef 매개 변수를 선언할 수 없습니다.

Async 프로시저에 대한 자세한 내용은 Async 및 Await를 사용한 비동기 프로그래밍, 비동기 프로그램의 제어 흐름비동기 반환 형식을 참조하세요.

예 1

다음 예에서는 Sub 문을 사용하여 Sub 프로시저의 본문을 구성하는 이름, 매개 변수 및 코드를 정의합니다.

Sub ComputeArea(ByVal length As Double, ByVal width As Double)
    ' Declare local variable.
    Dim area As Double
    If length = 0 Or width = 0 Then
        ' If either argument = 0 then exit Sub immediately.
        Exit Sub
    End If
    ' Calculate area of rectangle.
    area = length * width
    ' Print area to Immediate window.
    Debug.WriteLine(area)
End Sub

예제 2

다음 예에서 DelayAsync은(는) 반환 형식이 Task<TResult>Async Function입니다. DelayAsync 에는 정수를 반환하는 Return 문이 포함됩니다. 따라서 DelayAsync의 함수 선언에는 Task(Of Integer)의 반환 형식이 있어야 합니다. 반환 형식이 Task(Of Integer)이므로 DoSomethingAsyncAwait 식 계산에서 다음 Dim result As Integer = Await delayTask 문과 같이 정수가 생성됩니다.

startButton_Click 프로시저는 Async Sub 프로시저의 예입니다. DoSomethingAsyncAsync 함수이므로 다음 문에 표시된 것처럼 DoSomethingAsync 호출에 대한 작업을 기다려야 합니다. Await DoSomethingAsync(). startButton_Click Sub 프로시저에는 Await 식이 있으므로 Async 한정자로 정의해야 합니다.

' Imports System.Diagnostics
' Imports System.Threading.Tasks

' This Click event is marked with the Async modifier.
Private Async Sub startButton_Click(sender As Object, e As RoutedEventArgs) Handles startButton.Click
    Await DoSomethingAsync()
End Sub

Private Async Function DoSomethingAsync() As Task
    Dim delayTask As Task(Of Integer) = DelayAsync()
    Dim result As Integer = Await delayTask

    ' The previous two statements may be combined into
    ' the following statement.
    ' Dim result As Integer = Await DelayAsync()

    Debug.WriteLine("Result: " & result)
End Function

Private Async Function DelayAsync() As Task(Of Integer)
    Await Task.Delay(100)
    Return 5
End Function

'  Output:
'   Result: 5

참고 항목