H.Formatters.BinaryFormatter 2.0.47

.NET 6.0 .NET Standard 2.0 .NET Framework 4.5.1
dotnet add package H.Formatters.BinaryFormatter --version 2.0.47
NuGet\Install-Package H.Formatters.BinaryFormatter -Version 2.0.47
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="H.Formatters.BinaryFormatter" Version="2.0.47" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add H.Formatters.BinaryFormatter --version 2.0.47
#r "nuget: H.Formatters.BinaryFormatter, 2.0.47"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install H.Formatters.BinaryFormatter as a Cake Addin
#addin nuget:?package=H.Formatters.BinaryFormatter&version=2.0.47

// Install H.Formatters.BinaryFormatter as a Cake Tool
#tool nuget:?package=H.Formatters.BinaryFormatter&version=2.0.47

Async Named Pipe Wrapper for .NET Standard 2.0

Language License Requirements Build Status

A simple, easy to use, strongly-typed, async wrapper around .NET named pipes.

Features

  • Create named pipe servers that can handle multiple client connections simultaneously.
  • Send strongly-typed messages between clients and servers: any serializable .NET object can be sent over a pipe and will be automatically serialized/deserialized, including cyclical references and complex object graphs.
  • Async
  • Requires .NET Standard 2.0
  • Supports large messages - up to 300 MiB.
  • Server restart automatically
  • Automatically wait for the release of the pipe for the server, if it is already in use
  • Automatically waiting for a server pipe creating when client connecting
  • Automatic reconnect with a given interval and at each client.WriteAsync, if necessary
  • Supports variable formatters, default - BinaryFormatter which uses System.Runtime.Serialization.BinaryFormatter inside
  • Also available ready formatters in separate nuget packages: H.Formatters.Newtonsoft.Json, H.Formatters.System.Text.Json and H.Formatters.Ceras
  • Supports PipeAccessRule's(see H.Pipes.AccessControl nuget package) or more complex code to access using the PipeServer.PipeStreamInitializeAction property

Nuget

NuGet NuGet NuGet NuGet NuGet

// All clients and servers that do not need support AccessControl.
Install-Package H.Pipes

// Servers that need support AccessControl.
Install-Package H.Pipes.AccessControl

// If you want to transfer any data that can be serialized/deserialized in json using Newtonsoft.Json.
Install-Package H.Formatters.Newtonsoft.Json

// If you want to transfer any data that can be serialized/deserialized in json using System.Text.Json.
Install-Package H.Formatters.System.Text.Json

// If you want to transfer any data that can be serialized/deserialized in binary using Ceras.
Install-Package H.Formatters.Ceras

Usage

Server:

await using var server = new PipeServer<MyMessage>(pipeName);
server.ClientConnected += async (o, args) =>
{
    Console.WriteLine($"Client {args.Connection.PipeName} is now connected!");

    await args.Connection.WriteAsync(new MyMessage
    {
        Text = "Welcome!"
    });
};
server.ClientDisconnected += (o, args) =>
{
    Console.WriteLine($"Client {args.Connection.PipeName} disconnected");
};
server.MessageReceived += (sender, args) =>
{
    Console.WriteLine($"Client {args.Connection.PipeName} says: {args.Message}");
};
server.ExceptionOccurred += (o, args) => OnExceptionOccurred(args.Exception);

await server.StartAsync();

await Task.Delay(Timeout.InfiniteTimeSpan);

Client:

await using var client = new PipeClient<MyMessage>(pipeName);
client.MessageReceived += (o, args) => Console.WriteLine("MessageReceived: " + args.Message);
client.Disconnected += (o, args) => Console.WriteLine("Disconnected from server");
client.Connected += (o, args) => Console.WriteLine("Connected to server");
client.ExceptionOccurred += (o, args) => OnExceptionOccurred(args.Exception);

await client.ConnectAsync();

await client.WriteAsync(new MyMessage
{
    Text = "Hello!",
});

await Task.Delay(Timeout.InfiniteTimeSpan);

