DreamineCommandAttribute가 적용된 메서드를 기반으로 커맨드 프로퍼티와 forwarding 메서드 구현을 생성하는 증분 생성기입니다. 더 자세히 ...

Dreamine.MVVM.Generators.DreamineCommandSourceGenerator에 대한 상속 다이어그램 :

Dreamine.MVVM.Generators.DreamineCommandSourceGenerator에 대한 협력 다이어그램:

클래스
class	CommandCandidateModel
	생성 대상 메서드 메타데이터를 나타냅니다. 더 자세히 ...

Public 멤버 함수
void	Initialize (IncrementalGeneratorInitializationContext context)
	증분 생성기 파이프라인을 초기화합니다.

정적 Private 멤버 함수
static ? CommandCandidateModel	TryCreateCandidate (GeneratorSyntaxContext context, INamedTypeSymbol? attributeSymbol)
	구문/시맨틱 정보를 기반으로 생성 후보를 구성합니다.
static void	Emit (SourceProductionContext context, ImmutableArray< CommandCandidateModel > candidates)
	수집된 후보를 진단하고 소스를 생성합니다.
static List< Diagnostic >	ValidateCandidate (CommandCandidateModel candidate)
	후보의 유효성을 검증합니다.
static bool	IsPartialMethod (MethodDeclarationSyntax methodSyntax)
	partial 메서드 여부를 확인합니다.
static bool	IsContainingTypePartial (INamedTypeSymbol typeSymbol)
	containing type이 partial인지 확인합니다.
static bool	IsParameterlessVoidMethod (IMethodSymbol methodSymbol)
	메서드가 parameterless void 형식인지 확인합니다.
static bool	HasConflictingMember (INamedTypeSymbol typeSymbol, string memberName)
	같은 이름의 멤버가 이미 존재하는지 확인합니다.
static bool	HasValidCanExecuteMethod (INamedTypeSymbol typeSymbol, string methodName)
static string	BuildCommandPropertyName (string methodName, string? commandNameOverride)
	생성할 커맨드 프로퍼티 이름을 결정합니다.
static string	BuildFileName (CommandCandidateModel candidate)
	생성 파일 이름을 만듭니다.
static string	BuildSource (CommandCandidateModel candidate)
	생성 코드를 만듭니다.
static string	GetMethodSignatureWithoutAttributes (MethodDeclarationSyntax methodSyntax)
	원본 메서드에서 Attribute와 본문을 제거한 시그니처를 만듭니다.
static ? string	GetConstructorStringArgument (AttributeData attribute, int index)
	생성자 문자열 인자를 가져옵니다.
static ? string	GetNamedStringArgument (AttributeData attribute, string name)
	named argument 문자열 값을 가져옵니다.
static string	NormalizeInvocation (string targetMethod)
	TargetMethod 문자열을 호출 형태로 정규화합니다.
static List< INamedTypeSymbol >	GetContainingTypeChain (INamedTypeSymbol innerMostType)
	바깥 타입부터 안쪽 타입까지의 체인을 반환합니다.
static string	GetTypeDeclarationHeader (INamedTypeSymbol typeSymbol)
	partial 타입 선언 헤더를 생성합니다.
static string	Sanitize (string name)
	파일명에 안전한 형태로 문자열을 정리합니다.
static string	ToCamel (string name)
	PascalCase 문자열을 camelCase로 변환합니다.

정적 Private 속성
const string	DreamineCommandAttributeMetadataName = "Dreamine.MVVM.Attributes.DreamineCommandAttribute"
static readonly DiagnosticDescriptor	MethodMustBePartialDescriptor
static readonly DiagnosticDescriptor	ContainingTypeMustBePartialDescriptor
static readonly DiagnosticDescriptor	MethodMustBeParameterlessVoidDescriptor
static readonly DiagnosticDescriptor	CommandNameConflictDescriptor
static readonly DiagnosticDescriptor	CanExecuteMethodNotFoundDescriptor

상세한 설명

DreamineCommandAttribute가 적용된 메서드를 기반으로 커맨드 프로퍼티와 forwarding 메서드 구현을 생성하는 증분 생성기입니다.

DreamineCommandSourceGenerator.cs 파일의 18 번째 라인에서 정의되었습니다.

멤버 함수 문서화

◆ BuildCommandPropertyName()

string Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.BuildCommandPropertyName	(	string	methodName,
		string?	commandNameOverride )

