name: dotnet-managedcode-mimetypes
version: "1.0.0"
category: "Core"
description: "Use ManagedCode.MimeTypes when a .NET application needs consistent MIME type detection, extension mapping, and content-type decisions for uploads, downloads, or HTTP responses."
compatibility: "Requires a .NET application that integrates ManagedCode.MimeTypes or evaluates MIME type mapping behavior."

ManagedCode.MimeTypes

Trigger On

• integrating ManagedCode.MimeTypes into upload or download flows
• mapping file extensions to content types in APIs or background processing
• reviewing content-type handling for files, blobs, or attachments
• documenting a reusable MIME-type decision point in a .NET application

Workflow

1. Identify where the application needs stable MIME-type decisions:
2. upload validation
3. download response headers
4. storage metadata
5. attachment processing
6. Centralize content-type mapping instead of scattering ad-hoc string tables across the codebase.
7. Use one library boundary for extension and MIME lookups.
8. Validate the extensions and media types that matter to the product.
9. Document any product-specific overrides separately from the library defaults.

flowchart LR
  A["File name or extension"] --> B["ManagedCode.MimeTypes lookup"]
  B --> C["Resolved MIME type"]
  C --> D["Upload validation, storage metadata, or HTTP response"]

Deliver

• guidance on where MIME lookup belongs in application code
• recommendations for centralized content-type decisions
• validation expectations for real file types used by the product

Validate

• MIME mapping is not duplicated across multiple services or controllers
• important file types are verified explicitly
• response or storage code uses the resolved type consistently