Skip to main content

Definition

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

Syntax

CloudNimble.DotNetDocs.Core.DocAssembly

Summary

Represents documentation for a .NET assembly.

Remarks

Contains metadata about an assembly and its namespaces, extracted from Roslyn symbols and enhanced with conceptual documentation.

Constructors

.ctor

Initializes a new instance of the DocAssembly class.

Syntax

public DocAssembly(Microsoft.CodeAnalysis.IAssemblySymbol symbol)

Parameters

NameTypeDescription
symbolMicrosoft.CodeAnalysis.IAssemblySymbolThe Roslyn assembly symbol.

Exceptions

ExceptionDescription
ArgumentNullExceptionThrown when symbol is null.

.ctor Inherited

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

Syntax

protected DocEntity()

.ctor Inherited

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

Syntax

protected DocEntity(Microsoft.CodeAnalysis.ISymbol symbol)

Parameters

NameTypeDescription
symbolMicrosoft.CodeAnalysis.ISymbol?The symbol to store as the original reference.

.ctor Inherited

Inherited from object

Syntax

public Object()

Properties

AssemblyName

Gets or sets the name of the assembly.

Syntax

public string AssemblyName { get; set; }

Property Value

Type: string The assembly name.

BestPractices Inherited

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

Syntax

public string BestPractices { get; set; }

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

public string Considerations { get; set; }

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

public string DisplayName { get; set; }

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

public string Examples { get; set; }

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

public System.Collections.Generic.ICollection<CloudNimble.DotNetDocs.Core.DocException> Exceptions { get; set; }

Property Value

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

IncludedMembers Inherited

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

Syntax

public System.Collections.Generic.List<Microsoft.CodeAnalysis.Accessibility> IncludedMembers { get; set; }

Property Value

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

Namespaces

Gets the collection of namespaces in the assembly.

Syntax

public System.Collections.Generic.List<CloudNimble.DotNetDocs.Core.DocNamespace> Namespaces { get; }

Property Value

Type: System.Collections.Generic.List<CloudNimble.DotNetDocs.Core.DocNamespace> List of documented namespaces within this assembly.

OriginalSymbol Inherited

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

Syntax

public Microsoft.CodeAnalysis.ISymbol OriginalSymbol { get; protected set; }

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

public string Patterns { get; set; }

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

public System.Collections.Generic.ICollection<string> RelatedApis { get; set; }

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

public string Remarks { get; set; }

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

public string Returns { get; set; }

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

public System.Collections.Generic.ICollection<CloudNimble.DotNetDocs.Core.DocReference> SeeAlso { get; set; }

Property Value

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

Summary Inherited

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

Syntax

public string Summary { get; set; }

Property Value

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

Symbol

Gets the Roslyn symbol for the assembly.

Syntax

public Microsoft.CodeAnalysis.IAssemblySymbol Symbol { get; }

Property Value

Type: Microsoft.CodeAnalysis.IAssemblySymbol The underlying Roslyn assembly symbol containing metadata.

TypeParameters Inherited

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

Syntax

public System.Collections.Generic.ICollection<CloudNimble.DotNetDocs.Core.DocTypeParameter> TypeParameters { get; set; }

Property Value

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

Usage Inherited

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

Syntax

public string Usage { get; set; }

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

public string Value { get; set; }

Property Value

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

Version

Gets or sets the version of the assembly.

Syntax

public string Version { get; set; }

Property Value

Type: string? The assembly version string.

Methods

Equals Inherited Virtual

Inherited from object

Syntax

public virtual bool Equals(object obj)

Parameters

NameTypeDescription
objobject?-

Returns

Type: bool

Equals Inherited

Inherited from object

Syntax

public static bool Equals(object objA, object objB)

Parameters

NameTypeDescription
objAobject?-
objBobject?-

Returns

Type: bool

GetHashCode Inherited Virtual

Inherited from object

Syntax

public virtual int GetHashCode()

Returns

Type: int

GetType Inherited

Inherited from object

Syntax

public System.Type GetType()

Returns

Type: System.Type

MemberwiseClone Inherited

Inherited from object

Syntax

protected internal object MemberwiseClone()

Returns

Type: object

ReferenceEquals Inherited

Inherited from object

Syntax

public static bool ReferenceEquals(object objA, object objB)

Parameters

NameTypeDescription
objAobject?-
objBobject?-

Returns

Type: bool

ToJson Inherited

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

Syntax

public string ToJson()

Returns

Type: string The JSON string representation of this entity.

ToString Inherited Virtual

Inherited from object

Syntax

public virtual string ToString()

Returns

Type: string?