inlinestaticprivate

생성할 커맨드 프로퍼티 이름을 결정합니다.

매개변수

methodName	원본 메서드 이름입니다.
commandNameOverride	명시적으로 지정한 커맨드 이름입니다.

반환값: 생성할 커맨드 프로퍼티 이름입니다.

DreamineCommandSourceGenerator.cs 파일의 297 번째 라인에서 정의되었습니다.

        {
            if (!string.IsNullOrWhiteSpace(commandNameOverride))
            {
                return commandNameOverride!;
            }
 
            return methodName + "Command";
        }

다음에 의해서 참조됨 : TryCreateCandidate().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ BuildFileName()

string Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.BuildFileName ( CommandCandidateModel candidate )

inlinestaticprivate

생성 파일 이름을 만듭니다.

매개변수

candidate 대상 후보입니다.

반환값: 생성 파일 이름입니다.

DreamineCommandSourceGenerator.cs 파일의 312 번째 라인에서 정의되었습니다.

        {
            string namespaceName = candidate.MethodSymbol.ContainingNamespace.IsGlobalNamespace
                ? "Global"
                : Sanitize(candidate.MethodSymbol.ContainingNamespace.ToDisplayString());
 
            string typeName = string.Join("_", GetContainingTypeChain(candidate.MethodSymbol.ContainingType).Select(type => type.Name));
            string methodName = candidate.MethodSymbol.Name;
 
            return namespaceName + "_" + typeName + "_" + methodName + "_DreamineCommand.g.cs";
        }

다음을 참조함 : GetContainingTypeChain(), Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.CommandCandidateModel.MethodSymbol, Sanitize().

다음에 의해서 참조됨 : Emit().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ BuildSource()

string Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.BuildSource ( CommandCandidateModel candidate )

inlinestaticprivate

생성 코드를 만듭니다.

매개변수

candidate 생성 대상 후보입니다.

반환값: 생성된 C# 소스 문자열입니다.

