Skip to main content

Definition

Assembly: CloudNimble.DotNetDocs.Core.dll Namespace: CloudNimble.DotNetDocs.Core Inheritance: CloudNimble.DotNetDocs.Core.DocType

Syntax

Summary

Represents documentation for a .NET enum type.

Remarks

Contains metadata about an enum type and its values, extracted from Roslyn symbols and enhanced with conceptual documentation. Inherits from DocType but uses a specialized structure for enum values instead of the Members collection.

Constructors

.ctor

Initializes a new instance of the DocEnum class.

Syntax

Parameters

Exceptions

.ctor Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocType
Initializes a new instance of the DocType class.

Syntax

Remarks

This parameterless constructor is provided for deserialization purposes only. Use ITypeSymbol) for normal instantiation.

.ctor Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocType
Initializes a new instance of the DocType class.

Syntax

Parameters

Exceptions

.ctor Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocEntity
Initializes a new instance of the DocEntity class.

Syntax

.ctor Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocEntity
Initializes a new instance of the DocEntity class with an ISymbol.

Syntax

Parameters

.ctor Inherited

Inherited from object

Syntax

Properties

AssemblyName Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocType
Gets or sets the containing assembly name.

Syntax

Property Value

Type: string? The name of the assembly containing this type.

BaseType Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocType
Gets the base type name, if any.

Syntax

Property Value

Type: string? The name of the base type, or null if none exists.

BestPractices Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocEntity
Gets or sets the best practices documentation content.

Syntax

Property Value

Type: string? Markdown content with best practices, recommendations, and guidelines from conceptual documentation.

Considerations Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocEntity
Gets or sets the considerations or notes related to the current context.

Syntax

Property Value

Type: string? Markdown content with gotchas, performance, or security notes from conceptual documentation.

DisplayName Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocEntity
Gets or sets the display name of the entity.

Syntax

Property Value

Type: string? The fully qualified display name extracted from the Symbol.

Examples Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocEntity
Gets or sets the examples documentation content.

Syntax

Property Value

Type: string? Markdown content containing code examples from XML <example> tags.

Exceptions Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocEntity
Gets or sets the collection of exceptions that can be thrown.

Syntax

Property Value

Type: System.Collections.Generic.ICollection<CloudNimble.DotNetDocs.Core.DocException>? Collection of exception documentation from XML <exception> tags.

FullName Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocType
Gets or sets the fully qualified name of the type.

Syntax

Property Value

Type: string? The fully qualified type name including namespace.

IncludedMembers Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocEntity
Gets or sets the list of member accessibilities to include (default: Public).

Syntax

Property Value

Type: System.Collections.Generic.List<Microsoft.CodeAnalysis.Accessibility> List of accessibility levels to include when processing child members.

IsExternalReference Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocType
Gets or sets whether this type is an external reference created to host extension methods.

Syntax

Property Value

Type: bool true if this type is not part of the documented assembly but was created to show extension methods that apply to it; otherwise false.

Remarks

External references are minimal DocType instances created when extension methods target types outside the current assembly. These types link to official documentation rather than duplicating external API documentation.

IsFlags

Gets whether this enum has the Flags attribute.

Syntax

Property Value

Type: bool True if the enum is decorated with [Flags]; otherwise, false.

Members Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocType
Gets the collection of members (methods, properties, fields, events, etc.).

Syntax

Property Value

Type: System.Collections.Generic.List<CloudNimble.DotNetDocs.Core.DocMember> List of documented members within this type.

Name Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocType
Gets or sets the name of the type.

Syntax

Property Value

Type: string The type name.

OriginalSymbol Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocEntity
Gets the original symbol this documentation entity was created from.

Syntax

Property Value

Type: Microsoft.CodeAnalysis.ISymbol? The Roslyn ISymbol that was used to create this entity, preserved for reference.

Patterns Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocEntity
Gets or sets the patterns documentation content.

Syntax

Property Value

Type: string? Markdown content explaining common usage patterns and architectural guidance from conceptual documentation.

RelatedApis Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocEntity
Gets or sets a list of related API names.

Syntax

Property Value

Type: System.Collections.Generic.ICollection<string>? List of fully qualified names or URLs for related APIs from conceptual documentation.

Remarks Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocEntity
Gets or sets the remarks from XML documentation.

Syntax

Property Value

Type: string? Content from the XML documentation’s <remarks> element.

Returns Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocEntity
Gets or sets the return value documentation.

Syntax

Property Value

Type: string? Description of the return value from XML <returns> tag.

SeeAlso Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocEntity
Gets or sets the collection of see-also references.

Syntax

Property Value

Type: System.Collections.Generic.ICollection<CloudNimble.DotNetDocs.Core.DocReference>? Collection of related items from XML <seealso> tags.

Signature Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocType
Gets or sets the signature of the type.

Syntax

Property Value

Type: string? The type signature including modifiers, inheritance, etc.

Summary Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocEntity
Gets or sets the summary from XML documentation.

Syntax

Property Value

Type: string? Brief description of what the API element IS, from XML <summary> tag.

Symbol Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocType
Gets the Roslyn symbol for the type.

Syntax

Property Value

Type: Microsoft.CodeAnalysis.ITypeSymbol The underlying Roslyn type symbol containing metadata.

TypeKind Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocType
Gets or sets the type kind.

Syntax

Property Value

Type: Microsoft.CodeAnalysis.TypeKind? The kind of type (Class, Interface, Struct, Enum, Delegate, etc.).

TypeParameters Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocEntity
Gets or sets the collection of type parameters.

Syntax

Property Value

Type: System.Collections.Generic.ICollection<CloudNimble.DotNetDocs.Core.DocTypeParameter>? Collection of type parameter documentation from XML <typeparam> tags.

UnderlyingType

Gets or sets the underlying type of the enum as a DocReference.

Syntax

Property Value

Type: CloudNimble.DotNetDocs.Core.DocReference A reference to the underlying type (e.g., System.Int32, System.Byte) that can be resolved and linked in documentation.

Usage Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocEntity
Gets or sets the usage documentation content.

Syntax

Property Value

Type: string? Markdown content explaining HOW to use the API element, from conceptual documentation.

Value Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocEntity
Gets or sets the value description for properties.

Syntax

Property Value

Type: string? Description of what the property represents from XML <value> tag.

Values

Gets the collection of enum values with their documentation.

Syntax

Property Value

Type: System.Collections.Generic.List<CloudNimble.DotNetDocs.Core.DocEnumValue> A list of documented enum values, each containing the name, numeric value, and associated documentation.

Methods

Equals Inherited Virtual

Inherited from object

Syntax

Parameters

Returns

Type: bool

Equals Inherited

Inherited from object

Syntax

Parameters

Returns

Type: bool

GetHashCode Inherited Virtual

Inherited from object

Syntax

Returns

Type: int

GetType Inherited

Inherited from object

Syntax

Returns

Type: System.Type

MemberwiseClone Inherited

Inherited from object

Syntax

Returns

Type: object

ReferenceEquals Inherited

Inherited from object

Syntax

Parameters

Returns

Type: bool

ToJson Inherited

Inherited from CloudNimble.DotNetDocs.Core.DocEntity
Serializes this entity to JSON using consistent options.

Syntax

Returns

Type: string The JSON string representation of this entity.

ToString Inherited Virtual

Inherited from object

Syntax

Returns

Type: string?