Debian Codegraph @

external/api-doc-tools/mdoc/Mono.Documentation/Updater/DocsNodeInfo.cs

raw
1 using System;
2 using System.Collections.Generic;
3 using System.Xml;
4
5 using Mono.Cecil;
6
7 using Mono.Documentation.Util;
8
9 namespace Mono.Documentation.Updater
10 {
11 public class DocsNodeInfo
12 {
13 public DocsNodeInfo (XmlElement node)
14 {
15 this.Node = node;
16 }
17
18 public DocsNodeInfo (XmlElement node, TypeDefinition type)
19 : this (node)
20 {
21 SetType (type);
22 }
23
24 public DocsNodeInfo (XmlElement node, MemberReference member)
25 : this (node)
26 {
27 SetMemberInfo (member);
28 }
29
30 void SetType (TypeDefinition type)
31 {
32 if (type == null)
33 throw new ArgumentNullException ("type");
34 Type = type;
35 GenericParameters = new List<GenericParameter> (type.GenericParameters);
36 List<TypeReference> declTypes = DocUtils.GetDeclaringTypes (type);
37 int maxGenArgs = DocUtils.GetGenericArgumentCount (type);
38 for (int i = 0; i < declTypes.Count - 1; ++i)
39 {
40 int remove = System.Math.Min (maxGenArgs,
41 DocUtils.GetGenericArgumentCount (declTypes[i]));
42 maxGenArgs -= remove;
43 while (remove-- > 0)
44 GenericParameters.RemoveAt (0);
45 }
46 if (DocUtils.IsDelegate (type))
47 {
48 Parameters = type.GetMethod ("Invoke").Parameters;
49 ReturnType = type.GetMethod ("Invoke").ReturnType;
50 ReturnIsReturn = true;
51 }
52 }
53
54 void SetMemberInfo (MemberReference member)
55 {
56 if (member == null)
57 throw new ArgumentNullException ("member");
58 ReturnIsReturn = true;
59 AddRemarks = true;
60 Member = member;
61
62 if (member is MethodReference)
63 {
64 MethodReference mr = (MethodReference)member;
65 Parameters = mr.Parameters;
66 if (mr.IsGenericMethod ())
67 {
68 GenericParameters = new List<GenericParameter> (mr.GenericParameters);
69 }
70 }
71 else if (member is PropertyDefinition)
72 {
73 Parameters = ((PropertyDefinition)member).Parameters;
74 }
75
76 if (member is MethodDefinition)
77 {
78 ReturnType = ((MethodDefinition)member).ReturnType;
79 }
80 else if (member is PropertyDefinition)
81 {
82 ReturnType = ((PropertyDefinition)member).PropertyType;
83 ReturnIsReturn = false;
84 }
85
86 // no remarks section for enum members
87 if (member.DeclaringType != null && ((TypeDefinition)member.DeclaringType).IsEnum)
88 AddRemarks = false;
89 }
90
91 public TypeReference ReturnType;
92 public List<GenericParameter> GenericParameters;
93 public IList<ParameterDefinition> Parameters;
94 public bool ReturnIsReturn;
95 public XmlElement Node;
96 public bool AddRemarks = true;
97 public MemberReference Member;
98 public TypeDefinition Type;
99
100 public override string ToString ()
101 {
102 return string.Format ("{0} - {1} - {2}", Type, Member, Node == null ? "no xml" : "with xml");
103 }
104 }
105 }