DreamineCommandSourceGenerator.cs 파일의 329 번째 라인에서 정의되었습니다.

        {
            string namespaceName = candidate.MethodSymbol.ContainingNamespace.IsGlobalNamespace
                ? string.Empty
                : candidate.MethodSymbol.ContainingNamespace.ToDisplayString();
 
            List<INamedTypeSymbol> typeChain = GetContainingTypeChain(candidate.MethodSymbol.ContainingType);
            string commandFieldName = "_" + ToCamel(candidate.CommandPropertyName);
            string helperTypeName = "__DreamineGeneratedCommand_" + candidate.MethodSymbol.Name;
            bool hasTargetMethod = !string.IsNullOrWhiteSpace(candidate.TargetMethod);
            string? normalizedInvocation = hasTargetMethod
                ? NormalizeInvocation(candidate.TargetMethod!)
                : null;
 
            StringBuilder builder = new StringBuilder();
            builder.AppendLine("// <auto-generated />");
            builder.AppendLine("#nullable enable");
            builder.AppendLine("using System;");
            builder.AppendLine("using System.Windows.Input;");
            builder.AppendLine();
 
            if (!string.IsNullOrWhiteSpace(namespaceName))
            {
                builder.AppendLine("namespace " + namespaceName);
                builder.AppendLine("{");
            }
 
            for (int i = 0; i < typeChain.Count; i++)
            {
                string indent = new string(' ', 4 * (i + 1));
                builder.AppendLine(indent + GetTypeDeclarationHeader(typeChain[i]));
                builder.AppendLine(indent + "{");
            }
 
            string memberIndent = new string(' ', 4 * (typeChain.Count + 1));
 
            builder.AppendLine(memberIndent + "/// <summary>");
            builder.AppendLine(memberIndent + "/// 생성된 ICommand 프로퍼티입니다.");
            builder.AppendLine(memberIndent + "/// </summary>");
            builder.AppendLine(memberIndent + "private ICommand? " + commandFieldName + ";");
            string ctorArgs = !string.IsNullOrWhiteSpace(candidate.CanExecuteMethod)
                ? candidate.MethodSymbol.Name + ", " + candidate.CanExecuteMethod
                : candidate.MethodSymbol.Name;
            builder.AppendLine(memberIndent + "public ICommand " + candidate.CommandPropertyName + " => " + commandFieldName + " ??= new " + helperTypeName + "(" + ctorArgs + ");");
            builder.AppendLine();
 
            bool hasBody = candidate.MethodSyntax.Body is not null || candidate.MethodSyntax.ExpressionBody is not null;
            if (hasTargetMethod && !hasBody)
            {
                builder.AppendLine(memberIndent + GetMethodSignatureWithoutAttributes(candidate.MethodSyntax));
                builder.AppendLine(memberIndent + "{");
 
                if (!string.IsNullOrWhiteSpace(candidate.BindTo))
                {
                    builder.AppendLine(memberIndent + "    var __result = " + normalizedInvocation + ";");
                    builder.AppendLine(memberIndent + "    " + candidate.BindTo + " = __result;");
                }
                else
                {
                    builder.AppendLine(memberIndent + "    " + normalizedInvocation + ";");
                }
 
                builder.AppendLine(memberIndent + "}");
                builder.AppendLine();
            }
 
            bool hasCanExecute = !string.IsNullOrWhiteSpace(candidate.CanExecuteMethod);
 
            builder.AppendLine(memberIndent + "private sealed class " + helperTypeName + " : ICommand");
            builder.AppendLine(memberIndent + "{");
            builder.AppendLine(memberIndent + "    private readonly Action _execute;");
            if (hasCanExecute)
            {
                builder.AppendLine(memberIndent + "    private readonly Func<bool> _canExecute;");
                builder.AppendLine(memberIndent + "    public " + helperTypeName + "(Action execute, Func<bool> canExecute)");
                builder.AppendLine(memberIndent + "    {");
                builder.AppendLine(memberIndent + "        _execute = execute ?? throw new ArgumentNullException(nameof(execute));");
                builder.AppendLine(memberIndent + "        _canExecute = canExecute ?? throw new ArgumentNullException(nameof(canExecute));");
                builder.AppendLine(memberIndent + "    }");
            }
            else
            {
                builder.AppendLine(memberIndent + "    public " + helperTypeName + "(Action execute)");
                builder.AppendLine(memberIndent + "    {");
                builder.AppendLine(memberIndent + "        _execute = execute ?? throw new ArgumentNullException(nameof(execute));");
                builder.AppendLine(memberIndent + "    }");
            }
 
            builder.AppendLine(memberIndent + "    public event EventHandler? CanExecuteChanged;");
            builder.AppendLine(memberIndent + "    public void RaiseCanExecuteChanged() => CanExecuteChanged?.Invoke(this, EventArgs.Empty);");
            if (hasCanExecute)
            {
                builder.AppendLine(memberIndent + "    public bool CanExecute(object? parameter) => _canExecute();");
            }
            else
            {
                builder.AppendLine(memberIndent + "    public bool CanExecute(object? parameter) => true;");
            }
 
            builder.AppendLine(memberIndent + "    public void Execute(object? parameter) => _execute();");
            builder.AppendLine(memberIndent + "}");
            builder.AppendLine();
 
            for (int i = typeChain.Count - 1; i >= 0; i--)
            {
                string indent = new string(' ', 4 * (i + 1));
                builder.AppendLine(indent + "}");
            }
 
            if (!string.IsNullOrWhiteSpace(namespaceName))
            {
                builder.AppendLine("}");
            }
 
            return builder.ToString();
        }

다음을 참조함 : Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.CommandCandidateModel.BindTo, Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.CommandCandidateModel.CanExecuteMethod, Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.CommandCandidateModel.CommandPropertyName, GetContainingTypeChain(), GetMethodSignatureWithoutAttributes(), GetTypeDeclarationHeader(), Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.CommandCandidateModel.MethodSymbol, Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.CommandCandidateModel.MethodSyntax, NormalizeInvocation(), Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.CommandCandidateModel.TargetMethod, ToCamel().

다음에 의해서 참조됨 : Emit().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ Emit()

void Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.Emit	(	SourceProductionContext	context,
		ImmutableArray< CommandCandidateModel >	candidates )

inlinestaticprivate

수집된 후보를 진단하고 소스를 생성합니다.

매개변수

context	소스 출력 컨텍스트입니다.
candidates	수집된 후보 목록입니다.

