ATTRIBUTE Archives - icodebroker

[C#/WINUI3/COMMUNITY TOOLKIT/.NET8] RelayCommandAttribute 클래스 : 메소드를 사용해 명령 만들기

■ RelayCommandAttribute 클래스에서 메소드를 사용해 명령을 만드는 방법을 보여준다. ※ CommunityToolkit.Mvvm 누겟을 설치한다. ▶ 예제 코드 (C#)


using Windows.System;

using Microsoft.Web.WebView2.Core;

using CommunityToolkit.Mvvm.ComponentModel;
using CommunityToolkit.Mvvm.Input;

namespace TestProject;

/// <summary>
/// 웹 뷰 모델
/// </summary>
public partial class WebViewModel : ObservableRecipient, INavigationAware
{
    //////////////////////////////////////////////////////////////////////////////////////////////////// Field
    ////////////////////////////////////////////////////////////////////////////////////////// Prvate

    #region Field

    /// <summary>
    /// 소스
    /// </summary>
    [ObservableProperty]
    private Uri source = new("https://docs.microsoft.com/windows/apps/");

    /// <summary>
    /// 로딩 여부
    /// </summary>
    [ObservableProperty]
    private bool isLoading = true;

    /// <summary>
    /// 실패 여부
    /// </summary>
    [ObservableProperty]
    private bool hasFailures;

    #endregion

    //////////////////////////////////////////////////////////////////////////////////////////////////// Property
    ////////////////////////////////////////////////////////////////////////////////////////// Public

    #region 웹 뷰 서비스 - WebViewService

    /// <summary>
    /// 웹 뷰 서비스
    /// </summary>
    public IWebViewService WebViewService { get; }

    #endregion

    //////////////////////////////////////////////////////////////////////////////////////////////////// Constructor
    ////////////////////////////////////////////////////////////////////////////////////////// Public

    #region 생성자 - WebViewModel(webViewService)

    /// <summary>
    /// 생성자
    /// </summary>
    /// <param name="webViewService">웹 뷰 서비스</param>
    public WebViewModel(IWebViewService webViewService)
    {
        WebViewService = webViewService;
    }

    #endregion

    //////////////////////////////////////////////////////////////////////////////////////////////////// Method
    ////////////////////////////////////////////////////////////////////////////////////////// Public

    #region 탐색 진입시 처리하기 - OnNavigatedTo(parameter)

    /// <summary>
    /// 탐색 진입시 처리하기
    /// </summary>
    /// <param name="parameter">매개 변수</param>
    public void OnNavigatedTo(object parameter)
    {
        WebViewService.NavigationCompleted += WebViewService_NavigationCompleted;
    }

    #endregion
    #region 탐색 이탈시 처리하기 - OnNavigatedFrom()

    /// <summary>
    /// 탐색 이탈시 처리하기
    /// </summary>
    public void OnNavigatedFrom()
    {
        WebViewService.UnregisterEvent();

        WebViewService.NavigationCompleted -= WebViewService_NavigationCompleted;
    }

    #endregion

    ////////////////////////////////////////////////////////////////////////////////////////// Private
    //////////////////////////////////////////////////////////////////////////////// Event

    #region 웹 뷰 서비스 탐색 완료시 처리하기 - WebViewService_NavigationCompleted(sender, status)

    /// <summary>
    /// 웹 뷰 서비스 탐색 완료시 처리하기
    /// </summary>
    /// <param name="sender">이벤트 발생자</param>
    /// <param name="status">코어 웹 뷰 2 웹 에러 상태</param>
    private void WebViewService_NavigationCompleted(object sender, CoreWebView2WebErrorStatus status)
    {
        IsLoading = false;

        BrowserBackwardCommand.NotifyCanExecuteChanged();
        BrowserForwardCommand.NotifyCanExecuteChanged();

        if(status != default)
        {
            HasFailures = true;
        }
    }

    #endregion

    //////////////////////////////////////////////////////////////////////////////// Function

    #region 브라우저에서 열기 - OpenInBrowser()

    /// <summary>
    /// 브라우저에서 열기
    /// </summary>
    /// <returns>태스크</returns>
    [RelayCommand]
    private async Task OpenInBrowser()
    {
        if(WebViewService.Source != null)
        {
            await Launcher.LaunchUriAsync(WebViewService.Source);
        }
    }

    #endregion
    #region 다시 로드하기 - Reload()

    /// <summary>
    /// 다시 로드하기
    /// </summary>
    [RelayCommand]
    private void Reload()
    {
        WebViewService.Reload();
    }

    #endregion
    #region 브라우저 앞으로 가기 가능 여부 구하기 - BrowserCanGoForward()

    /// <summary>
    /// 브라우저 앞으로 가기 가능 여부 구하기
    /// </summary>
    /// <returns>브라우저 앞으로 가기 가능 여부</returns>
    private bool BrowserCanGoForward()
    {
        return WebViewService.CanGoForward;
    }

    #endregion
    #region 브라우저 앞으로 가기 - BrowserForward()

    /// <summary>
    /// 브라우저 앞으로 가기
    /// </summary>
    [RelayCommand(CanExecute = nameof(BrowserCanGoForward))]
    private void BrowserForward()
    {
        if(WebViewService.CanGoForward)
        {
            WebViewService.GoForward();
        }
    }

    #endregion
    #region 브라우저 뒤로 가기 가능 여부 구하기 - BrowserCanGoBackward()

    /// <summary>
    /// 브라우저 뒤로 가기 가능 여부 구하기
    /// </summary>
    /// <returns>브라우저 뒤로 가기 가능 여부</returns>
    private bool BrowserCanGoBackward()
    {
        return WebViewService.CanGoBack;
    }

    #endregion
    #region 브라우저 뒤로 가기 - BrowserBackward()

    /// <summary>
    /// 브라우저 뒤로 가기
    /// </summary>
    [RelayCommand(CanExecute = nameof(BrowserCanGoBackward))]
    private void BrowserBackward()
    {
        if(WebViewService.CanGoBack)
        {
            WebViewService.GoBack();
        }
    }

    #endregion
    #region 재시도시 처리하기 - OnRetry()

    /// <summary>
    /// 재시도시 처리하기
    /// </summary>
    [RelayCommand]
    private void OnRetry()
    {
        HasFailures = false;

        IsLoading = true;

        WebViewService?.Reload();
    }

    #endregion
}

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

192

193

194

195

196

197

198

199

200

201

202

203

204

205

206

207

208

209

210

211

212

213

214

215

216

217

218

219

220

221

222

223

224

using Windows.System;

using Microsoft.Web.WebView2.Core;

using CommunityToolkit.Mvvm.ComponentModel;

using CommunityToolkit.Mvvm.Input;

namespace TestProject;

/// <summary>

/// 웹 뷰 모델

/// </summary>

public partial class WebViewModel : ObservableRecipient, INavigationAware

{

//////////////////////////////////////////////////////////////////////////////////////////////////// Field

////////////////////////////////////////////////////////////////////////////////////////// Prvate

#region Field

/// <summary>

/// 소스

/// </summary>

[ObservableProperty]

private Uri source = new("https://docs.microsoft.com/windows/apps/");

/// <summary>

/// 로딩 여부

/// </summary>

[ObservableProperty]

private bool isLoading = true;

/// <summary>

/// 실패 여부

/// </summary>

[ObservableProperty]

private bool hasFailures;

#endregion

//////////////////////////////////////////////////////////////////////////////////////////////////// Property

////////////////////////////////////////////////////////////////////////////////////////// Public

#region 웹 뷰 서비스 - WebViewService

/// <summary>

/// 웹 뷰 서비스

/// </summary>

public IWebViewService WebViewService { get; }

#endregion

//////////////////////////////////////////////////////////////////////////////////////////////////// Constructor

////////////////////////////////////////////////////////////////////////////////////////// Public

#region 생성자 - WebViewModel(webViewService)

/// <summary>

/// 생성자

/// </summary>

/// <param name="webViewService">웹 뷰 서비스</param>

public WebViewModel(IWebViewService webViewService)

{

WebViewService = webViewService;

}

#endregion

//////////////////////////////////////////////////////////////////////////////////////////////////// Method

////////////////////////////////////////////////////////////////////////////////////////// Public

#region 탐색 진입시 처리하기 - OnNavigatedTo(parameter)

/// <summary>

/// 탐색 진입시 처리하기

/// </summary>

/// <param name="parameter">매개 변수</param>

public void OnNavigatedTo(object parameter)

{

WebViewService.NavigationCompleted += WebViewService_NavigationCompleted;

}

#endregion

#region 탐색 이탈시 처리하기 - OnNavigatedFrom()

/// <summary>

/// 탐색 이탈시 처리하기

/// </summary>

public void OnNavigatedFrom()

{

WebViewService.UnregisterEvent();

WebViewService.NavigationCompleted -= WebViewService_NavigationCompleted;

}

#endregion

////////////////////////////////////////////////////////////////////////////////////////// Private

//////////////////////////////////////////////////////////////////////////////// Event

#region 웹 뷰 서비스 탐색 완료시 처리하기 - WebViewService_NavigationCompleted(sender, status)

/// <summary>

/// 웹 뷰 서비스 탐색 완료시 처리하기

/// </summary>

/// <param name="sender">이벤트 발생자</param>

/// <param name="status">코어 웹 뷰 2 웹 에러 상태</param>

private void WebViewService_NavigationCompleted(object sender, CoreWebView2WebErrorStatus status)

{

IsLoading = false;

BrowserBackwardCommand.NotifyCanExecuteChanged();

BrowserForwardCommand.NotifyCanExecuteChanged();

if(status != default)

{

HasFailures = true;

}

#endregion

//////////////////////////////////////////////////////////////////////////////// Function

#region 브라우저에서 열기 - OpenInBrowser()

/// <summary>

/// 브라우저에서 열기

/// </summary>

/// <returns>태스크</returns>

[RelayCommand]

private async Task OpenInBrowser()

{

if(WebViewService.Source != null)

{

await Launcher.LaunchUriAsync(WebViewService.Source);

}

#endregion

#region 다시 로드하기 - Reload()

/// <summary>

/// 다시 로드하기

/// </summary>

[RelayCommand]

private void Reload()

{

WebViewService.Reload();

}

#endregion

#region 브라우저 앞으로 가기 가능 여부 구하기 - BrowserCanGoForward()

/// <summary>

/// 브라우저 앞으로 가기 가능 여부 구하기

/// </summary>

/// <returns>브라우저 앞으로 가기 가능 여부</returns>

private bool BrowserCanGoForward()

{

return WebViewService.CanGoForward;

}

#endregion

#region 브라우저 앞으로 가기 - BrowserForward()

/// <summary>

/// 브라우저 앞으로 가기

/// </summary>

[RelayCommand(CanExecute = nameof(BrowserCanGoForward))]

private void BrowserForward()

{

if(WebViewService.CanGoForward)

{

WebViewService.GoForward();

}

#endregion

#region 브라우저 뒤로 가기 가능 여부 구하기 - BrowserCanGoBackward()

/// <summary>

/// 브라우저 뒤로 가기 가능 여부 구하기

/// </summary>

/// <returns>브라우저 뒤로 가기 가능 여부</returns>

private bool BrowserCanGoBackward()

{

return WebViewService.CanGoBack;

}

#endregion

#region 브라우저 뒤로 가기 - BrowserBackward()

/// <summary>

/// 브라우저 뒤로 가기

/// </summary>

[RelayCommand(CanExecute = nameof(BrowserCanGoBackward))]

private void BrowserBackward()

{

if(WebViewService.CanGoBack)

{

WebViewService.GoBack();

}

#endregion

#region 재시도시 처리하기 - OnRetry()

/// <summary>

/// 재시도시 처리하기

/// </summary>

[RelayCommand]

private void OnRetry()

{

HasFailures = false;

IsLoading = true;

WebViewService?.Reload();

}

#endregion

}

[C#/WINUI3/COMMUNITY TOOLKIT/.NET8] ObservablePropertyAttribute 클래스 : 필드를 사용해 의존 속성 만들기

■ ObservablePropertyAttribute 클래스에서 필드를 사용해 의존 속성을 만드는 방법을 보여준다. ※ CommunityToolkit.Mvvm 누겟을 설치한다. ▶ 예제 코드 (C#)


using System.Reflection;
using System.Windows.Input;

using Windows.ApplicationModel;

using Microsoft.UI.Xaml;

using CommunityToolkit.Mvvm.ComponentModel;
using CommunityToolkit.Mvvm.Input;

namespace TestProject;

/// <summary>
/// 설정 뷰 모델
/// </summary>
public partial class SettingViewModel : ObservableRecipient
{
    //////////////////////////////////////////////////////////////////////////////////////////////////// Field
    ////////////////////////////////////////////////////////////////////////////////////////// Private

    #region Field

    /// <summary>
    /// 테마 셀렉터 서비스
    /// </summary>
    private readonly IThemeSelectorService themeSelectorService;

    /// <summary>
    /// 엘리먼트 테마
    /// </summary>
    [ObservableProperty]
    private ElementTheme elementTheme;

    /// <summary>
    /// 버전 설명
    /// </summary>
    [ObservableProperty]
    private string versionDescription;

    #endregion

    //////////////////////////////////////////////////////////////////////////////////////////////////// Property
    ////////////////////////////////////////////////////////////////////////////////////////// Public

    #region 스위치 테마 명령 - SwitchThemeCommand

    /// <summary>
    /// 스위치 테마 명령
    /// </summary>
    public ICommand SwitchThemeCommand { get; }

    #endregion

    //////////////////////////////////////////////////////////////////////////////////////////////////// Constructor
    ////////////////////////////////////////////////////////////////////////////////////////// Public

    #region 생성자 - SettingViewModel(themeSelectorService)

    /// <summary>
    /// 생성자
    /// </summary>
    /// <param name="themeSelectorService">테마 셀렉터 서비스</param>
    public SettingViewModel(IThemeSelectorService themeSelectorService)
    {
        this.themeSelectorService = themeSelectorService;
        this.elementTheme         = this.themeSelectorService.Theme;
        this.versionDescription   = GetVersionDescription();

        SwitchThemeCommand = new RelayCommand<ElementTheme>
        (
            async (parameter) =>
            {
                if(ElementTheme != parameter)
                {
                    ElementTheme = parameter;

                    await this.themeSelectorService.SetThemeAsync(parameter);
                }
            }
        );
    }

    #endregion

    //////////////////////////////////////////////////////////////////////////////////////////////////// Method
    ////////////////////////////////////////////////////////////////////////////////////////// Static
    //////////////////////////////////////////////////////////////////////////////// Private

    #region 버전 설명 구하기 - GetVersionDescription()

    /// <summary>
    /// 버전 설명 구하기
    /// </summary>
    /// <returns>버전 설명</returns>
    private static string GetVersionDescription()
    {
        Version version;

        if(RuntimeHelper.IsMSIX)
        {
            PackageVersion packageVersion = Package.Current.Id.Version;

            version = new(packageVersion.Major, packageVersion.Minor, packageVersion.Build, packageVersion.Revision);
        }
        else
        {
            version = Assembly.GetExecutingAssembly().GetName().Version!;
        }

        return $"{"AppDisplayName".GetLocalString()} - {version.Major}.{version.Minor}.{version.Build}.{version.Revision}";
    }

    #endregion
}

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

using System.Reflection;

using System.Windows.Input;

using Windows.ApplicationModel;

using Microsoft.UI.Xaml;

using CommunityToolkit.Mvvm.ComponentModel;

using CommunityToolkit.Mvvm.Input;

namespace TestProject;

/// <summary>

/// 설정 뷰 모델

/// </summary>

public partial class SettingViewModel : ObservableRecipient

{

//////////////////////////////////////////////////////////////////////////////////////////////////// Field

////////////////////////////////////////////////////////////////////////////////////////// Private

#region Field

/// <summary>

/// 테마 셀렉터 서비스

/// </summary>

private readonly IThemeSelectorService themeSelectorService;

/// <summary>

/// 엘리먼트 테마

/// </summary>

[ObservableProperty]

private ElementTheme elementTheme;

/// <summary>

/// 버전 설명

/// </summary>

[ObservableProperty]

private string versionDescription;

#endregion

//////////////////////////////////////////////////////////////////////////////////////////////////// Property

////////////////////////////////////////////////////////////////////////////////////////// Public

#region 스위치 테마 명령 - SwitchThemeCommand

/// <summary>

/// 스위치 테마 명령

/// </summary>

public ICommand SwitchThemeCommand { get; }

#endregion

//////////////////////////////////////////////////////////////////////////////////////////////////// Constructor

////////////////////////////////////////////////////////////////////////////////////////// Public

#region 생성자 - SettingViewModel(themeSelectorService)

/// <summary>

/// 생성자

/// </summary>

/// <param name="themeSelectorService">테마 셀렉터 서비스</param>

public SettingViewModel(IThemeSelectorService themeSelectorService)

{

this.themeSelectorService = themeSelectorService;

this.elementTheme = this.themeSelectorService.Theme;

this.versionDescription = GetVersionDescription();

SwitchThemeCommand = new RelayCommand<ElementTheme>

(

async (parameter) =>

{

if(ElementTheme != parameter)

{

ElementTheme = parameter;

await this.themeSelectorService.SetThemeAsync(parameter);

}

);

}

#endregion

//////////////////////////////////////////////////////////////////////////////////////////////////// Method

////////////////////////////////////////////////////////////////////////////////////////// Static

//////////////////////////////////////////////////////////////////////////////// Private

#region 버전 설명 구하기 - GetVersionDescription()

/// <summary>

/// 버전 설명 구하기

/// </summary>

/// <returns>버전 설명</returns>

private static string GetVersionDescription()

{

Version version;

if(RuntimeHelper.IsMSIX)

{

PackageVersion packageVersion = Package.Current.Id.Version;

version = new(packageVersion.Major, packageVersion.Minor, packageVersion.Build, packageVersion.Revision);

}

else

{

version = Assembly.GetExecutingAssembly().GetName().Version!;

}

return $"{"AppDisplayName".GetLocalString()} - {version.Major}.{version.Minor}.{version.Build}.{version.Revision}";

}

#endregion

}

[C#/COMMON/.NET8] MemberNotNullWhenAttribute 클래스 : 해당 멤버 NOT NULL 보장하기

■ MemberNotNullWhenAttribute 클래스를 사용해 특정 멤버가 NOT NULL인 것을 보장하는 방법을 보여준다. ※ 조건부 not null 보장 : 특정 조건이 참일 때

[C#/COMMON/.NET6] ConditionalAttribute 클래스 : 지정된 컴파일 기호 지정시 실행하기

■ ConditionalAttribute 클래스를 사용해 지정된 컴파일 기호 지정시 실행하는 방법을 보여준다. ▶ Program.cs


using System.Diagnostics;

namespace TestProject;

/// <summary>
/// 프로그램
/// </summary>
class Program
{
    //////////////////////////////////////////////////////////////////////////////////////////////////// Method
    ////////////////////////////////////////////////////////////////////////////////////////// Static
    //////////////////////////////////////////////////////////////////////////////// Private

    #region 실행하기 - Execute()

    /// <summary>
    /// 실행하기
    /// </summary>
    [Conditional("DEBUG")]
    private static void Execute()
    {
        Console.WriteLine("DEBUG 컴파일 기호가 정의되어 있습니다.");
    }

    #endregion
    #region 프로그램 시작하기 - Main()

    /// <summary>
    /// 프로그램 시작하기
    /// </summary>
    private static void Main()
    {
        Execute();
    }

    #endregion
}

using System.Diagnostics;

namespace TestProject;

/// <summary>

/// 프로그램

/// </summary>

class Program

{

//////////////////////////////////////////////////////////////////////////////////////////////////// Method

////////////////////////////////////////////////////////////////////////////////////////// Static

//////////////////////////////////////////////////////////////////////////////// Private

#region 실행하기 - Execute()

/// <summary>

/// 실행하기

/// </summary>

[Conditional("DEBUG")]

private static void Execute()

{

Console.WriteLine("DEBUG 컴파일 기호가 정의되어 있습니다.");

}

#endregion

#region 프로그램 시작하기 - Main()

/// <summary>

/// 프로그램 시작하기

/// </summary>

private static void Main()

{

Execute();

}

#endregion

}

TestProject.zip

[C#/COMMON] CallerLineNumberAttribute 클래스 : 메소드 호출자의 소스 코드 줄 번호 구하기

■ CallerLineNumberAttribute 클래스를 사용해 메소드 호출자의 소스 코드 줄 번호를 구하는 방법을 보여준다. ▶ 예제 코드 (C#)


using System.Diagnostics;
using System.Runtime.CompilerServices;

#region 메시지 추적하기 - TraceMessage(message, memberName, sourceFilePath, sourceLineNumber)

/// <summary>
/// 메시지 추적하기
/// </summary>
/// <param name="message">메시지</param>
/// <param name="memberName">멤버명</param>
/// <param name="sourceFilePath">소스 파일 경로</param>
/// <param name="sourceLineNumber">소스 행 번호</param>
public void TraceMessage(string message, [CallerMemberName] string memberName = "", [CallerFilePath] string sourceFilePath = "", [CallerLineNumber] int sourceLineNumber = 0)
{
    Trace.WriteLine("메시지         : " + message         );
    Trace.WriteLine("멤버명         : " + memberName      );
    Trace.WriteLine("소스 파일 경로 : " + sourceFilePath  );
    Trace.WriteLine("소스 행 번호   : " + sourceLineNumber);
}

#endregion

using System.Diagnostics;

using System.Runtime.CompilerServices;

#region 메시지 추적하기 - TraceMessage(message, memberName, sourceFilePath, sourceLineNumber)

/// <summary>

/// 메시지 추적하기

/// </summary>

/// <param name="message">메시지</param>

/// <param name="memberName">멤버명</param>

/// <param name="sourceFilePath">소스 파일 경로</param>

/// <param name="sourceLineNumber">소스 행 번호</param>

public void TraceMessage(string message, [CallerMemberName] string memberName = "", [CallerFilePath] string sourceFilePath = "", [CallerLineNumber] int sourceLineNumber = 0)

{

Trace.WriteLine("메시지 : " + message );

Trace.WriteLine("멤버명 : " + memberName );

Trace.WriteLine("소스 파일 경로 : " + sourceFilePath );

Trace.WriteLine("소스 행 번호 : " + sourceLineNumber);

}

#endregion

[C#/COMMON] CallerFilePathAttribute 클래스 : 메소드 호출자의 소스 코드 파일 경로 구하기

■ CallerFilePathAttribute 클래스를 사용해 메소드 호출자의 소스 코드 파일 경로를 구하는 방법을 보여준다. ▶ 예제 코드 (C#)


using System.Diagnostics;
using System.Runtime.CompilerServices;

#region 메시지 추적하기 - TraceMessage(message, memberName, sourceFilePath, sourceLineNumber)

/// <summary>
/// 메시지 추적하기
/// </summary>
/// <param name="message">메시지</param>
/// <param name="memberName">멤버명</param>
/// <param name="sourceFilePath">소스 파일 경로</param>
/// <param name="sourceLineNumber">소스 행 번호</param>
public void TraceMessage(string message, [CallerMemberName] string memberName = "", [CallerFilePath] string sourceFilePath = "", [CallerLineNumber] int sourceLineNumber = 0)
{
    Trace.WriteLine("메시지         : " + message         );
    Trace.WriteLine("멤버명         : " + memberName      );
    Trace.WriteLine("소스 파일 경로 : " + sourceFilePath  );
    Trace.WriteLine("소스 행 번호   : " + sourceLineNumber);
}

#endregion

using System.Diagnostics;

using System.Runtime.CompilerServices;

#region 메시지 추적하기 - TraceMessage(message, memberName, sourceFilePath, sourceLineNumber)

/// <summary>

/// 메시지 추적하기

/// </summary>

/// <param name="message">메시지</param>

/// <param name="memberName">멤버명</param>

/// <param name="sourceFilePath">소스 파일 경로</param>

/// <param name="sourceLineNumber">소스 행 번호</param>

public void TraceMessage(string message, [CallerMemberName] string memberName = "", [CallerFilePath] string sourceFilePath = "", [CallerLineNumber] int sourceLineNumber = 0)

{

Trace.WriteLine("메시지 : " + message );

Trace.WriteLine("멤버명 : " + memberName );

Trace.WriteLine("소스 파일 경로 : " + sourceFilePath );

Trace.WriteLine("소스 행 번호 : " + sourceLineNumber);

}

#endregion

[C#/COMMON/.NET6] DefaultValueAttribute 클래스 : TimeSpan 타입 속성의 디폴트 값 설정하기

■ DefaultValueAttribute 클래스에서 TimeSpan 타입 속성의 디폴트 값을 설정하는 방법을 보여준다. ▶ 예제 코드 (C#)


using System.ComponentModel;

#region 지속 시간 - Duration

/// <summary>
/// 지속 시간
/// </summary>
[DefaultValue("01:00:00")]
public TimeSpan Duration { get; set; }

#endregion

using System.ComponentModel;

#region 지속 시간 - Duration

/// <summary>

/// 지속 시간

/// </summary>

[DefaultValue("01:00:00")]

public TimeSpan Duration { get; set; }

#endregion

[C#/COMMON/.NET6] Attribute 클래스 : IsDefined 정적 메소드를 사용해 객체 속성의 어트리뷰트 설정 여부 구하기

■ Attribute 클래스의 IsDefined 정적 메소드를 사용해 객체 속성의 어트리뷰트 설정 여부를 구하는 방법을 보여준다. ▶ CustomAttribute.cs


namespace TestProject;

/// <summary>
/// 커스텀 어트리뷰트
/// </summary>
public class CustomAttribute : Attribute
{
}

namespace TestProject;

/// <summary>

/// 커스텀 어트리뷰트

/// </summary>

public class CustomAttribute : Attribute

{

}

▶ Product.cs


namespace TestProject;

/// <summary>
/// 제품
/// </summary>
public class Product
{
    //////////////////////////////////////////////////////////////////////////////////////////////////// Property
    ////////////////////////////////////////////////////////////////////////////////////////// Public

    #region 제품 코드 - ProductCode

    /// <summary>
    /// 제품 코드
    /// </summary>
    public string ProductCode { get; set; }

    #endregion
    #region 명칭 - Name

    /// <summary>
    /// 명칭
    /// </summary>
    [Custom]
    public string Name { get; set; }

    #endregion
    #region 가격 - Price

    /// <summary>
    /// 가격
    /// </summary>
    public decimal Price { get; set; }

    #endregion
}

namespace TestProject;

/// <summary>

/// 제품

/// </summary>

public class Product

{

//////////////////////////////////////////////////////////////////////////////////////////////////// Property

////////////////////////////////////////////////////////////////////////////////////////// Public

#region 제품 코드 - ProductCode

/// <summary>

/// 제품 코드

/// </summary>

public string ProductCode { get; set; }

#endregion

#region 명칭 - Name

/// <summary>

/// 명칭

/// </summary>

[Custom]

public string Name { get; set; }

#endregion

#region 가격 - Price

/// <summary>

/// 가격

/// </summary>

public decimal Price { get; set; }

#endregion

}

▶

[C#/COMMON/.NET6] CallerMemberNameAttribute 클래스 : 메소드 호출자의 메소드 또는 속성명 구하기

■ CallerMemberNameAttribute 클래스를 사용해 메소드 호출자의 메소드 또는 속성명을 구하는 방법을 보여준다. ▶ Program.cs


using System.Runtime.CompilerServices;

namespace TestProject;

/// <summary>
/// 프로그램
/// </summary>
class Program
{
    //////////////////////////////////////////////////////////////////////////////////////////////////// Method
    ////////////////////////////////////////////////////////////////////////////////////////// Static
    //////////////////////////////////////////////////////////////////////////////// Private

    #region 로그 쓰기 - WriteLog(message, callerLineNumber, callerMemberName)

    /// <summary>
    /// 로그 쓰기
    /// </summary>
    /// <param name="message">메시지</param>
    /// <param name="callerLineNumber">호출자 라인 번호</param>
    /// <param name="callerMemberName">호출자 멤버명</param>
    private static void WriteLog(string message, [CallerLineNumber] int callerLineNumber = 0, [CallerMemberName] string callerMemberName = "")
    {
        Console.WriteLine($"[{DateTime.Now:HH:mm:ss}] {callerLineNumber:d5}|{callerMemberName}|{message}");
    }

    #endregion

    #region 프로그램 시작하기 - Main()

    /// <summary>
    /// 프로그램 시작하기
    /// </summary>
    private static void Main()
    {
        WriteLog("에러가 발생했습니다.");
    }

    #endregion
}

using System.Runtime.CompilerServices;

namespace TestProject;

/// <summary>

/// 프로그램

/// </summary>

class Program

{

//////////////////////////////////////////////////////////////////////////////////////////////////// Method

////////////////////////////////////////////////////////////////////////////////////////// Static

//////////////////////////////////////////////////////////////////////////////// Private

#region 로그 쓰기 - WriteLog(message, callerLineNumber, callerMemberName)

/// <summary>

/// 로그 쓰기

/// </summary>

/// <param name="message">메시지</param>

/// <param name="callerLineNumber">호출자 라인 번호</param>

/// <param name="callerMemberName">호출자 멤버명</param>

private static void WriteLog(string message, [CallerLineNumber] int callerLineNumber = 0, [CallerMemberName] string callerMemberName = "")

{

Console.WriteLine($"[{DateTime.Now:HH:mm:ss}] {callerLineNumber:d5}|{callerMemberName}|{message}");

}

#endregion

#region 프로그램 시작하기 - Main()

/// <summary>

/// 프로그램 시작하기

/// </summary>

private static void Main()

{

WriteLog("에러가 발생했습니다.");

}

#endregion

}

TestProject.zip

[C#/MAUI/.NET6] CallerMemberNameAttribute 클래스 : 호출자 멤버명 구하기

■ CallerMemberNameAttribute 클래스를 사용해 호출자 멤버명을 구하는 방법을 보여준다. ▶ 예제 코드 (C#)


using System.ComponentModel;
using System.Runtime.CompilerServices;

/// <summary>
/// 사람 뷰 모델
/// </summary>
public class PersonViewModel : INotifyPropertyChanged
{
    //////////////////////////////////////////////////////////////////////////////////////////////////// Event
    ////////////////////////////////////////////////////////////////////////////////////////// Public

    #region 속성 변경시 - PropertyChanged

    /// <summary>
    /// 속성 변경시
    /// </summary>
    public event PropertyChangedEventHandler PropertyChanged;

    #endregion

    //////////////////////////////////////////////////////////////////////////////////////////////////// Field
    ////////////////////////////////////////////////////////////////////////////////////////// Private

    #region Field

    /// <summary>
    /// 성명
    /// </summary>
    private string name;

    /// <summary>
    /// 나이
    /// </summary>
    private double age;

    /// <summary>
    /// 기술
    /// </summary>
    private string skill;

    #endregion

    //////////////////////////////////////////////////////////////////////////////////////////////////// Property
    ////////////////////////////////////////////////////////////////////////////////////////// Public

    #region 성명 - Name

    /// <summary>
    /// 성명
    /// </summary>
    public string Name
    {
        get
        {
            return this.name;
        }
        set
        {
            SetPropertyValue(ref this.name, value);
        }
    }

    #endregion
    #region 나이 - Age

    /// <summary>
    /// 나이
    /// </summary>
    public double Age
    {
        get
        {
            return this.age;
        }
        set
        {
            SetPropertyValue(ref this.age, value);
        }
    }

    #endregion
    #region 기술 - Skill

    /// <summary>
    /// 기술
    /// </summary>
    public string Skill
    {
        get
        {
            return this.skill;
        }
        set
        {
            SetPropertyValue(ref this.skill, value);
        }
    }

    #endregion

    //////////////////////////////////////////////////////////////////////////////////////////////////// Method
    ////////////////////////////////////////////////////////////////////////////////////////// Public

    #region 문자열 구하기 - ToString()

    /// <summary>
    /// 문자열 구하기
    /// </summary>
    /// <returns>문자열</returns>
    public override string ToString()
    {
        return $"{Name}, {Age}세";
    }

    #endregion

    ////////////////////////////////////////////////////////////////////////////////////////// Protected

    #region 속성 변경시 이벤트 발생시키기 - FirePropertyChangedEvent(propertyName)

    /// <summary>
    /// 속성 변경시 이벤트 발생시키기
    /// </summary>
    /// <param name="propertyName">속성명</param>
    protected void FirePropertyChangedEvent([CallerMemberName] string propertyName = null)
    {
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }

    #endregion

    ////////////////////////////////////////////////////////////////////////////////////////// Private

    #region 속성 값 설정하기 - SetPropertyValue<TProperty>(field, value, propertyName)

    /// <summary>
    /// 속성 값 설정하기
    /// </summary>
    /// <typeparam name="TProperty">속성 타입</typeparam>
    /// <param name="field">필드</param>
    /// <param name="value">값</param>
    /// <param name="propertyName">속성명</param>
    /// <returns>처리 결과</returns>
    private bool SetPropertyValue<TProperty>(ref TProperty field, TProperty value, [CallerMemberName] string propertyName = null)
    {
        if(object.Equals(field, value))
        {
            return false;
        }

        field = value;

        FirePropertyChangedEvent(propertyName);

        return true;
    }

    #endregion
}

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

using System.ComponentModel;

using System.Runtime.CompilerServices;

/// <summary>

/// 사람 뷰 모델

/// </summary>

public class PersonViewModel : INotifyPropertyChanged

{

//////////////////////////////////////////////////////////////////////////////////////////////////// Event

////////////////////////////////////////////////////////////////////////////////////////// Public

#region 속성 변경시 - PropertyChanged

/// <summary>

/// 속성 변경시

/// </summary>

public event PropertyChangedEventHandler PropertyChanged;

#endregion

//////////////////////////////////////////////////////////////////////////////////////////////////// Field

////////////////////////////////////////////////////////////////////////////////////////// Private

#region Field

/// <summary>

/// 성명

/// </summary>

private string name;

/// <summary>

/// 나이

/// </summary>

private double age;

/// <summary>

/// 기술

/// </summary>

private string skill;

#endregion

//////////////////////////////////////////////////////////////////////////////////////////////////// Property

////////////////////////////////////////////////////////////////////////////////////////// Public

#region 성명 - Name

/// <summary>

/// 성명

/// </summary>

public string Name

{

get

{

return this.name;

}

set

{

SetPropertyValue(ref this.name, value);

}

#endregion

#region 나이 - Age

/// <summary>

/// 나이

/// </summary>

public double Age

{

get

{

return this.age;

}

set

{

SetPropertyValue(ref this.age, value);

}

#endregion

#region 기술 - Skill

/// <summary>

/// 기술

/// </summary>

public string Skill

{

get

{

return this.skill;

}

set

{

SetPropertyValue(ref this.skill, value);

}

#endregion

//////////////////////////////////////////////////////////////////////////////////////////////////// Method

////////////////////////////////////////////////////////////////////////////////////////// Public

#region 문자열 구하기 - ToString()

/// <summary>

/// 문자열 구하기

/// </summary>

/// <returns>문자열</returns>

public override string ToString()

{

return $"{Name}, {Age}세";

}

#endregion

////////////////////////////////////////////////////////////////////////////////////////// Protected

#region 속성 변경시 이벤트 발생시키기 - FirePropertyChangedEvent(propertyName)

/// <summary>

/// 속성 변경시 이벤트 발생시키기

/// </summary>

/// <param name="propertyName">속성명</param>

protected void FirePropertyChangedEvent([CallerMemberName] string propertyName = null)

{

PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));

}

#endregion

////////////////////////////////////////////////////////////////////////////////////////// Private

#region 속성 값 설정하기 - SetPropertyValue<TProperty>(field, value, propertyName)

/// <summary>

/// 속성 값 설정하기

/// </summary>

/// <typeparam name="TProperty">속성 타입</typeparam>

/// <param name="field">필드</param>

/// <param name="value">값</param>

/// <param name="propertyName">속성명</param>

/// <returns>처리 결과</returns>

private bool SetPropertyValue<TProperty>(ref TProperty field, TProperty value, [CallerMemberName] string propertyName = null)

{

if(object.Equals(field, value))

{

return false;

}

field = value;

FirePropertyChangedEvent(propertyName);

return true;

}

#endregion

}

[C#/MAUI/.NET6] XamlCompilationAttribute 클래스 : 페이지 수준에서 XAML 컴파일 활성화하기

■ XamlCompilationAttribute 클래스를 사용해 페이지 수준에서 XAML 컴파일을 활성화하는 방법을 보여준다. ▶ MainPage.xaml.cs


namespace TestProject;

/// <summary>
/// 메인 페이지
/// </summary>
[XamlCompilation(XamlCompilationOptions.Compile)]
public partial class MainPage : ContentPage
{
    //////////////////////////////////////////////////////////////////////////////////////////////////// Constructor
    ////////////////////////////////////////////////////////////////////////////////////////// Public

    #region 생성자 - MainPage()

    /// <summary>
    /// 생성자
    /// </summary>
    public MainPage()
    {
        InitializeComponent();
    }

    #endregion
}

namespace TestProject;

/// <summary>

/// 메인 페이지

/// </summary>

[XamlCompilation(XamlCompilationOptions.Compile)]

public partial class MainPage : ContentPage

{

//////////////////////////////////////////////////////////////////////////////////////////////////// Constructor

////////////////////////////////////////////////////////////////////////////////////////// Public

#region 생성자 - MainPage()

/// <summary>

/// 생성자

/// </summary>

public MainPage()

{

InitializeComponent();

}

#endregion

}

TestProject.zip

[C#/MAUI/.NET6] XamlCompilationAttribute 클래스 : 어셈블리 수준에서 XAML 컴파일 활성화하기

■ XamlCompilationAttribute 클래스를 사용해 어셈블리 수준에서 XAML 컴파일을 활성화하는 방법을 보여준다. ▶ AssemblyInfo.cs


using System.Runtime.InteropServices;

[assembly: ComVisible(false)]

[assembly: Guid("2304E42B-6C62-4775-A4DC-17236E4C2005")]

[assembly: XamlCompilation(XamlCompilationOptions.Compile)]

using System.Runtime.InteropServices;

[assembly: ComVisible(false)]

[assembly: Guid("2304E42B-6C62-4775-A4DC-17236E4C2005")]

[assembly: XamlCompilation(XamlCompilationOptions.Compile)]

TestProject.zip

[C#/MAUI/.NET6] ContentPropertyAttribute 클래스 사용하기

■ ContentPropertyAttribute 클래스를 사용하는 방법을 보여준다. ▶ 예제 코드 (C#)


[ContentProperty("Content")]
public class ContentPage : TemplatedPage, IContentView, IView, IElement, ITransform, IPadding, IHotReloadableView, IReplaceableView
{
    ...
}

[ContentProperty("Content")]

public class ContentPage : TemplatedPage, IContentView, IView, IElement, ITransform, IPadding, IHotReloadableView, IReplaceableView

{

...

}

[C#/MAUI/.NET6] UsesFeatureAttribute 클래스 : 구글 플레이에서 특정 하드웨어가 없는 기기 필터링 방지하기

■ UsesFeatureAttribute 클래스를 사용해 구글 플레이에서 특정 하드웨어가 없는 기기 필터링을 방지하는 방법을 보여준다. ▶ Platforms/Android/MainApplication.cs


using Android.App;
using Android.Runtime;

[assembly: UsesFeature("android.hardware.camera"          , Required = false)]
[assembly: UsesFeature("android.hardware.camera.autofocus", Required = false)]

namespace TestProject;

/// <summary>
/// 메인 애플리케이션
/// </summary>
[Application]
public class MainApplication : MauiApplication
{
    //////////////////////////////////////////////////////////////////////////////////////////////////// Constructor
    ////////////////////////////////////////////////////////////////////////////////////////// Public

    #region 생성자 - MainApplication(handle, ownership)

    /// <summary>
    /// 생성자
    /// </summary>
    /// <param name="handle">핸들</param>
    /// <param name="ownership">소유권</param>
    public MainApplication(IntPtr handle, JniHandleOwnership ownership) : base(handle, ownership)
    {
    }

    #endregion

    //////////////////////////////////////////////////////////////////////////////////////////////////// Method
    ////////////////////////////////////////////////////////////////////////////////////////// Protected

    #region MAUI 앱 생성하기 - CreateMauiApp()

    /// <summary>
    /// MAUI 앱 생성하기
    /// </summary>
    /// <returns>MAUI 앱</returns>
    protected override MauiApp CreateMauiApp() => MauiProgram.CreateMauiApp();

    #endregion
}

using Android.App;

using Android.Runtime;

[assembly: UsesFeature("android.hardware.camera" , Required = false)]

[assembly: UsesFeature("android.hardware.camera.autofocus", Required = false)]

namespace TestProject;

/// <summary>

/// 메인 애플리케이션

/// </summary>

[Application]

public class MainApplication : MauiApplication

{

//////////////////////////////////////////////////////////////////////////////////////////////////// Constructor

////////////////////////////////////////////////////////////////////////////////////////// Public

#region 생성자 - MainApplication(handle, ownership)

/// <summary>

/// 생성자

/// </summary>

/// <param name="handle">핸들</param>

/// <param name="ownership">소유권</param>

public MainApplication(IntPtr handle, JniHandleOwnership ownership) : base(handle, ownership)

{

}

#endregion

//////////////////////////////////////////////////////////////////////////////////////////////////// Method

////////////////////////////////////////////////////////////////////////////////////////// Protected

#region MAUI 앱 생성하기 - CreateMauiApp()

/// <summary>

/// MAUI 앱 생성하기

/// </summary>

/// <returns>MAUI 앱</returns>

protected override MauiApp CreateMauiApp() => MauiProgram.CreateMauiApp();

#endregion

}

※ 상기 코드는 카메라를 예시한

[C#/MAUI/.NET6] Shell 클래스 : GoToAsync 메소드 사용시 객체 기반 쿼리 매개 변수 전달하기 (QueryPropertyAttribute 클래스 사용)

■ Shell 클래스의 GoToAsync 메소드 사용시 객체 기반 쿼리 매개 변수를 전달하는 방법을 보여준다. (QueryPropertyAttribute 클래스 사용) ▶ MonkeyModel.cs


namespace TestProject.Models
{
    /// <summary>
    /// 원숭이 모델
    /// </summary>
    public class MonkeyModel
    {
        //////////////////////////////////////////////////////////////////////////////////////////////////// Property
        ////////////////////////////////////////////////////////////////////////////////////////// Public

        #region 명칭 - Name

        /// <summary>
        /// 명칭
        /// </summary>
        public string Name { get; set; }

        #endregion
        #region 시간 - Time

        /// <summary>
        /// 시간
        /// </summary>
        public DateTime Time { get; set; }

        #endregion
    }
}

namespace TestProject.Models

{

/// <summary>

/// 원숭이 모델

/// </summary>

public class MonkeyModel

{

//////////////////////////////////////////////////////////////////////////////////////////////////// Property

////////////////////////////////////////////////////////////////////////////////////////// Public

#region 명칭 - Name

/// <summary>

/// 명칭

/// </summary>

public string Name { get; set; }

#endregion

#region 시간 - Time

/// <summary>

/// 시간

/// </summary>

public DateTime Time { get; set; }

#endregion

}

▶ MonkeyPage.xaml.cs

[C#/MAUI/.NET6] DebuggerDisplayAttribute 클래스 사용하기

■ DebuggerDisplayAttribute 클래스를 사용하는 방법을 보여준다. ▶ 예제 코드 (C#)


using System.Diagnostics;

[DebuggerDisplay("Location = {Location}")]
public class ShellNavigationState
{
    ...
}

using System.Diagnostics;

[DebuggerDisplay("Location = {Location}")]

public class ShellNavigationState

{

...

}

[C#/MAUI/.NET6] XmlnsPrefixAttribute 클래스 : 커스텀 네임스페이스 접두사 사용하기

■ XmlnsPrefixAttribute 클래스를 사용해 커스텀 네임스페이스 접두사를 사용하는 방법을 보여준다. ▶ AssemblyInfo.cs


[assembly: XmlnsPrefix("http://schemas.microsoft.com/dotnet/2021/maui", "maui")]

[assembly: XmlnsPrefix("http://schemas.microsoft.com/dotnet/2021/maui", "maui")]

[C#/MAUI/.NET6] XmlnsDefinitionAttribute 클래스 : 사용자 지정 네임스페이스 스키마 사용하기

■ XmlnsDefinitionAttribute 클래스를 사용해 사용자 지정 네임스페이스 스키마를 사용하는 방법을 보여준다. [TestLibrary 프로젝트] ▶ CircleButton.cs


namespace TestLibrary.Controls
{
    public class CircleButton : Button
    {
        ...
    }
}

namespace TestLibrary.Controls

{

public class CircleButton : Button

{

...

}

[TestProject 프로젝트] ▶ AssemblyInfo.cs


using TestLibrary.Controls;

[assembly: Preserve]
[assembly: XmlnsDefinition("http://dscore.com/schemas/controls", "TestLibrary.Controls")]

using TestLibrary.Controls;

[assembly: Preserve]

[assembly: XmlnsDefinition("http://dscore.com/schemas/controls", "TestLibrary.Controls")]

▶

[C#/COMMON] MarshalAsAttribute 클래스 : 구조체에서 고정 크기 배열 멤버 만들기

■ MarshalAsAttribute 클래스를 사용해 구조체에서 고정 크기 배열 멤버를 만드는 방법을 보여준다. ▶ 예제 코드 (C#)


using System;
using System.Runtime.InteropServices;

/// <summary>
/// 커스텀 구조체
/// </summary>
[StructLayout(LayoutKind.Sequential)]
public struct CustomStructure
{
    //////////////////////////////////////////////////////////////////////////////////////////////////// Field
    ////////////////////////////////////////////////////////////////////////////////////////// Public

    #region Field

    /// <summary>
    /// 문자 배열
    /// </summary>
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 100)]
    public char[] CharacterArray;

    /// <summary>
    /// 문자열
    /// </summary>
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 50)]
    public string String;

    #endregion
}

CustomStructure structure = new CustomStructure();

Console.WriteLine(Marshal.SizeOf(structure));

using System;

using System.Runtime.InteropServices;

/// <summary>

/// 커스텀 구조체

/// </summary>

[StructLayout(LayoutKind.Sequential)]

public struct CustomStructure

{

//////////////////////////////////////////////////////////////////////////////////////////////////// Field

////////////////////////////////////////////////////////////////////////////////////////// Public

#region Field

/// <summary>

/// 문자 배열

/// </summary>

[MarshalAs(UnmanagedType.ByValArray, SizeConst = 100)]

public char[] CharacterArray;

/// <summary>

/// 문자열

/// </summary>

[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 50)]

public string String;

#endregion

}

CustomStructure structure = new CustomStructure();

Console.WriteLine(Marshal.SizeOf(structure));

※ fixed 키워드를 사용하면 배열의

[C#/COMMON/NUNIT] ApartmentAttribute 클래스 사용하기

■ ApartmentAttribute 클래스를 사용하는 방법을 보여준다. ▶ 예제 코드 (C#)


using System.Threading;

using NUnit.Framework;

[TestFixture]
[Apartment(ApartmentState.STA)]
public class WindowHelperTest
{
    //...
}

using System.Threading;

using NUnit.Framework;

[TestFixture]

[Apartment(ApartmentState.STA)]

public class WindowHelperTest

{

//...

}

[C#/ASP.NET MVC/.NET5] TypeFilterAttribute 클래스 : 복수 역할 권한 확인 어트리뷰트 사용하기

■ TypeFilterAttribute 클래스를 사용해 복수 역할 권한 확인 어트리뷰트를 사용하는 방법을 보여준다. ▶ MultipleRoleAuthorizeAttribute.cs


using Microsoft.AspNetCore.Mvc;

namespace TestServer.Tools
{
    /// <summary>
    /// 복수 역할 권한 확인 어트리브튜
    /// </summary>
    public class MultipleRoleAuthorizeAttribute : TypeFilterAttribute
    {
        //////////////////////////////////////////////////////////////////////////////////////////////////// Constructor
        ////////////////////////////////////////////////////////////////////////////////////////// Public

        #region 생성자 - MultipleRoleAuthorizeAttribute(policyList, applyAnd)

        /// <summary>
        /// 생성자
        /// </summary>
        /// <param name="policyList">정책 리스트</param>
        /// <param name="applyAnd">AND 적용 여부</param>
        public MultipleRoleAuthorizeAttribute(string policyList, bool applyAnd = false) : base(typeof(MultipleRoleAuthorizeFilter))
        {
            Arguments = new object[] { policyList, applyAnd };
        }

        #endregion
    }
}

using Microsoft.AspNetCore.Mvc;

namespace TestServer.Tools

{

/// <summary>

/// 복수 역할 권한 확인 어트리브튜

/// </summary>

public class MultipleRoleAuthorizeAttribute : TypeFilterAttribute

{

//////////////////////////////////////////////////////////////////////////////////////////////////// Constructor

////////////////////////////////////////////////////////////////////////////////////////// Public

#region 생성자 - MultipleRoleAuthorizeAttribute(policyList, applyAnd)

/// <summary>

/// 생성자

/// </summary>

/// <param name="policyList">정책 리스트</param>

/// <param name="applyAnd">AND 적용 여부</param>

public MultipleRoleAuthorizeAttribute(string policyList, bool applyAnd = false) : base(typeof(MultipleRoleAuthorizeFilter))

{

Arguments = new object[] { policyList, applyAnd };

}

#endregion

}

▶ MultipleRoleAuthorizeFilter.cs


using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.Filters;

namespace TestServer.Tools
{
    /// <summary>
    /// 복수 역할 권한 확인 필터
    /// </summary>
    public class MultipleRoleAuthorizeFilter : IAsyncAuthorizationFilter
    {
        //////////////////////////////////////////////////////////////////////////////////////////////////// Field
        ////////////////////////////////////////////////////////////////////////////////////////// Private

        #region Field

        /// <summary>
        /// 권한 서비스
        /// </summary>
        private readonly IAuthorizationService authorizationService;

        #endregion

        //////////////////////////////////////////////////////////////////////////////////////////////////// Property
        ////////////////////////////////////////////////////////////////////////////////////////// Public

        #region 정책 리스트 - PolicyList

        /// <summary>
        /// 정책 리스트
        /// </summary>
        public string PolicyList { get; private set; }

        #endregion
        #region AND 적용 여부 - ApplyAnd

        /// <summary>
        /// AND 적용 여부
        /// </summary>
        public bool ApplyAnd { get; private set; }

        #endregion

        //////////////////////////////////////////////////////////////////////////////////////////////////// Constructor
        ////////////////////////////////////////////////////////////////////////////////////////// Public

        #region 생성자 - MultipleRoleAuthorizeFilter(policyList, applyAnd, authorizationService)

        /// <summary>
        /// 생성자
        /// </summary>
        /// <param name="policyList">정책 리스트</param>
        /// <param name="applyAnd">AND 적용 여부</param>
        /// <param name="authorizationService">권한 서비스</param>
        public MultipleRoleAuthorizeFilter(string policyList, bool applyAnd, IAuthorizationService authorizationService)
        {
           this.authorizationService = authorizationService;

           PolicyList = policyList;
           ApplyAnd   = applyAnd;
        }

        #endregion

        //////////////////////////////////////////////////////////////////////////////////////////////////// Method
        ////////////////////////////////////////////////////////////////////////////////////////// Public

        #region 권한 확인시 처리하기 (비동기) - OnAuthorizationAsync(context)

        /// <summary>
        /// 권한 확인시 처리하기 (비동기)
        /// </summary>
        /// <param name="context">컨텍스트</param>
        /// <returns>태스크</returns>
        public async Task OnAuthorizationAsync(AuthorizationFilterContext context)
        {
            List<string> list = PolicyList.Split(";").ToList();

            if(ApplyAnd)
            {
                foreach(string policy in list)
                {
                    AuthorizationResult result = await authorizationService.AuthorizeAsync(context.HttpContext.User, policy);

                    if(!result.Succeeded)
                    {
                        context.Result = new UnauthorizedResult(); // new ForbidResult();

                        return;
                    }

                }
             }
             else
             {
                foreach(string policy in list)
                {
                     AuthorizationResult result = await authorizationService.AuthorizeAsync(context.HttpContext.User, policy);

                     if(result.Succeeded)
                     {
                         return;
                     }

                }

                context.Result = new UnauthorizedResult(); // new ForbidResult();

                return;
            }
        }

        #endregion
    }
}

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

using System.Collections.Generic;

using System.Linq;

using System.Threading.Tasks;

using Microsoft.AspNetCore.Authorization;

using Microsoft.AspNetCore.Mvc;

using Microsoft.AspNetCore.Mvc.Filters;

namespace TestServer.Tools

{

/// <summary>

/// 복수 역할 권한 확인 필터

/// </summary>

public class MultipleRoleAuthorizeFilter : IAsyncAuthorizationFilter

{

//////////////////////////////////////////////////////////////////////////////////////////////////// Field

////////////////////////////////////////////////////////////////////////////////////////// Private

#region Field

/// <summary>

/// 권한 서비스

/// </summary>

private readonly IAuthorizationService authorizationService;

#endregion

//////////////////////////////////////////////////////////////////////////////////////////////////// Property

////////////////////////////////////////////////////////////////////////////////////////// Public

#region 정책 리스트 - PolicyList

/// <summary>

/// 정책 리스트

/// </summary>

public string PolicyList { get; private set; }

#endregion

#region AND 적용 여부 - ApplyAnd

/// <summary>

/// AND 적용 여부

/// </summary>

public bool ApplyAnd { get; private set; }

#endregion

//////////////////////////////////////////////////////////////////////////////////////////////////// Constructor

////////////////////////////////////////////////////////////////////////////////////////// Public

#region 생성자 - MultipleRoleAuthorizeFilter(policyList, applyAnd, authorizationService)

/// <summary>

/// 생성자

/// </summary>

/// <param name="policyList">정책 리스트</param>

/// <param name="applyAnd">AND 적용 여부</param>

/// <param name="authorizationService">권한 서비스</param>

public MultipleRoleAuthorizeFilter(string policyList, bool applyAnd, IAuthorizationService authorizationService)

{

this.authorizationService = authorizationService;

PolicyList = policyList;

ApplyAnd = applyAnd;

}

#endregion

//////////////////////////////////////////////////////////////////////////////////////////////////// Method

////////////////////////////////////////////////////////////////////////////////////////// Public

#region 권한 확인시 처리하기 (비동기) - OnAuthorizationAsync(context)

/// <summary>

/// 권한 확인시 처리하기 (비동기)

/// </summary>

/// <param name="context">컨텍스트</param>

/// <returns>태스크</returns>

public async Task OnAuthorizationAsync(AuthorizationFilterContext context)

{

List<string> list = PolicyList.Split(";").ToList();

if(ApplyAnd)

{

foreach(string policy in list)

{

AuthorizationResult result = await authorizationService.AuthorizeAsync(context.HttpContext.User, policy);

if(!result.Succeeded)

{

context.Result = new UnauthorizedResult(); // new ForbidResult();

return;

}

else

{

foreach(string policy in list)

{

AuthorizationResult result = await authorizationService.AuthorizeAsync(context.HttpContext.User, policy);

if(result.Succeeded)

{

return;

}

context.Result = new UnauthorizedResult(); // new ForbidResult();

return;

}

#endregion

}

[C#/COMMON] TargetFrameworkAttribute 클래스 : 닷넷 프레임워크 파일 여부 구하기

■ TargetFrameworkAttribute 클래스를 사용해 닷넷 프레임워크 파일 여부를 구하는 방법을 보여준다. ▶ TargetFrameworkAttribute 클래스 : 닷넷 프레임워크 파일 여부 구하기 예제 (C#)

[C#/COMMON] GuidAttribute 클래스 : 프로젝트의 COM 노출 GUID 구하기

■ GuidAttribute 클래스를 사용해 프로젝트의 COM 노출 GUID를 구하는 방법을 보여준다. ▶ 예제 코드 (C#)


using System;
using System.Reflection;
using System.Runtime.InteropServices;
Assembly assembly = Assembly.GetExecutingAssembly();

GuidAttribute attribute = assembly.GetCustomAttributes(typeof(GuidAttribute),true)[0] as GuidAttribute;

string guid = attribute.Value;

Console.WriteLine(guid);

using System;

using System.Reflection;

using System.Runtime.InteropServices;

Assembly assembly = Assembly.GetExecutingAssembly();

GuidAttribute attribute = assembly.GetCustomAttributes(typeof(GuidAttribute),true)[0] as GuidAttribute;

string guid = attribute.Value;

Console.WriteLine(guid);

[C#/ASP.NET MVC/.NETCORE] ActionFilterAttribute 클래스 : 액션 필터 만들기

■ ActionFilterAttribute 클래스를 사용해 액션 필터를 만드는 방법을 보여준다. ▶ SessionCheckActionFilterAttribute.cs


using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.Filters;
using Microsoft.AspNetCore.Routing;

namespace TestProject
{
    /// <summary>
    /// 세션 체크 액션 필터 어트리뷰트
    /// </summary>
    public class SessionCheckActionFilterAttribute : ActionFilterAttribute
    {
        //////////////////////////////////////////////////////////////////////////////////////////////////// Method
        ////////////////////////////////////////////////////////////////////////////////////////// Public

        #region 액션 실행시 처리하기 - OnActionExecuting(context)

        /// <summary>
        /// 액션 실행시 처리하기
        /// </summary>
        /// <param name="context">컨텍스트</param>
        public override void OnActionExecuting(ActionExecutingContext context)
        {
            if(context.HttpContext.Session.GetString("Name") == null)
            {
                context.Result = new RedirectToRouteResult
                (
                    new RouteValueDictionary
                    (
                        new
                        {
                            action     = "Index",
                            controller = "Home"
                        }
                    )
                );
            }

            base.OnActionExecuting(context);
        }

        #endregion
    }
}

using Microsoft.AspNetCore.Http;

using Microsoft.AspNetCore.Mvc;

using Microsoft.AspNetCore.Mvc.Filters;

using Microsoft.AspNetCore.Routing;

namespace TestProject

{

/// <summary>

/// 세션 체크 액션 필터 어트리뷰트

/// </summary>

public class SessionCheckActionFilterAttribute : ActionFilterAttribute

{

//////////////////////////////////////////////////////////////////////////////////////////////////// Method

////////////////////////////////////////////////////////////////////////////////////////// Public

#region 액션 실행시 처리하기 - OnActionExecuting(context)

/// <summary>

/// 액션 실행시 처리하기

/// </summary>

/// <param name="context">컨텍스트</param>

public override void OnActionExecuting(ActionExecutingContext context)

{

if(context.HttpContext.Session.GetString("Name") == null)

{

context.Result = new RedirectToRouteResult

(

new RouteValueDictionary

(

new

{

action = "Index",

controller = "Home"

}

)

);

}

base.OnActionExecuting(context);

}

#endregion

}

▶ Controllers/HomeController.cs


using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;

namespace TestProject.Controllers
{
    /// <summary>
    /// 홈 컨트롤러
    /// </summary>
    public class HomeController : Controller
    {
        //////////////////////////////////////////////////////////////////////////////////////////////////// Method
        ////////////////////////////////////////////////////////////////////////////////////////// Public

        #region 인덱스 페이지 처리하기 - Index()

        /// <summary>
        /// 인덱스 페이지 처리하기
        /// </summary>
        /// <returns>액션 결과</returns>
        public IActionResult Index()
        {
            HttpContext.Session.SetString("Name", "James");

            return View();
        }

        #endregion
        #region 개인 페이지 처리하기 - Private()

        /// <summary>
        /// 개인 페이지 처리하기
        /// </summary>
        /// <returns>액션 결과</returns>
        [SessionCheckActionFilter]
        public IActionResult Private()
        {
            return View();
        }

        #endregion
    }
}

using Microsoft.AspNetCore.Http;

using Microsoft.AspNetCore.Mvc;

namespace TestProject.Controllers

{

/// <summary>

/// 홈 컨트롤러

/// </summary>

public class HomeController : Controller

{

//////////////////////////////////////////////////////////////////////////////////////////////////// Method

////////////////////////////////////////////////////////////////////////////////////////// Public

#region 인덱스 페이지 처리하기 - Index()

/// <summary>

/// 인덱스 페이지 처리하기

/// </summary>

/// <returns>액션 결과</returns>

public IActionResult Index()

{

HttpContext.Session.SetString("Name", "James");

return View();

}

#endregion

#region 개인 페이지 처리하기 - Private()

/// <summary>

/// 개인 페이지 처리하기

/// </summary>

/// <returns>액션 결과</returns>

[SessionCheckActionFilter]

public IActionResult Private()

{

return View();

}

#endregion

}

▶ Views/Home/Index.cshtml


<p>인덱스 페이지</p>
<hr />

인덱스 페이지

<hr />

▶ Views/Home/Private.cshtml


@using Microsoft.AspNetCore.Http
<p>개인 페이지</p>
<hr />
<p>@Context.Session.GetString("Name")</p>

@using Microsoft.AspNetCore.Http

개인 페이지

<hr />

@Context.Session.GetString("Name")

▶

[C#/ASP.NET MVC/.NETCORE] FromServicesAttribute 클래스 : 메소드 의존성 주입 만들기

■ FromServicesAttribute 클래스를 사용해 메소드 의존성 주입을 만드는 방법을 보여준다. ▶ HomeController.cs


using Microsoft.AspNetCore.Authentication;
using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.Mvc;
using System.Collections.Generic;
using System.Security.Claims;
using System.Threading.Tasks;

namespace TestProject.Controllers
{
    /// <summary>
    /// 홈 컨트롤러
    /// </summary>
    public class HomeController : Controller
    {
        //////////////////////////////////////////////////////////////////////////////////////////////////// Method
        ////////////////////////////////////////////////////////////////////////////////////////// Public

        #region 인덱스 페이지 처리하기 - Index()

        /// <summary>
        /// 인덱스 페이지 처리하기
        /// </summary>
        /// <returns>액션 결과</returns>
        public IActionResult Index()
        {
            return View();
        }

        #endregion
        #region 비밀 페이지 처리하기 - Secret()

        /// <summary>
        /// 비밀 페이지 처리하기
        /// </summary>
        /// <returns>액션 결과</returns>
        [Authorize]
        public IActionResult Secret()
        {
            return View();
        }

        #endregion
        #region 관리자 페이지 처리하기 - Administrator(authorizationService)

        /// <summary>
        /// 관리자 페이지 처리하기
        /// </summary>
        /// <param name="authorizationService">권한 서비스</param>
        /// <returns>액션 결과</returns>
        public async Task<IActionResult> Administrator([FromServices] IAuthorizationService authorizationService)
        {
            AuthorizationPolicyBuilder builder = new AuthorizationPolicyBuilder("Schema");

            AuthorizationPolicy policy = builder.RequireClaim(ClaimTypes.Role, "Administrator").Build();

            AuthorizationResult result = await authorizationService.AuthorizeAsync(User, policy);

            if(!result.Succeeded)
            {
                return Forbid();
            }

            return View();
        }

        #endregion
        #region 로그인 페이지 처리하기 - Login(returnURL)

        /// <summary>
        /// 로그인 페이지 처리하기
        /// </summary>
        /// <param name="returnURL">반환 URL</param>
        /// <returns>액션 결과</returns>
        [HttpGet]
        public IActionResult Login(string returnURL = null)
        {
            ViewData["ReturnURL"] = returnURL;

            return View();
        }

        #endregion
        #region 로그인 페이지 처리하기 - Login(userName, password, returnURL)

        /// <summary>
        /// 로그인 페이지 처리하기
        /// </summary>
        /// <param name="userName">사용자명</param>
        /// <param name="password">패스워드</param>
        /// <param name="returnURL">반환 URL</param>
        /// <returns>액션 결과</returns>
        [HttpPost]
        public async Task<IActionResult> Login(string userName, string password, string returnURL)
        {
            if(userName == "홍길동" && password == "1234")
            {
                List<Claim> personClaimList = new List<Claim>()
                {
                    new Claim(ClaimTypes.Name       , "홍길동"        ),
                    new Claim(ClaimTypes.Gender     , "남성"          ),
                    new Claim(ClaimTypes.DateOfBirth, "2000-01-01"    ),
                    new Claim(ClaimTypes.HomePhone  , "02-700-1000"   ),
                    new Claim(ClaimTypes.MobilePhone, "010-3000-4000" ),
                    new Claim(ClaimTypes.Email      , "hkd@daum.net"  ),
                    new Claim(ClaimTypes.Country    , "한국"          ),
                    new Claim(ClaimTypes.PostalCode , "300-400"       ),
                    new Claim(ClaimTypes.Role       , "User"          )
                };

                List<Claim> licenseClaimList = new List<Claim>()
                {
                    new Claim(ClaimTypes.Name , "홍길동"),
                    new Claim("License"       , "1급"   )
                };

                ClaimsIdentity personClaimsIdentity  = new ClaimsIdentity(personClaimList , "개인");
                ClaimsIdentity licenseClaimsIdentity = new ClaimsIdentity(licenseClaimList, "정부");

                ClaimsPrincipal claimsPrincipal = new ClaimsPrincipal
                (
                    new []
                    {
                        personClaimsIdentity,
                        licenseClaimsIdentity
                    }
                );

                await HttpContext.SignInAsync("CookieAuthentication", claimsPrincipal);

                if(returnURL == null)
                {
                    return RedirectToAction("Index");
                }
                else
                {
                    return Redirect(returnURL);
                }
            }
            else
            {
                ViewData["Message"] = "등록되지 않은 사용자 입니다.";

                return View();
            }
        }

        #endregion
        #region 로그아웃 페이지 처리하기 - Logout()

        /// <summary>
        /// 로그아웃 페이지 처리하기
        /// </summary>
        /// <returns>액션 결과 태스크</returns>
        public async Task<IActionResult> Logout()
        {
            await HttpContext.SignOutAsync("CookieAuthentication");

            return RedirectToAction("Index");
        }

        #endregion
        #region 권한 없음 페이지 처리하기 - NoAuthorized()

        /// <summary>
        /// 권한 없음 페이지 처리하기
        /// </summary>
        /// <returns>액션 결과</returns>
        public IActionResult NoAuthorized()
        {
            return View();
        }

        #endregion
    }
}

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

using Microsoft.AspNetCore.Authentication;

using Microsoft.AspNetCore.Authorization;

using Microsoft.AspNetCore.Mvc;

using System.Collections.Generic;

using System.Security.Claims;

using System.Threading.Tasks;

namespace TestProject.Controllers

{

/// <summary>

/// 홈 컨트롤러

/// </summary>

public class HomeController : Controller

{

//////////////////////////////////////////////////////////////////////////////////////////////////// Method

////////////////////////////////////////////////////////////////////////////////////////// Public

#region 인덱스 페이지 처리하기 - Index()

/// <summary>

/// 인덱스 페이지 처리하기

/// </summary>

/// <returns>액션 결과</returns>

public IActionResult Index()

{

return View();

}

#endregion

#region 비밀 페이지 처리하기 - Secret()

/// <summary>

/// 비밀 페이지 처리하기

/// </summary>

/// <returns>액션 결과</returns>

[Authorize]

public IActionResult Secret()

{

return View();

}

#endregion

#region 관리자 페이지 처리하기 - Administrator(authorizationService)

/// <summary>

/// 관리자 페이지 처리하기

/// </summary>

/// <param name="authorizationService">권한 서비스</param>

/// <returns>액션 결과</returns>

public async Task<IActionResult> Administrator([FromServices] IAuthorizationService authorizationService)

{

AuthorizationPolicyBuilder builder = new AuthorizationPolicyBuilder("Schema");

AuthorizationPolicy policy = builder.RequireClaim(ClaimTypes.Role, "Administrator").Build();

AuthorizationResult result = await authorizationService.AuthorizeAsync(User, policy);

if(!result.Succeeded)

{

return Forbid();

}

return View();

}

#endregion

#region 로그인 페이지 처리하기 - Login(returnURL)

/// <summary>

/// 로그인 페이지 처리하기

/// </summary>

/// <param name="returnURL">반환 URL</param>

/// <returns>액션 결과</returns>

[HttpGet]

public IActionResult Login(string returnURL = null)

{

ViewData["ReturnURL"] = returnURL;

return View();

}

#endregion

#region 로그인 페이지 처리하기 - Login(userName, password, returnURL)

/// <summary>

/// 로그인 페이지 처리하기

/// </summary>

/// <param name="userName">사용자명</param>

/// <param name="password">패스워드</param>

/// <param name="returnURL">반환 URL</param>

/// <returns>액션 결과</returns>

[HttpPost]

public async Task<IActionResult> Login(string userName, string password, string returnURL)

{

if(userName == "홍길동" && password == "1234")

{

List<Claim> personClaimList = new List<Claim>()

{

new Claim(ClaimTypes.Name , "홍길동" ),

new Claim(ClaimTypes.Gender , "남성" ),

new Claim(ClaimTypes.DateOfBirth, "2000-01-01" ),

new Claim(ClaimTypes.HomePhone , "02-700-1000" ),

new Claim(ClaimTypes.MobilePhone, "010-3000-4000" ),

new Claim(ClaimTypes.Email , "hkd@daum.net" ),

new Claim(ClaimTypes.Country , "한국" ),

new Claim(ClaimTypes.PostalCode , "300-400" ),

new Claim(ClaimTypes.Role , "User" )

};

List<Claim> licenseClaimList = new List<Claim>()

{

new Claim(ClaimTypes.Name , "홍길동"),

new Claim("License" , "1급" )

};

ClaimsIdentity personClaimsIdentity = new ClaimsIdentity(personClaimList , "개인");

ClaimsIdentity licenseClaimsIdentity = new ClaimsIdentity(licenseClaimList, "정부");

ClaimsPrincipal claimsPrincipal = new ClaimsPrincipal

(

new []

{

personClaimsIdentity,

licenseClaimsIdentity

}

);

await HttpContext.SignInAsync("CookieAuthentication", claimsPrincipal);

if(returnURL == null)

{

return RedirectToAction("Index");

}

else

{

return Redirect(returnURL);

}

else

{

ViewData["Message"] = "등록되지 않은 사용자 입니다.";

return View();

}

#endregion

#region 로그아웃 페이지 처리하기 - Logout()

/// <summary>

/// 로그아웃 페이지 처리하기

/// </summary>

/// <returns>액션 결과 태스크</returns>

public async Task<IActionResult> Logout()

{

await HttpContext.SignOutAsync("CookieAuthentication");

return RedirectToAction("Index");

}

#endregion

#region 권한 없음 페이지 처리하기 - NoAuthorized()

/// <summary>

/// 권한 없음 페이지 처리하기

/// </summary>

/// <returns>액션 결과</returns>

public IActionResult NoAuthorized()

{

return View();

}

#endregion

}