| File: Linker\DocumentationSignatureGenerator.cs | Web Access |
| Project: src\runtime\src\tools\illink\src\linker\Mono.Linker.csproj (illink) |
// Copyright (c) .NET Foundation and contributors. All rights reserved. // Licensed under the MIT license. See LICENSE file in the project root for full license information. using System.Text; using Mono.Cecil; namespace Mono.Linker { /// <summary> /// Generates a signature for a member, in the format used for C# Documentation Comments: /// https://github.com/dotnet/csharplang/blob/master/spec/documentation-comments.md#id-string-format /// Adapted from Roslyn's DocumentationCommentIDVisitor: /// https://github.com/dotnet/roslyn/blob/master/src/Compilers/CSharp/Portable/DocumentationComments/DocumentationCommentIDVisitor.cs /// </summary> internal sealed partial class DocumentationSignatureGenerator { internal const string MethodPrefix = "M:"; internal const string FieldPrefix = "F:"; internal const string EventPrefix = "E:"; internal const string PropertyPrefix = "P:"; internal const string TypePrefix = "T:"; private DocumentationSignatureGenerator() { } public static void VisitMember(IMemberDefinition member, StringBuilder builder, ITryResolveMetadata resolver) { switch (member.MetadataToken.TokenType) { case TokenType.TypeDef: VisitTypeDefinition((TypeDefinition)member, builder, resolver); break; case TokenType.Method: VisitMethod((MethodDefinition)member, builder, resolver); break; case TokenType.Property: VisitProperty((PropertyDefinition)member, builder, resolver); break; case TokenType.Field: VisitField((FieldDefinition)member, builder, resolver); break; case TokenType.Event: VisitEvent((EventDefinition)member, builder, resolver); break; default: break; } } private static void VisitMethod(MethodDefinition method, StringBuilder builder, ITryResolveMetadata resolver) { builder.Append(MethodPrefix); PartVisitor.Instance.VisitMethodDefinition(method, builder, resolver); } private static void VisitField(FieldDefinition field, StringBuilder builder, ITryResolveMetadata resolver) { builder.Append(FieldPrefix); PartVisitor.Instance.VisitField(field, builder, resolver); } private static void VisitEvent(EventDefinition evt, StringBuilder builder, ITryResolveMetadata resolver) { builder.Append(EventPrefix); PartVisitor.Instance.VisitEvent(evt, builder, resolver); } private static void VisitProperty(PropertyDefinition property, StringBuilder builder, ITryResolveMetadata resolver) { builder.Append(PropertyPrefix); PartVisitor.Instance.VisitProperty(property, builder, resolver); } private static void VisitTypeDefinition(TypeDefinition type, StringBuilder builder, ITryResolveMetadata resolver) { builder.Append(TypePrefix); PartVisitor.Instance.VisitTypeReference(type, builder, resolver); } } }