DreamineCommandSourceGenerator.cs 파일의 144 번째 라인에서 정의되었습니다.

        {
            if (candidates.IsDefaultOrEmpty)
            {
                return;
            }
 
            foreach (CommandCandidateModel candidate in candidates)
            {
                List<Diagnostic> diagnostics = ValidateCandidate(candidate);
                foreach (Diagnostic diagnostic in diagnostics)
                {
                    context.ReportDiagnostic(diagnostic);
                }
 
                if (diagnostics.Count > 0)
                {
                    continue;
                }
 
                string source = BuildSource(candidate);
                string fileName = BuildFileName(candidate);
 
                context.AddSource(fileName, SourceText.From(source, Encoding.UTF8));
            }
        }

다음을 참조함 : BuildFileName(), BuildSource(), ValidateCandidate().

다음에 의해서 참조됨 : Initialize().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ GetConstructorStringArgument()

? string Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.GetConstructorStringArgument	(	AttributeData	attribute,
		int	index )

inlinestaticprivate

생성자 문자열 인자를 가져옵니다.

매개변수

attribute	검사할 Attribute 데이터입니다.
index	가져올 생성자 인덱스입니다.

반환값: 값이 있으면 문자열을 반환하고, 아니면 null을 반환합니다.

DreamineCommandSourceGenerator.cs 파일의 468 번째 라인에서 정의되었습니다.

        {
            if (attribute.ConstructorArguments.Length <= index)
            {
                return null;
            }
 
            return attribute.ConstructorArguments[index].Value?.ToString();
        }

다음에 의해서 참조됨 : TryCreateCandidate().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ GetContainingTypeChain()

List< INamedTypeSymbol > Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.GetContainingTypeChain ( INamedTypeSymbol innerMostType )

inlinestaticprivate

바깥 타입부터 안쪽 타입까지의 체인을 반환합니다.

매개변수

innerMostType 가장 안쪽 타입입니다.

반환값: 바깥쪽부터 정렬된 타입 체인입니다.

DreamineCommandSourceGenerator.cs 파일의 514 번째 라인에서 정의되었습니다.

        {
            Stack<INamedTypeSymbol> stack = new Stack<INamedTypeSymbol>();
            INamedTypeSymbol? current = innerMostType;
 
            while (current is not null)
            {
                stack.Push(current);
                current = current.ContainingType;
            }
 
            return stack.ToList();
        }

다음에 의해서 참조됨 : BuildFileName(), BuildSource().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ GetMethodSignatureWithoutAttributes()

string Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.GetMethodSignatureWithoutAttributes ( MethodDeclarationSyntax methodSyntax )

inlinestaticprivate

원본 메서드에서 Attribute와 본문을 제거한 시그니처를 만듭니다.

매개변수

methodSyntax 원본 메서드 구문입니다.

반환값: 생성용 메서드 시그니처 문자열입니다.

DreamineCommandSourceGenerator.cs 파일의 451 번째 라인에서 정의되었습니다.

        {
            MethodDeclarationSyntax withoutBody = methodSyntax
                .WithAttributeLists(default)
                .WithBody(null)
                .WithExpressionBody(null)
                .WithSemicolonToken(default);
 
            return withoutBody.NormalizeWhitespace().ToFullString();
        }

다음에 의해서 참조됨 : BuildSource().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ GetNamedStringArgument()

? string Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.GetNamedStringArgument	(	AttributeData	attribute,
		string	name )

inlinestaticprivate

named argument 문자열 값을 가져옵니다.

매개변수

attribute	검사할 Attribute 데이터입니다.
name	찾을 인자 이름입니다.

반환값: 값이 있으면 문자열을 반환하고, 아니면 null을 반환합니다.

DreamineCommandSourceGenerator.cs 파일의 484 번째 라인에서 정의되었습니다.

        {
            return attribute.NamedArguments
                .Where(argument => string.Equals(argument.Key, name, StringComparison.Ordinal))
                .Select(argument => argument.Value.Value?.ToString())
                .FirstOrDefault();
        }

다음에 의해서 참조됨 : TryCreateCandidate().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ GetTypeDeclarationHeader()

string Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.GetTypeDeclarationHeader ( INamedTypeSymbol typeSymbol )

inlinestaticprivate

partial 타입 선언 헤더를 생성합니다.

매개변수

typeSymbol 대상 타입 심볼입니다.

반환값: 생성용 타입 선언 헤더입니다.