Notes:

  • To use the server inside the WinForms/WPF/Other UI application, use Task.Run() or any alternative.
  • Be careful and call Dispose before closing the program/after the end of use. Pipes are system resources and you might have problems restarting the server if you don't properly clean up the resources.

Custom Formatters

Since BinaryFormatter is used by default, you should check out this article: https://docs.microsoft.com/en-us/dotnet/standard/serialization/binaryformatter-security-guide

Install-Package H.Formatters.Newtonsoft.Json
Install-Package H.Formatters.System.Text.Json
Install-Package H.Formatters.Ceras
using H.Formatters;

await using var server = new PipeServer<MyMessage>(pipeName, formatter: new NewtonsoftJsonFormatter());
await using var client = new PipeClient<MyMessage>(pipeName, formatter: new NewtonsoftJsonFormatter());

Access Control

⚠️ Note: this is only available for the Windows platform

Install-Package H.Pipes.AccessControl
using System.IO.Pipes;
using H.Pipes.AccessControl;

await using var server = new PipeServer<string>(pipeName);

// You can set PipeSecurity
var pipeSecurity = new PipeSecurity();
pipeSecurity.AddAccessRule(new PipeAccessRule(new SecurityIdentifier(WellKnownSidType.BuiltinUsersSid, null), PipeAccessRights.ReadWrite, AccessControlType.Allow));

server.SetPipeSecurity(pipeSecurity);

// or just add AccessRule's (Please be careful, the server will only consider AccessRules from the last call AddAccessRules())
server.AddAccessRules(new PipeAccessRule(new SecurityIdentifier(WellKnownSidType.BuiltinUsersSid, null), PipeAccessRights.ReadWrite, AccessControlType.Allow));

// or just
server.AllowUsersReadWrite();

Encryption

⚠️ Note: this is only available for the Windows platform

Install-Package H.Formatters.Inferno
using H.Formatters;

await using var server = new PipeServer<MyMessage>(pipeName, formatter: new SystemTextJsonFormatter());
server.EnableEncryption();

await using var client = new PipeClient<MyMessage>(pipeName, formatter: new SystemTextJsonFormatter());
client.EnableEncryption();

await client.ConnectAsync(source.Token).ConfigureAwait(false);
// Waits for key exchange.
await client.Connection!.WaitExchangeAsync();

server.ClientConnected += async (_, args) =>
{
    // Waits for key exchange.
    await args.Connection.WaitExchangeAsync();

    await args.Connection.WriteAsync(new MyMessage
    {
        Text = "Welcome!"
    }, source.Token).ConfigureAwait(false);
};

GetImpersonationUserName

server.ClientConnected += async (o, args) =>
{
    var name = args.Connection.GetImpersonationUserName();

    Console.WriteLine($"Client {name} is now connected!");
};

Inter-process communication

I recommend that you take a look at my other library if you plan on doing IPC. This is a SourceGenerator that will generate client and server code based on the presented interface.

Contacts

Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows net7.0 net7.0-android net7.0-ios net7.0-maccatalyst net7.0-macos net7.0-tvos net7.0-windows
.NET Core netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1
.NET Standard netstandard2.0 netstandard2.1
.NET Framework net451 net452 net46 net461 net462 net463 net47 net471 net472 net48 net481
MonoAndroid monoandroid
MonoMac monomac
MonoTouch monotouch
Tizen tizen40 tizen60
Xamarin.iOS xamarinios
Xamarin.Mac xamarinmac
Xamarin.TVOS xamarintvos
Xamarin.WatchOS xamarinwatchos
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on H.Formatters.BinaryFormatter:

Package Downloads
H.Pipes

