다음을 통해 공유


Wizard 웹 서버 컨트롤 개요

업데이트: 2007년 11월

Wizard 컨트롤을 사용하여 사용자 입력 정보를 수집하기 위한 일련의 폼을 만드는 것과 관련된 대부분의 작업을 단순화할 수 있습니다.

이 항목의 내용은 다음과 같습니다.

  • 시나리오

  • 배경

  • 코드 예제

  • 클래스 참조

시나리오

폼을 사용하여 사용자 입력 정보를 수집하는 작업은 웹 개발 시 반복되는 작업입니다. 작업을 수행하는 데 사용되는 폼 그룹을 마법사라고도 합니다.

ASP.NET Wizard 컨트롤을 사용하면 여러 폼을 만들고 사용자 입력 정보를 수집하는 데 관련된 대부분의 작업을 쉽게 처리할 수 있습니다. Wizard 컨트롤에서는 단계 만들기, 새 단계 추가 또는 단계 다시 정렬 작업을 쉽게 해 주는 간단한 메커니즘을 제공합니다. 따라서 코드를 작성하지 않고도 선형 및 비선형 이동 기능을 만들고 해당 컨트롤에서의 사용자 이동 기능을 사용자 지정할 수 있습니다.

맨 위로 이동

배경

일반적으로 서로 연결된 일련의 폼을 만들어 데이터 수집 과정을 여러 단계로 나눕니다. 각 단계에서 폼 간 이동, 데이터 지속성 및 해당 상태를 관리하여 이 작업을 수행할 수 있습니다. Wizard 컨트롤을 사용하면 개별 단계를 통해 데이터를 수집할 수 있으며 사용자는 각 단계를 자유롭게 이동하면서 보다 쉽게 데이터를 입력할 수 있습니다. 사용자가 여러 단계를 수행하는 동안 컨트롤에서 자동으로 상태를 관리하므로 개발자는 페이지 간의 데이터 지속성 문제에 대해 신경 쓸 필요가 없습니다.

마법사 단계

Wizard 컨트롤에서는 단계를 사용하여 여러 개의 사용자 데이터 입력 섹션을 나타냅니다. 컨트롤의 각 단계에는 해당 단계가 시작 단계, 중간 단계 또는 완료 단계 중 어느 단계인지를 나타내는 StepType이 지정됩니다. 마법사의 중간 단계는 필요한 만큼 추가할 수 있습니다. 사용자 입력 정보를 수집하도록 TextBox 또는 ListBox 컨트롤 등의 다른 컨트롤도 추가할 수 있습니다. Complete 단계에 도달하면 모든 데이터에 액세스할 수 있습니다. 다음 코드 예제에서는 두 단계로 이루어진 Wizard 컨트롤을 보여 줍니다.

<asp:Wizard ID="Wizard1" Runat="server">
    <WizardSteps>
        <asp:WizardStep Runat="server" Title="Step 1">
        </asp:WizardStep>
        <asp:WizardStep Runat="server" Title="Step 2">
        </asp:WizardStep>
    </WizardSteps>
</asp:Wizard>

각 단계에서 컨트롤과 레이블을 추가하고 사용자 데이터를 받을 수 있습니다. Wizard 컨트롤은 표시할 단계를 관리하고 수집된 데이터를 보관하는 과정을 도와 줍니다.

마법사 탐색

Wizard 컨트롤에는 선형 이동 기능과 비선형 이동 기능이 모두 있습니다. 컨트롤 상태 관리를 사용하면 사용자가 각 단계를 앞뒤로 이동할 수 있으며 세로 막대가 표시된 경우 원하는 개별 단계를 선택할 수 있습니다. StepNextButtonText, StepPreviousButtonTextFinishCompleteButtonText 속성을 사용하여 컨트롤의 루트 asp:Wizard 요소에서 탐색 텍스트를 사용자 지정할 수 있습니다.

<asp:Wizard ID="Wizard1" Runat="server"
  StepNextButtonText=" Next >> "
  StepPreviousButtonText=" << Previous "
  FinishCompleteButtonText=" Done! ">

마법사 컨트롤의 기타 부분 사용자 지정

Wizard 컨트롤에서는 제목과 컨트롤의 현재 단계를 자동으로 표시합니다. 제목은 HeaderText 속성을 사용하여 사용자 지정할 수 있습니다. 또한 HeaderTemplate 속성을 사용하여 머리글의 템플릿을 조정할 수 있습니다.

필요한 경우 DisplayCancelButton 속성을 true로 설정하여 취소 단추를 표시할 수 있습니다.

Wizard 컨트롤의 NavigationButtonStyle 속성을 사용하면 쉽게 모든 단추를 공통된 스타일로 설정하면서 각 단추를 개별적으로 사용자 지정할 수 있는 유연성이 있습니다. NavigationButtonStyle 속성은 렌더링되는 모든 단추에 적용됩니다. 그러나 개별 단추의 스타일 속성을 설정하여 이 스타일을 재정의할 수 있습니다.

탐색 템플릿

Wizard 컨트롤에서는 StartNavigationTemplate, FinishNavigationTemplate, StepNavigationTemplateSideBarTemplate 속성을 사용하여 컨트롤의 인터페이스를 세부적으로 사용자 지정할 수 있도록 하는 템플릿을 지원합니다.

Wizard 컨트롤 이벤트

사용자 지정 코드 및 이벤트를 사용하여 Wizard 컨트롤의 동작을 사용자 지정할 수 있습니다.

예를 들어, 사용자가 다음 단추를 클릭할 때 발생되어 현재 단계의 데이터를 캡처하는 NextButtonClick 이벤트를 차단할 수 있습니다. 이 이벤트에 전달되는 WizardNavigationEventArgs 매개 변수에는 CurrentStepIndexNextStepIndex 속성이 포함되어 있습니다. 이 두 속성을 사용하면 현재 및 다음 단계를 기준으로 컨트롤 동작을 사용자 지정하거나, 다음 단추가 클릭될 때 이동을 취소할 수 있습니다.

마찬가지로, PreviousButtonClickFinishButtonClick 이벤트를 사용하여 이전마침 단추의 동작을 사용자 지정할 수 있습니다. 또는 CancelButtonClick 이벤트를 사용하여 취소 단추가 클릭될 때 정리 작업을 수행할 수 있습니다.

맨 위로 이동

코드 예제

연습: 기본 ASP.NET Wizard 컨트롤 만들기

연습: ASP.NET Wizard 컨트롤 고급 사용

맨 위로 이동

클래스 참조

다음 표에서는 Wizard 컨트롤과 관련된 주요 클래스를 보여 줍니다.

멤버

설명

Wizard

컨트롤의 기본 클래스입니다.

WizardNavigationEventArgs

Wizard 컨트롤의 다양한 탐색 이벤트에 필요한 데이터를 제공합니다.

WizardNavigationEventHandler

Wizard 컨트롤의 탐색 이벤트를 처리할 메서드를 나타냅니다.

WizardStep

Wizard 컨트롤에 표시되는 기본 단계를 나타냅니다.

WizardStepCollection

페이지 개발자가 정의한 대로 각 단계의 사용자 인터페이스가 포함된 WizardStep 개체의 컬렉션을 나타냅니다.

WizardStepType

Wizard 컨트롤의 단계에 표시할 수 있는 탐색 UI의 형식을 지정합니다.

맨 위로 이동

참고 항목

참조

CreateUserWizard