DreamineCommandSourceGenerator.cs 파일의 533 번째 라인에서 정의되었습니다.

        {
            string kind = typeSymbol.TypeKind switch
            {
                TypeKind.Class => "partial class",
                TypeKind.Struct => "partial struct",
                _ => "partial class"
            };
 
            string accessibility = typeSymbol.DeclaredAccessibility switch
            {
                Accessibility.Public => "public",
                Accessibility.Internal => "internal",
                Accessibility.Private => "private",
                Accessibility.Protected => "protected",
                Accessibility.ProtectedAndInternal => "protected internal",
                Accessibility.ProtectedOrInternal => "protected internal",
                _ => "internal"
            };
 
            string staticKeyword = typeSymbol.IsStatic ? " static" : string.Empty;
 
            string typeParameters = typeSymbol.TypeParameters.Length > 0
                ? "<" + string.Join(", ", typeSymbol.TypeParameters.Select(parameter => parameter.Name)) + ">"
                : string.Empty;
 
            return accessibility + staticKeyword + " " + kind + " " + typeSymbol.Name + typeParameters;
        }

다음에 의해서 참조됨 : BuildSource().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ HasConflictingMember()

bool Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.HasConflictingMember	(	INamedTypeSymbol	typeSymbol,
		string	memberName )

inlinestaticprivate

같은 이름의 멤버가 이미 존재하는지 확인합니다.

매개변수

typeSymbol	검사할 타입입니다.
memberName	검사할 멤버 이름입니다.

반환값: 같은 이름의 멤버가 있으면 true이고, 아니면 false입니다.

DreamineCommandSourceGenerator.cs 파일의 277 번째 라인에서 정의되었습니다.

        {
            return typeSymbol.GetMembers(memberName).Any();
        }

다음에 의해서 참조됨 : ValidateCandidate().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ HasValidCanExecuteMethod()

bool Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.HasValidCanExecuteMethod	(	INamedTypeSymbol	typeSymbol,
		string	methodName )

inlinestaticprivate

DreamineCommandSourceGenerator.cs 파일의 282 번째 라인에서 정의되었습니다.

        {
            return typeSymbol.GetMembers(methodName)
                .OfType<IMethodSymbol>()
                .Any(m => m.Parameters.Length == 0 &&
                          !m.ReturnsVoid &&
                          m.ReturnType.SpecialType == SpecialType.System_Boolean);
        }

다음에 의해서 참조됨 : ValidateCandidate().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ Initialize()

void Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.Initialize ( IncrementalGeneratorInitializationContext context )

inline

증분 생성기 파이프라인을 초기화합니다.

매개변수

context 생성기 초기화 컨텍스트입니다.

DreamineCommandSourceGenerator.cs 파일의 66 번째 라인에서 정의되었습니다.

        {
            IncrementalValueProvider<INamedTypeSymbol?> attributeSymbolProvider =
                context.CompilationProvider.Select(
                    static (compilation, _) => compilation.GetTypeByMetadataName(DreamineCommandAttributeMetadataName));
 
            IncrementalValueProvider<ImmutableArray<CommandCandidateModel>> candidateProvider =
                context.SyntaxProvider
                    .CreateSyntaxProvider(
                        predicate: static (node, _) => node is MethodDeclarationSyntax { AttributeLists.Count: > 0 },
                        transform: static (syntaxContext, _) => syntaxContext)
                    .Combine(attributeSymbolProvider)
                    .Select(static (pair, _) => TryCreateCandidate(pair.Left, pair.Right))
                    .Where(static candidate => candidate is not null)
                    .Select(static (candidate, _) => candidate!)
                    .Collect();
 
            context.RegisterSourceOutput(candidateProvider, static (sourceProductionContext, candidates) =>
            {
                Emit(sourceProductionContext, candidates);
            });
        }

다음을 참조함 : DreamineCommandAttributeMetadataName, Emit(), TryCreateCandidate().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

◆ IsContainingTypePartial()

bool Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.IsContainingTypePartial ( INamedTypeSymbol typeSymbol )

inlinestaticprivate

containing type이 partial인지 확인합니다.

매개변수

typeSymbol 검사할 타입 심볼입니다.

반환값: partial 타입이면 true이고, 아니면 false입니다.

DreamineCommandSourceGenerator.cs 파일의 245 번째 라인에서 정의되었습니다.

        {
            foreach (SyntaxReference syntaxReference in typeSymbol.DeclaringSyntaxReferences)
            {
                if (syntaxReference.GetSyntax() is TypeDeclarationSyntax typeDeclaration &&
                    typeDeclaration.Modifiers.Any(modifier => modifier.IsKind(SyntaxKind.PartialKeyword)))
                {
                    return true;
                }
            }
 
            return false;
        }

