작성일: 2026-03-21 | 대상: VS 2019 + .NET Framework 4.7.2 + DevExpress

1. 개요
2. 솔루션 구조
3. 기본 화면 개발
4. 컨트롤 목록
5. 데이터 관리 (UBiDataManager)
6. 버튼 타입 및 커맨드
7. 다국어 지원
8. 권한 관리
9. 메시지 박스 / 팝업
10. 개발 주의사항

UBi 프레임워크는 DevExpress WinForms 기반의 사내 UI 프레임워크입니다. 화면 개발자는 직접 데이터 바인딩, 다국어, 권한, 레이아웃 관리를 신경 쓸 필요 없이 정해진 Base 클래스와 컨트롤을 사용하여 업무 화면을 빠르게 개발할 수 있습니다.

UBiDLL.sln
├── 10.Standard/               ← 공통 라이브러리 (.NET Standard)
│   ├── UBi/                   ← 핵심 유틸리티 (Crypto, Log, DataConverter)
│   ├── UBi.IO/                ← 파일 I/O
│   ├── UBi.Net/               ← 네트워크 공통 모델
│   ├── UBi.Net.RestfulClient/ ← REST API 클라이언트
│   ├── UBi.Net.Sockets/       ← 소켓 통신
│   ├── UBi.Net.Server/        ← 서버 처리
│   ├── UBi.Platform/          ← 플랫폼 공통 (설정, 사용자정보, DB요청)
│   ├── UBi.Database/          ← DB 추상화 인터페이스
│   ├── UBi.Database.MySql/    ← MySQL
│   ├── UBi.Database.Oracle/   ← Oracle
│   ├── UBi.Database.SQLServer/← SQL Server
│   └── UBi.DataBase.PostgreSQL/← PostgreSQL
│
└── 30.WinForm/                ← WinForms UI 레이어
    ├── UBi.Platform.Images/   ← 이미지 / 아이콘 리소스
    ├── UBi.WinForm/           ← WinForms 공통 유틸
    └── UBi.WinForm.Controls/  ← 커스텀 컨트롤 (개발 핵심)

UBi 프레임워크에는 세 가지 기본 화면 유형이 있습니다.

업무 화면은 반드시 BaseModule 을 상속받아 개발합니다.

using UBi.WinForm.Controls;
 
namespace MyApp
{
    public partial class FrmSampleModule : BaseModule
    {
        public FrmSampleModule()
        {
            InitializeComponent();
        }
 
        // 화면이 완전히 로드된 후 실행됨 (Application.Idle 이후)
        public override void OnLoaded(object sender, EventArgs e)
        {
            base.OnLoaded(sender, e);
            // 초기 조회 등 로드 후 처리
            DoSearch();
        }
 
        private void DoSearch()
        {
            // DataBase (UBiDataManager) 를 통해 조회
            DataBase?.Fill();
        }
 
        // 저장 버튼 클릭 시
        private void btnSave_UBiCheckValidate(object sender, EventArgButtonClick e)
        {
            if (!e.isPass) return;
            DataBase?.Update();
        }
    }
}

팝업 화면은 BaseForm 을 상속받아 개발합니다.

public partial class FrmPopupSample : BaseForm
{
    public FrmPopupSample()
    {
        InitializeComponent();
    }
 
    // 팝업에서 결과 데이터 반환 시
    private void btnOk_Click(object sender, EventArgs e)
    {
        // PopupReturnData 에 반환값 설정
        this.PopupReturnData = gridView1.GetFocusedDataRow();
        this.DialogResult = DialogResult.OK;
        this.Close();
    }
}

BaseModule 을 MDI 탭에 올릴 때 사용합니다.

// BaseModule을 MDI로 열기
var module = new FrmSampleModule();
var mdiForm = new UBiMdiForm(module);
mdiForm.MdiParent = this;
mdiForm.Show();

[생성자] InitializeComponent()
    ↓
[OnLoad] BaseProcess 초기화, 언어 초기화
    ↓
[Application.Idle] OnLoaded() 호출
    ↓
[OnLoaded] LoadGridViewLayout(), 권한 적용
    ↓
[개발자 Override] OnLoaded() 에서 초기 조회 수행

⚠️ 주의: 초기 조회는 반드시 OnLoaded 에서 수행하세요.
생성자나 OnLoad 에서 데이터를 조회하면 컨트롤 초기화 전에 실행될 수 있습니다.

모든 UBi 입력 컨트롤은 IUBiControl 인터페이스를 구현합니다.

UBiDataManager 는 화면과 DB 사이의 데이터 흐름을 담당하는 핵심 컴포넌트입니다. 디자인 타임에 컴포넌트 트레이에 추가하고, BaseModule.DataBase 속성에 연결하여 사용합니다.

// Designer에서 설정되는 항목들
ubiDataManager1.ServiceUrl      = "http://server:port";
ubiDataManager1.ServiceName     = "ServiceName";
ubiDataManager1.ServiceUserId   = "userId";
ubiDataManager1.ServicePassword = "password";

// 전체 조회
DataBase.Fill();
 