Features: - Create named pipe servers that can handle multiple client connections simultaneously. - Send strongly-typed messages between clients and servers: any serializable .NET object can be sent over a pipe and will be automatically serialized/deserialized, including cyclical references and complex object graphs. - Async - Requires .NET Standard 2.0 - Supports large messages - up to 300 MiB. - Server restart automatically - Automatically wait for the release of the pipe for the server, if it is already in use - Automatically waiting for a server pipe creating when client connecting - Automatic reconnect with a given interval and at each `client.WriteAsync`, if necessary - Supports variable formatters, default - BinaryFormatter which uses System.Runtime.Serialization.BinaryFormatter inside - Also available ready formatters in separate nuget packages: H.Formatters.Json - Supports `PipeAccessRule`'s(see `H.Pipes.AccessControl` nuget package) or more complex code to access using the `PipeServer.PipeStreamInitializeAction` property

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.0.47 2,300 2/27/2023
2.0.46 226 2/26/2023
2.0.45 2,079 2/2/2023
2.0.44 3,282 1/10/2023
2.0.43 1,071 1/5/2023
2.0.42 8,452 9/14/2022
2.0.41 1,320 9/9/2022
2.0.40 1,571 8/26/2022
2.0.39 803 8/26/2022
2.0.38 9,071 6/2/2022
2.0.37 3,034 4/21/2022
2.0.35 21,521 3/17/2022
2.0.34 983 3/12/2022
2.0.33 886 3/12/2022
2.0.32 880 3/12/2022
2.0.31 1,515 3/11/2022
2.0.30 870 3/11/2022
2.0.29 886 3/11/2022
2.0.26 973 3/7/2022
2.0.25 866 3/6/2022
2.0.23 5,329 12/21/2021
2.0.22 384 12/21/2021
2.0.21 446 12/20/2021
2.0.20 395 12/20/2021
2.0.19 410 12/20/2021
2.0.18 396 12/20/2021
2.0.17 396 12/20/2021
2.0.16 398 12/20/2021
1.0.0.8 5,613 11/25/2021
1.0.0.7 6,222 11/24/2021
1.0.0.6 9,880 1/4/2021
1.0.0.5 7,846 12/9/2020
1.0.0.4 482 12/9/2020
1.0.0.3 2,289 11/22/2020
1.0.0.2 2,338 8/4/2020
1.0.0.1 4,766 1/28/2020
1.0.0 2,174 1/10/2020

⭐ Last 10 features:
- feat: Added PipeApplication.StartAsync(args). 2023-02-27
- feat: Added IPipeClient.CreatePipeStreamFunc. Closes #29. 2023-02-02
- feat: Added ability to set up CerasFormatter.InternalFormatter. 2023-01-10
- feat: To net7.0. Updated NuGet packages. 2023-01-05
- feat: Updated H.Pipes.AccessControl to use official net5/net6 PipeSecurity implementation. 2022-09-09
- feat: Added BinaryFormatter.InternalFormatter as public property. 2022-03-18
- feat(AccessControl): Enabled PipeApplication.StartAsync for non-windows system without AllowUsersReadWrite. 2022-03-12
- feat(Inferno): Added net5/net6 targets. Added SupportedOSPlatform attributes. 2022-03-12
- feat(Inferno): Added EnableEncryption optional exception action. 2022-03-12
- feat(AccessControl): Added SupportedOSPlatform attribute to SetPipeSecurity. 2022-03-11

🐞 Last 10 bug fixes:
- fix: Now EventExtensions is internal class. 2023-02-26
- fix: Fixed Connection.Disconnected unhandled exception bug. 2022-09-14
- fix: Fixed SemaphoreSlim usage. Fixes #24. 2022-08-26
- fix: Fixes #24. 2022-08-26
- fix: Added IOException ignoring for FlushAsync/WaitForPipeDrain. 2022-06-02
- fix: Fixed missing PipeStreamReader read check. Refactored. 2022-04-21
- fix(AccessControl): Fixed NET461 library to use Net Framework NamedPipeServerStream ctor. 2022-03-11
- fix: Fixed ValidatePublicKey. 2022-03-07
- fix: Fixed PipeClient.Connection set access. 2021-12-21
- fix: Fixed problem with multiple server encrypted connections. 2021-12-20