다음에 의해서 참조됨 : ValidateCandidate().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ IsParameterlessVoidMethod()

bool Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.IsParameterlessVoidMethod ( IMethodSymbol methodSymbol )

inlinestaticprivate

메서드가 parameterless void 형식인지 확인합니다.

매개변수

methodSymbol 검사할 메서드 심볼입니다.

반환값: 조건을 만족하면 true이고, 아니면 false입니다.

DreamineCommandSourceGenerator.cs 파일의 264 번째 라인에서 정의되었습니다.

        {
            return methodSymbol.Parameters.Length == 0 &&
                   methodSymbol.ReturnsVoid &&
                   !methodSymbol.IsGenericMethod;
        }

다음에 의해서 참조됨 : ValidateCandidate().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ IsPartialMethod()

bool Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.IsPartialMethod ( MethodDeclarationSyntax methodSyntax )

inlinestaticprivate

partial 메서드 여부를 확인합니다.

매개변수

methodSyntax 검사할 메서드 구문입니다.

반환값: partial 메서드이면 true이고, 아니면 false입니다.

DreamineCommandSourceGenerator.cs 파일의 235 번째 라인에서 정의되었습니다.

        {
            return methodSyntax.Modifiers.Any(modifier => modifier.IsKind(SyntaxKind.PartialKeyword));
        }

다음에 의해서 참조됨 : ValidateCandidate().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ NormalizeInvocation()

string Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.NormalizeInvocation ( string targetMethod )

inlinestaticprivate

TargetMethod 문자열을 호출 형태로 정규화합니다.

매개변수

targetMethod 원본 대상 메서드 문자열입니다.

반환값: 호출 형태로 정규화된 문자열입니다.

DreamineCommandSourceGenerator.cs 파일의 497 번째 라인에서 정의되었습니다.

        {
            string trimmed = targetMethod.Trim();
 
            if (trimmed.EndsWith(")", StringComparison.Ordinal))
            {
                return trimmed;
            }
 
            return trimmed + "()";
        }

다음에 의해서 참조됨 : BuildSource().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ Sanitize()

string Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.Sanitize ( string name )

inlinestaticprivate

파일명에 안전한 형태로 문자열을 정리합니다.

매개변수

name	원본 문자열입니다.

반환값: 정리된 문자열입니다.

DreamineCommandSourceGenerator.cs 파일의 567 번째 라인에서 정의되었습니다.

        {
            return name.Replace('.', '_').Replace('+', '_');
        }

다음에 의해서 참조됨 : BuildFileName().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ ToCamel()

string Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.ToCamel ( string name )

inlinestaticprivate

PascalCase 문자열을 camelCase로 변환합니다.

매개변수

name	변환할 문자열입니다.

반환값: camelCase 문자열입니다.

DreamineCommandSourceGenerator.cs 파일의 577 번째 라인에서 정의되었습니다.

        {
            if (string.IsNullOrEmpty(name))
            {
                return name;
            }
 
            if (name.Length == 1)
            {
                return name.ToLowerInvariant();
            }
 
            return char.ToLowerInvariant(name[0]) + name.Substring(1);
        }

다음에 의해서 참조됨 : BuildSource().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ TryCreateCandidate()

? CommandCandidateModel Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.TryCreateCandidate	(	GeneratorSyntaxContext	context,
		INamedTypeSymbol?	attributeSymbol )

inlinestaticprivate

구문/시맨틱 정보를 기반으로 생성 후보를 구성합니다.

매개변수

context	구문 분석 컨텍스트입니다.
attributeSymbol	`DreamineCommandAttribute` 심볼입니다.

반환값: 유효한 후보이면 모델을 반환하고, 아니면 null을 반환합니다.

