# berik-99/msmq.netcore architecture

> Architecture diagram of the GitHub repository berik-99/msmq.netcore, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/berik-99/msmq.netcore
- Repository: https://github.com/berik-99/msmq.netcore

## Overview

Msmq.NetCore is a Windows MSMQ client library that ports the System.Messaging API to modern .NET. Its central workflow is an application configuring a queue and formatter, sending a message, then receiving and decoding it. The graph also captures queue management, transactions, security, and the native MSMQ boundary. Relationships are limited to those supported by the README, excerpts, or SOURCE INDEX references; unsampled implementation details are not inferred.

Main entry points: [`Sources/Messaging/MessageQueue.cs`](https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/MessageQueue.cs) (MessageQueue), [`Sources/Messaging/Message.cs`](https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/Message.cs) (Message), [`Sources/Messaging/IMessageFormatter.cs`](https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/IMessageFormatter.cs) (Formatter contract), [`Sources/Messaging/ActiveXMessageFormatter.cs`](https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/ActiveXMessageFormatter.cs) (ActiveX formatter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Queue API"]
  node_queue["MessageQueue<br/>[MessageQueue.cs]"]
  node_defaults["Send defaults"]
  node_errors["Queue errors"]
  node_assembly_refs["Runtime references<br/>[AssemblyRef.cs]"]
end

subgraph group_messages["Messages and Formatting"]
  node_message["Message<br/>[Message.cs]"]
  node_formatter["Formatter contract"]
  node_xml["XML formatter"]
  node_activex["ActiveX formatter"]
  node_binary["Binary formatter"]
  node_properties["Message properties"]
  node_algorithms["Encryption algorithms"]
  node_hashes["Hash algorithms<br/>[HashAlgorithm.cs]"]
end

subgraph group_interop["Windows Interop"]
  node_interop["Native interop"]
  node_variants["Property marshalling"]
  node_stream["COM stream interface<br/>[IStream.cs]"]
end

subgraph group_admin["Management and Security"]
  node_queue_search["Queue search"]
  node_transactions["Transactions"]
  node_security["Queue permissions"]
  node_access_list["Queue ACL"]
end

node_application(("Application"))
node_native[("MSMQ runtime")]

node_application -->|"configures and uses"| node_queue
node_queue -->|"manages and accesses"| node_native
node_queue -->|"sends and receives"| node_message
node_queue -->|"exposes formatter"| node_formatter
node_message -->|"reads and writes body"| node_formatter
node_xml -->|"implements"| node_formatter
node_activex -->|"implements"| node_formatter
node_binary -->|"implements"| node_formatter
node_message -->|"uses filter"| node_properties
node_message -->|"constructs related queue"| node_queue
node_queue -->|"uses queue properties"| node_variants
node_interop -->|"calls native API"| node_native
node_interop -->|"accepts property data"| node_variants
node_activex -->|"uses COM stream"| node_stream
node_queue -->|"supports criteria search"| node_queue_search
node_application -->|"may use"| node_transactions
node_queue -->|"checks queue access"| node_security
node_security -->|"supports permission checks"| node_queue_search
node_queue -->|"uses send defaults"| node_defaults
node_queue -.->|"throws queue errors"| node_errors
node_message -->|"uses encryption settings"| node_algorithms
node_message -->|"uses hash settings"| node_hashes
node_queue -.->|"uses queue ACLs"| node_access_list

click node_queue "https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/MessageQueue.cs"
click node_message "https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/Message.cs"
click node_formatter "https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/IMessageFormatter.cs"
click node_xml "https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/XmlMessageFormatter.cs"
click node_activex "https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/ActiveXMessageFormatter.cs"
click node_binary "https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/BinaryMessageFormatter.cs"
click node_properties "https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/MessagePropertyFilter.cs"
click node_algorithms "https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/EncryptionAlgorithm.cs"
click node_hashes "https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/HashAlgorithm.cs"
click node_interop "https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/Interop/UnsafeNativeMethods.cs"
click node_variants "https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/Interop/MessagePropertyVariants.cs"
click node_stream "https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/Interop/IStream.cs"
click node_queue_search "https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/MessageQueueCriteria.cs"
click node_transactions "https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/MessageQueueTransaction.cs"
click node_security "https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/MessageQueuePermission.cs"
click node_access_list "https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/AccessControlList.cs"
click node_defaults "https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/DefaultPropertiesToSend.cs"
click node_errors "https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/MessageQueueException.cs"
click node_assembly_refs "https://github.com/berik-99/msmq.netcore/blob/main/Sources/AssemblyRef.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_queue,node_defaults,node_errors,node_assembly_refs toneBlue
class node_message,node_formatter,node_xml,node_activex,node_binary,node_properties,node_algorithms,node_hashes,node_native toneAmber
class node_interop,node_variants,node_stream toneMint
class node_queue_search,node_transactions,node_security,node_access_list toneRose
class node_application toneIndigo
```

## Components

### Queue API

- [MessageQueue](https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/MessageQueue.cs): `Sources/Messaging/MessageQueue.cs`
- [Send defaults](https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/DefaultPropertiesToSend.cs): `Sources/Messaging/DefaultPropertiesToSend.cs`
- [Queue errors](https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/MessageQueueException.cs): `Sources/Messaging/MessageQueueException.cs`
- [Runtime references](https://github.com/berik-99/msmq.netcore/blob/main/Sources/AssemblyRef.cs): `Sources/AssemblyRef.cs`

### Messages and Formatting

- [Message](https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/Message.cs): `Sources/Messaging/Message.cs`
- [Formatter contract](https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/IMessageFormatter.cs): `Sources/Messaging/IMessageFormatter.cs`
- [XML formatter](https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/XmlMessageFormatter.cs): `Sources/Messaging/XmlMessageFormatter.cs`
- [ActiveX formatter](https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/ActiveXMessageFormatter.cs): `Sources/Messaging/ActiveXMessageFormatter.cs`
- [Binary formatter](https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/BinaryMessageFormatter.cs): `Sources/Messaging/BinaryMessageFormatter.cs`
- [Message properties](https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/MessagePropertyFilter.cs): `Sources/Messaging/MessagePropertyFilter.cs`
- [Encryption algorithms](https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/EncryptionAlgorithm.cs): `Sources/Messaging/EncryptionAlgorithm.cs`
- [Hash algorithms](https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/HashAlgorithm.cs): `Sources/Messaging/HashAlgorithm.cs`

### Windows Interop

- [Native interop](https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/Interop/UnsafeNativeMethods.cs): `Sources/Messaging/Interop/UnsafeNativeMethods.cs`
- [Property marshalling](https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/Interop/MessagePropertyVariants.cs): `Sources/Messaging/Interop/MessagePropertyVariants.cs`
- [COM stream interface](https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/Interop/IStream.cs): `Sources/Messaging/Interop/IStream.cs`

### Management and Security

- [Queue search](https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/MessageQueueCriteria.cs): `Sources/Messaging/MessageQueueCriteria.cs`
- [Transactions](https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/MessageQueueTransaction.cs): `Sources/Messaging/MessageQueueTransaction.cs`
- [Queue permissions](https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/MessageQueuePermission.cs): `Sources/Messaging/MessageQueuePermission.cs`
- [Queue ACL](https://github.com/berik-99/msmq.netcore/blob/main/Sources/Messaging/AccessControlList.cs): `Sources/Messaging/AccessControlList.cs`

### Other components

- **Application**
- **MSMQ runtime**

## Connections

- Application → MessageQueue: configures and uses (evidence: `README.md`)
- MessageQueue → MSMQ runtime: manages and accesses (evidence: `README.md`)
- MessageQueue → Message: sends and receives (evidence: `README.md`)
- MessageQueue → Formatter contract: exposes formatter (evidence: `Sources/Messaging/MessageQueue.cs`)
- Message → Formatter contract: reads and writes body (evidence: `Sources/Messaging/Message.cs`)
- XML formatter → Formatter contract: implements (evidence: `Sources/Messaging/XmlMessageFormatter.cs`)
- ActiveX formatter → Formatter contract: implements (evidence: `Sources/Messaging/ActiveXMessageFormatter.cs`)
- Binary formatter → Formatter contract: implements
- Message → Message properties: uses filter (evidence: `Sources/Messaging/Message.cs`)
- Message → MessageQueue: constructs related queue (evidence: `Sources/Messaging/Message.cs`)
- MessageQueue → Property marshalling: uses queue properties (evidence: `Sources/Messaging/MessageQueue.cs`)
- Native interop → MSMQ runtime: calls native API (evidence: `Sources/Messaging/Interop/UnsafeNativeMethods.cs`)
- Native interop → Property marshalling: accepts property data (evidence: `Sources/Messaging/Interop/UnsafeNativeMethods.cs`)
- ActiveX formatter → COM stream interface: uses COM stream (evidence: `Sources/Messaging/ActiveXMessageFormatter.cs`)
- MessageQueue → Queue search: supports criteria search (evidence: `Sources/Messaging/MessageQueueCriteria.cs`)
- Application → Transactions: may use (evidence: `README.md`)
- MessageQueue → Queue permissions: checks queue access (evidence: `Sources/Messaging/MessageQueue.cs`)
- Queue permissions → Queue search: supports permission checks (evidence: `Sources/Messaging/MessageQueuePermission.cs`)
- MessageQueue → Send defaults: uses send defaults (evidence: `Sources/Messaging/MessageQueue.cs`)
- MessageQueue → Queue errors: throws queue errors (evidence: `Sources/Messaging/MessageQueue.cs`)
- Message → Encryption algorithms: uses encryption settings (evidence: `Sources/Messaging/Message.cs`)
- Message → Hash algorithms: uses hash settings (evidence: `Sources/Messaging/Message.cs`)
- MessageQueue → Queue ACL: uses queue ACLs
