/// <summary></summary>
 public DotNetCommentTypeParameter(DotNetCommentTypeParameterLink link, List <DotNetComment> comments) : base(link, comments)
 {
     Tag = CommentTag.TypeParam;
 }
 /// <summary></summary>
 public DotNetCommentTypeParameter(DotNetCommentTypeParameterLink link, DotNetComment comment) : base(link, comment)
 {
     Tag = CommentTag.TypeParam;
 }
 /// <summary></summary>
 public DotNetCommentTypeParameter(DotNetCommentTypeParameterLink link, params DotNetComment[] comments) : base(link, comments)
 {
     Tag = CommentTag.TypeParam;
 }
예제 #4
0
        /// <summary>Parses top-level .Net XML documentation comments. Returns null if no comments are found.</summary>
        /// <returns>Returns null if the element name is not recognized.</returns>
        public static DotNetComment FromVisualStudioXml(XElement element)
        {
            switch (element.Name.LocalName)
            {
            case "summary":
            case "remarks":
            case "example":
            case "para":                     //paragraph
            case "returns":
            case "value":
                DotNetCommentGroup group = DotNetCommentGroup.FromVisualStudioXml(element);
                if (group.IsEmpty)
                {
                    return(null);
                }
                return(group);

            case "exception":
            case "permission":
                if (element.Attribute("cref") == null)
                {
                    break;
                }
                if (String.IsNullOrEmpty(element.Attribute("cref").Value))
                {
                    break;
                }
                return(DotNetCommentQualifiedLinkedGroup.FromVisualStudioXml(element));

            case "see":
            case "seealso":
                if (element.Attribute("cref") == null)
                {
                    break;
                }
                if (String.IsNullOrEmpty(element.Attribute("cref").Value))
                {
                    break;
                }
                if (element.Nodes().Count() == 0)
                {
                    return(DotNetCommentQualifiedLink.FromVisualStudioXml(element));
                }
                else
                {
                    return(DotNetCommentQualifiedLinkedGroup.FromVisualStudioXml(element));
                }

            case "list":
                return(DotNetCommentList.FromVisualStudioXml(element));

            case "param":
                return(DotNetCommentParameter.FromVisualStudioXml(element));

            case "paramref":
                return(DotNetCommentParameterLink.FromVisualStudioXml(element));

            case "typeparam":
                return(DotNetCommentTypeParameter.FromVisualStudioXml(element));

            case "typeparamref":
                return(DotNetCommentTypeParameterLink.FromVisualStudioXml(element));

            case "c":                     //inline code
                return(DotNetCommentCode.FromVisualStudioXml(element));

            case "code":                     //code block
                return(DotNetCommentCodeBlock.FromVisualStudioXml(element));

            case "inheritdoc":
                return(new DotNetCommentInherit());

            case "duplicate":
                if (element.Attribute("cref") == null)
                {
                    break;
                }
                string duplicateCref = element.Attribute("cref").Value;
                if (String.IsNullOrEmpty(duplicateCref))
                {
                    break;
                }
                return(new DotNetCommentDuplicate(DotNetCommentQualifiedLink.FromVisualStudioXml(duplicateCref)));
            }
            return(null);
        }