DreamineCommandSourceGenerator.cs 파일의 95 번째 라인에서 정의되었습니다.

        {
            if (attributeSymbol is null)
            {
                return null;
            }
 
            if (context.Node is not MethodDeclarationSyntax methodSyntax)
            {
                return null;
            }
 
            if (context.SemanticModel.GetDeclaredSymbol(methodSyntax) is not IMethodSymbol methodSymbol)
            {
                return null;
            }
 
            AttributeData? attributeData = methodSymbol
                .GetAttributes()
                .FirstOrDefault(attribute => SymbolEqualityComparer.Default.Equals(attribute.AttributeClass, attributeSymbol));
 
            if (attributeData is null)
            {
                return null;
            }
 
            string? targetMethod = GetConstructorStringArgument(attributeData, 0);
            string? bindTo = GetNamedStringArgument(attributeData, "BindTo");
            string? commandNameOverride = GetNamedStringArgument(attributeData, "CommandName");
            string? canExecuteMethod = GetNamedStringArgument(attributeData, "CanExecute");
 
            string commandPropertyName = BuildCommandPropertyName(methodSymbol.Name, commandNameOverride);
 
            return new CommandCandidateModel(
                methodSyntax,
                methodSymbol,
                targetMethod,
                bindTo,
                commandPropertyName,
                canExecuteMethod);
        }

다음을 참조함 : BuildCommandPropertyName(), GetConstructorStringArgument(), GetNamedStringArgument().

다음에 의해서 참조됨 : Initialize().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ ValidateCandidate()

List< Diagnostic > Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.ValidateCandidate ( CommandCandidateModel candidate )

inlinestaticprivate

후보의 유효성을 검증합니다.

매개변수

candidate 검사할 후보입니다.

반환값: 발견된 진단 목록입니다.

DreamineCommandSourceGenerator.cs 파일의 178 번째 라인에서 정의되었습니다.

        {
            List<Diagnostic> diagnostics = new List<Diagnostic>();
 
            bool hasTargetMethod = !string.IsNullOrWhiteSpace(candidate.TargetMethod);
 
            if (hasTargetMethod && !IsPartialMethod(candidate.MethodSyntax))
            {
                diagnostics.Add(Diagnostic.Create(
                    MethodMustBePartialDescriptor,
                    candidate.MethodSyntax.Identifier.GetLocation(),
                    candidate.MethodSymbol.ToDisplayString()));
            }
 
            if (!IsContainingTypePartial(candidate.MethodSymbol.ContainingType))
            {
                diagnostics.Add(Diagnostic.Create(
                    ContainingTypeMustBePartialDescriptor,
                    candidate.MethodSyntax.Identifier.GetLocation(),
                    candidate.MethodSymbol.ContainingType.ToDisplayString()));
            }
 
            if (!IsParameterlessVoidMethod(candidate.MethodSymbol))
            {
                diagnostics.Add(Diagnostic.Create(
                    MethodMustBeParameterlessVoidDescriptor,
                    candidate.MethodSyntax.Identifier.GetLocation(),
                    candidate.MethodSymbol.ToDisplayString()));
            }
 
            if (HasConflictingMember(candidate.MethodSymbol.ContainingType, candidate.CommandPropertyName))
            {
                diagnostics.Add(Diagnostic.Create(
                    CommandNameConflictDescriptor,
                    candidate.MethodSyntax.Identifier.GetLocation(),
                    candidate.CommandPropertyName,
                    candidate.MethodSymbol.ContainingType.ToDisplayString()));
            }
 
            if (!string.IsNullOrWhiteSpace(candidate.CanExecuteMethod) &&
                !HasValidCanExecuteMethod(candidate.MethodSymbol.ContainingType, candidate.CanExecuteMethod!))
            {
                diagnostics.Add(Diagnostic.Create(
                    CanExecuteMethodNotFoundDescriptor,
                    candidate.MethodSyntax.Identifier.GetLocation(),
                    candidate.CanExecuteMethod,
                    candidate.MethodSymbol.ContainingType.ToDisplayString()));
            }
 
            return diagnostics;
        }

다음을 참조함 : Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.CommandCandidateModel.CanExecuteMethod, CanExecuteMethodNotFoundDescriptor, CommandNameConflictDescriptor, Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.CommandCandidateModel.CommandPropertyName, ContainingTypeMustBePartialDescriptor, HasConflictingMember(), HasValidCanExecuteMethod(), IsContainingTypePartial(), IsParameterlessVoidMethod(), IsPartialMethod(), MethodMustBeParameterlessVoidDescriptor, MethodMustBePartialDescriptor, Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.CommandCandidateModel.MethodSymbol, Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.CommandCandidateModel.MethodSyntax, Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.CommandCandidateModel.TargetMethod.

다음에 의해서 참조됨 : Emit().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

멤버 데이터 문서화

◆ CanExecuteMethodNotFoundDescriptor

readonly DiagnosticDescriptor Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.CanExecuteMethodNotFoundDescriptor

staticprivate