// 파라미터 지정 후 조회
DataBase.SetParam("A_USER_ID", userId);
DataBase.SetParam("A_DEPT_CD", deptCode);
DataBase.Fill();

// 변경된 데이터 저장 (Insert/Update 처리)
DataBase.Update();
 
// 선택된 행 삭제
DataBase.Delete();

// 조회 완료 후 처리 예시
private void DataBase_EventDataFillComplete(object sender, DataFillCompletArg e)
{
    // e.Value: 조회된 DataTable
    lblCount.Text = $"총 {e.Value.Rows.Count} 건";
}
 
// 행 삭제 취소 예시
private void DataBase_EventBeginDataRowDeleting(object sender, BeginDataRowDeletingArg e)
{
    if (e.row["STATUS"].ToString() == "Y")
    {
        e.Cancel = true;  // 삭제 취소
        UBiMessageBox.Show("사용중인 데이터는 삭제할 수 없습니다.");
    }
}

UBiSimpleButton 의 ButtonType 속성에 설정하면 자동으로 아이콘이 적용됩니다.

// 저장 버튼 - Validation 통과 후 실행
private void btnSave_UBiCheckValidate(object sender, EventArgButtonClick e)
{
    if (!e.isPass)
    {
        // 유효성 검사 실패 - e.message에 실패 이유
        UBiMessageBox.Show(e.message);
        return;
    }
    DataBase?.Update();
}

💡 팁: UBiSimpleButton 의 기본 이벤트는 UBiCheckValidate 입니다.
UBiRequirement, UBiValidationGroup 설정 시 자동으로 유효성 검사 후 이벤트가 발생합니다.

UBi 프레임워크는 다국어(Glossary) 를 기본 지원합니다. 컨트롤에 UBiGlossaryCode 를 설정하면 런타임에 자동으로 번역됩니다.

// BaseModule.OnLoad 에서 자동 적용됨
if (PlatformGlobal.Settings.ToolTipLanguage == "ko")
{
    GridLocalizer.Active = new KoreanGridLocalizer();
}

// 문자열을 현재 언어로 번역
string translatedText = "SAVE".GetGlossary();
 
// 컨트롤 전체 언어 변환
this.UBiLanguageTransTo();

화면별 CRUD 권한을 관리합니다.

// UBiMdiForm 생성 시 자동으로 버튼 권한 적용
public UBiMdiForm(BaseModule module, string path = "")
{
    UBiFormAuthority = ((IUBiFormAuthority)module).Authority;
    baseModule = module;
    baseModule.InitAuthority(UBiFormAuthority);
    SetButtonAuthority();  // 버튼 Enabled 자동 설정
}
 
// 수동 권한 적용
public void InitAuthority(UBiFormAuthority au)
{
    Authority = au;
    // LayoutControl 내 IUBiAuthority 컨트롤에 일괄 적용
    foreach (LayoutControl ctl in this.Controls.OfType<LayoutControl>())
        foreach (IUBiAuthority auCtl in ctl.Controls.OfType<IUBiAuthority>())
            auCtl.InitAuthority(au);
}

// 사용자 행동 로그 기록
this.UXEventLogWrite("조회버튼 클릭");
this.UXEventLogWrite("저장완료");

// 일반 메시지
UBiMessageBox.Show("저장이 완료되었습니다.");
 
// 로딩 표시
UBiMessageBox.ShowWait("Please Wait", "Loading ...");
try
{
    // 작업 수행
    DataBase.Fill();
}
finally
{
    UBiMessageBox.CloseWait();
}

// 확인/취소 다이얼로그
var result = UBiQuestionBox.Show("삭제하시겠습니까?");
if (result == DialogResult.Yes)
{
    DataBase.Delete();
}

// 앱 시작 시 스플래시 화면
UBiSplashScreen.Show();
// 초기화 작업...
UBiSplashScreen.Close();

1. [ ] BaseModule 상속 여부 확인
2. [ ] UBiDataManager 컴포넌트 트레이에 추가 및 DataBase 속성 연결
3. [ ] 초기 조회는 OnLoaded 에서 수행
4. [ ] 저장/삭제 전 UBiCheckValidate 이벤트 활용
5. [ ] UBiFieldName 과 DB 컬럼명 일치 여부 확인
6. [ ] KoreanGridLocalizer 적용 여부 확인 (한국어 환경)
7. [ ] 권한 적용 필요 시 UBiFormAuthority 설정

// BaseModule.OnLoad 에서 자동 적용됨
this.AutoScaleMode = AutoScaleMode.Dpi;
this.SetStyle(ControlStyles.OptimizedDoubleBuffer, true);
this.DoubleBuffered = true;

⚠️ 고해상도(4K, 2K) 모니터 사용 환경에서는 app.manifest 에 DPI 인식 설정을 추가해야 합니다.

개발 시 VS Designer 에서 데이터를 미리 보려면 로컬 서버가 실행 중이어야 합니다.

환경변수 UBI3_SERVER = {서버 실행파일 경로}
예: UBI3_SERVER=D:\UBi3Server\

// 디자인 타임에 서버 자동 기동
DataBase.startLocalServer();

문의: 개발팀 polonel9@gmail.com | 최종수정: 2026-03-21