[C#] ASP.NET MasterPage 란? 공통 레이아웃 정의하기

hyonie 2025. 3. 28. 11:07

📂 목차

1. MasterPage란?

ASP.NET Web Form에서는 여러 페이지에서 반복되는 UI 요소들 (예를 들면 헤더, 메뉴, 푸터, 스크립트 등..)을 한 곳에서 통합 관리할 수 있는 기능인 MasterPage를 제공합니다.

마스터페이지는 웹사이트 전체의 공통 레이아웃(틀) 을 정의하는 HTML구조입니다.
각 페이지는 해당 틀을 기반으로 자신의 콘텐츠만 채워 넣는 방식으로 구성됩니다.

💬 쉽게 비유하자면?

MasterPage = 웹사이트의 설계도
ContentPlaceHoder = 비어 있는 캔버스
자식페이지 = 그 캔버스에 그림을 그리는 개별 콘텐츠 페이지

즉, Main.master만 수정하면 모든 페이지에 공통으로 반영되기 때문에 유지보수가 매우 편리합니다!

2. 기본 구조 살펴보기

2-1. 마스터페이지 선언부

<%@ Master Language="C#" AutoEventWireup="true" CodeFile="Main.master.cs" Inherits="Master_Main" %>

항목	설명
Master	이 파일이 마스터페이지임을 선언
CodeFile	연결된 C# 코드비하인드 파일(Main.master.cs)
Inherits = "Master_Main"	이 마스터페이지가 상속받는 클래스명

2-2. 예시 파일 구조

/Views
 ├── Master/
 │    └── Main.master       ← 공통 레이아웃 정의
 ├── Pages/
 │    └── Home.aspx         ← 실제 콘텐츠가 들어갈 페이지

3. 마스터페이지 예제 코드

아래는 가장 기본적인 Main.master 구조 예시입니다.

<%@ Master Language="C#" CodeFile="Main.master.cs" Inherits="Master_Main" %>

<html>
<head runat="server">
    <title>Sample Site</title>
    <link rel="stylesheet" href="/css/site.css" />
    <script src="/js/common.js"></script>
</head>
<body>
    <form runat="server">
        <!-- 공통 상단 메뉴 -->
        <div class="header">
            <a href="/" class="logo">MySite</a>
            <asp:LinkButton ID="lbtLogin" runat="server">로그인</asp:LinkButton>
            <asp:LinkButton ID="lbtLogout" runat="server">로그아웃</asp:LinkButton>
        </div>

        <!-- 페이지 개별 콘텐츠가 들어갈 위치 -->
        <asp:ContentPlaceHolder ID="ContentPlaceHolder1" runat="server" />

        <!-- 공통 하단 푸터 -->
        <div class="footer">
            <p>&copy; 2025 MyCompany. All rights reserved.</p>
        </div>
    </form>
</body>
</html>

4. 핵심: ContentPlaceHolder란?

<asp:ContentPlaceHolder ID="ContentPlaceHolder1" runat="server">
</asp:ContentPlaceHolder>

마스터페이지에서 콘텐츠를 삽입할 수 있는 자리입니다.
각 자식 페이지에서는 이 영역에만 자신만의 콘텐츠를 삽입합니다.

예시 자식 페이지(Home.aspx)

<asp:Content ID="Content1" ContentPlaceHolderID="ContentPlaceHolder1" runat="server">
    <h2>홈페이지 콘텐츠입니다</h2>
</asp:Content>

✅ 요약

MasterPage는 전체 페이지에 공통 적용되는 레이아웃을 정의하고, ContentPlaceHoder는 자식 페이지 콘텐츠가 삽입되는 자리로

마스터페이지 한 번 설정하면 각 페이지는 콘텐츠만 작성하면된다.!✨

'C#' 카테고리의 다른 글

[ASP.NET] PC/모바일 접속 구분 - Request.UserAgent & IndexOf (0)	2025.03.28
[C#] ASP.NET 4.0 WebForms Global.asax 파일 (0)	2025.02.28
[C#] ASP.NET의 TCP 연결 설정 (0)	2025.02.17
[C#] var 키워드의 암묵적 타입 추론 (0)	2025.02.16
[C#] ASP.NET 4.0 레거시 코드 web.config 파일 분석 (0)	2024.12.30

현재글[C#] ASP.NET MasterPage 란? 공통 레이아웃 정의하기

hyonie's Stack 👩🏻‍💻

현재 C# 코드를 유지보수하며 웹 개발을 진행 중이며, NestJS와 Next.js를 활용한 웹 애플리케이션 개발에도 관심을 가지고 학습과 실무를 병행하고 있습니다.

일	월	화	수	목	금	토
		1	2	3	4	5
6	7	8	9	10	11	12
13	14	15	16	17	18	19
20	21	22	23	24	25	26
27	28	29	30

hyonie's Stack 👩🏻‍💻

[C#] ASP.NET MasterPage 란? 공통 레이아웃 정의하기

1. MasterPage란?

💬 쉽게 비유하자면?

2. 기본 구조 살펴보기

2-1. 마스터페이지 선언부

2-2. 예시 파일 구조

3. 마스터페이지 예제 코드

4. 핵심: ContentPlaceHolder란?

예시 자식 페이지(Home.aspx)

✅ 요약

'C#' 카테고리의 다른 글

'C#'의 다른글

티스토리툴바

[C#] ASP.NET MasterPage 란? 공통 레이아웃 정의하기

1. MasterPage란?

💬 쉽게 비유하자면?

2. 기본 구조 살펴보기

2-1. 마스터페이지 선언부

2-2. 예시 파일 구조

3. 마스터페이지 예제 코드

4. 핵심: ContentPlaceHolder란?

예시 자식 페이지(Home.aspx)

✅ 요약

'C#' 카테고리의 다른 글

'C#'의 다른글

관련글

티스토리툴바