초기값:

                                                                            = new(
id: "DMCMD005",
title: "CanExecute method not found",
messageFormat: "CanExecute method '{0}' specified on [DreamineCommand] was not found in type '{1}'. The method must be a parameterless bool method.",
category: "Dreamine.MVVM.Generators",
defaultSeverity: DiagnosticSeverity.Warning,
isEnabledByDefault: true)

DreamineCommandSourceGenerator.cs 파일의 54 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : ValidateCandidate().

◆ CommandNameConflictDescriptor

readonly DiagnosticDescriptor Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.CommandNameConflictDescriptor

staticprivate

초기값:

                                                                       = new(
id: "DMCMD004",
title: "Generated command property name conflicts with an existing member",
messageFormat: "Generated command property '{0}' conflicts with an existing member in type '{1}'",
category: "Dreamine.MVVM.Generators",
defaultSeverity: DiagnosticSeverity.Error,
isEnabledByDefault: true)

DreamineCommandSourceGenerator.cs 파일의 46 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : ValidateCandidate().

◆ ContainingTypeMustBePartialDescriptor

readonly DiagnosticDescriptor Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.ContainingTypeMustBePartialDescriptor

staticprivate

초기값:

                                                                               = new(
id: "DMCMD002",
title: "Containing type must be partial",
messageFormat: "Containing type '{0}' for [DreamineCommand] method must be declared partial",
category: "Dreamine.MVVM.Generators",
defaultSeverity: DiagnosticSeverity.Error,
isEnabledByDefault: true)

DreamineCommandSourceGenerator.cs 파일의 30 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : ValidateCandidate().

◆ DreamineCommandAttributeMetadataName

const string Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.DreamineCommandAttributeMetadataName = "Dreamine.MVVM.Attributes.DreamineCommandAttribute"

staticprivate

DreamineCommandSourceGenerator.cs 파일의 20 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : Initialize().

◆ MethodMustBeParameterlessVoidDescriptor

readonly DiagnosticDescriptor Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.MethodMustBeParameterlessVoidDescriptor

staticprivate

초기값:

                                                                                 = new(
id: "DMCMD003",
title: "DreamineCommand method must be parameterless void",
messageFormat: "Method '{0}' marked with [DreamineCommand] must be a parameterless void method",
category: "Dreamine.MVVM.Generators",
defaultSeverity: DiagnosticSeverity.Error,
isEnabledByDefault: true)

DreamineCommandSourceGenerator.cs 파일의 38 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : ValidateCandidate().

◆ MethodMustBePartialDescriptor

readonly DiagnosticDescriptor Dreamine.MVVM.Generators.DreamineCommandSourceGenerator.MethodMustBePartialDescriptor

staticprivate

초기값:

                                                                       = new(
id: "DMCMD001",
title: "DreamineCommand method must be partial",
messageFormat: "Method '{0}' marked with forwarding [DreamineCommand] must be declared partial",
category: "Dreamine.MVVM.Generators",
defaultSeverity: DiagnosticSeverity.Error,
isEnabledByDefault: true)

DreamineCommandSourceGenerator.cs 파일의 22 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : ValidateCandidate().

이 클래스에 대한 문서화 페이지는 다음의 파일로부터 생성되었습니다.:

DreamineCommandSourceGenerator.cs

클래스

Public 멤버 함수

정적 Private 멤버 함수

정적 Private 속성

상세한 설명

멤버 함수 문서화

◆ BuildCommandPropertyName()

◆ BuildFileName()

◆ BuildSource()

◆ Emit()

◆ GetConstructorStringArgument()

◆ GetContainingTypeChain()

◆ GetMethodSignatureWithoutAttributes()

◆ GetNamedStringArgument()

◆ GetTypeDeclarationHeader()

◆ HasConflictingMember()

◆ HasValidCanExecuteMethod()

◆ Initialize()

◆ IsContainingTypePartial()

◆ IsParameterlessVoidMethod()

◆ IsPartialMethod()

◆ NormalizeInvocation()

◆ Sanitize()

◆ ToCamel()

◆ TryCreateCandidate()

◆ ValidateCandidate()

멤버 데이터 문서화

◆ CanExecuteMethodNotFoundDescriptor

◆ CommandNameConflictDescriptor

◆ ContainingTypeMustBePartialDescriptor

◆ DreamineCommandAttributeMetadataName

◆ MethodMustBeParameterlessVoidDescriptor

◆ MethodMustBePartialDescriptor