H.Pipes.AccessControl 2.0.15

There is a newer version of this package available.
See the version list below for details.
dotnet add package H.Pipes.AccessControl --version 2.0.15
NuGet\Install-Package H.Pipes.AccessControl -Version 2.0.15
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.Pipes.AccessControl" Version="2.0.15" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add H.Pipes.AccessControl --version 2.0.15
#r "nuget: H.Pipes.AccessControl, 2.0.15"
#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.Pipes.AccessControl as a Cake Addin
#addin nuget:?package=H.Pipes.AccessControl&version=2.0.15

// Install H.Pipes.AccessControl as a Cake Tool
#tool nuget:?package=H.Pipes.AccessControl&version=2.0.15

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);

P.S. To use the server inside the WinForms application, use Task.Run(). This creates a new thread for it.

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);

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

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();

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. It is based on this library, but provides an IPC implementation based on C# interfaces. It supports remote method invocation, asynchronous methods, cancellation via CancellationToken, events, and so on.

Contacts

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

NuGet packages (4)

Showing the top 4 NuGet packages that depend on H.Pipes.AccessControl:

Package Downloads
H.Services.IpcService

Package Description

H.Ipc.Generator

C# Source Generator for Inter-Process Communication.

H.VpnService

C# high-level VPN library with implemented IPC

H.Ipc

Core library for Inter-Process Communication.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.1.0-dev.322 77 1/20/2024
2.1.0-dev.318 109 12/18/2023
2.0.59 7,095 12/8/2023
2.0.56 804 11/27/2023
2.0.53 7,680 7/24/2023
2.0.51 4,585 5/25/2023
2.0.47 4,586 2/27/2023
2.0.46 228 2/26/2023
2.0.45 2,951 2/2/2023
2.0.44 5,942 1/10/2023
2.0.43 664 1/5/2023
2.0.42 5,901 9/14/2022
2.0.41 863 9/9/2022
2.0.40 429 8/26/2022
2.0.39 380 8/26/2022
2.0.38 2,779 6/2/2022
2.0.37 1,302 4/21/2022
2.0.35 1,989 3/17/2022
2.0.34 502 3/12/2022
2.0.33 432 3/12/2022
2.0.32 428 3/12/2022
2.0.31 1,319 3/11/2022
2.0.30 429 3/11/2022
2.0.29 429 3/11/2022
2.0.26 440 3/7/2022
2.0.25 422 3/6/2022
2.0.23 2,063 12/21/2021
2.0.22 276 12/21/2021
2.0.21 278 12/20/2021
2.0.20 258 12/20/2021
2.0.19 273 12/20/2021
2.0.18 281 12/20/2021
2.0.17 285 12/20/2021
2.0.16 272 12/20/2021
2.0.15 270 12/20/2021
2.0.14 680 12/5/2021
2.0.13 276 12/5/2021
1.15.12 310 12/5/2021
1.15.11 1,026 11/29/2021
1.15.10 3,240 11/25/2021
1.15.9 3,582 11/25/2021
1.15.8 2,567 11/25/2021
1.15.7 2,545 11/25/2021
1.15.6 3,749 11/24/2021
1.15.4 5,682 11/24/2021
1.15.2 392 10/22/2021
1.15.1 308 10/22/2021
1.14.8 3,707 1/4/2021
1.14.7 3,054 12/15/2020
1.14.6 397 12/9/2020
1.14.5 386 12/9/2020
1.14.4 443 11/22/2020
1.14.2 377 11/22/2020
1.14.1.4 467 10/16/2020
1.14.1.3 1,718 10/13/2020
1.14.1.2 454 10/12/2020
1.14.1 448 10/8/2020
1.14.0 494 10/8/2020
1.13.4 507 10/8/2020
1.13.3 454 7/12/2020
1.13.2 484 7/12/2020
1.13.1 480 7/5/2020
1.13.0 487 5/20/2020
1.12.3.2 468 5/19/2020
1.12.3.1 470 4/23/2020
1.12.3 459 2/2/2020
1.12.2 503 2/1/2020
1.12.1 517 2/1/2020
1.0.12 502 1/29/2020
1.0.11 524 1/28/2020
1.0.10 467 1/28/2020
1.0.9 451 1/14/2020
1.0.8 463 1/14/2020
1.0.7.1 534 1/12/2020
1.0.7 594 1/12/2020
1.0.6.1 529 1/11/2020
1.0.6 602 1/10/2020

⭐ Last 10 features:
- feat: Deleted Connection Id and Name properties. Added PipeName and ServerName properties. 2021-12-06
- feat: Replaces NextPipeId to Guid.NewGuid. 2021-12-06
- feat: Added public PipeConnection.PipeStream property. 2021-11-26
- feat: Updated README. 2021-11-25
- feat: Added PipeConnection.GetImpersonationUserName method. 2021-11-25
- feat: Added H.Formatters.System.Text.Json library. 2021-11-25
- feat: Renamed H.Formatters.Json to Newtonsoft.Json. 2021-11-25
- feat: Updated README. 2021-11-25
- feat: Added CerasFormatter package. 2021-11-25
- feat: Changed minimal requiments to .NET Framework 4.5.1. 2021-11-25

🐞 Last 10 bug fixes:
- fix: Fixed some MessagePack formatter issues. 2021-12-20
- fix: Fixed PipeServer PipeConnection PipeName. 2021-12-06
- fix: Fixed tags. 2021-11-30
- fix: Updated Formatter packages to fix bug with IAsyncFormatter. 2021-11-26
- fix: Fixed await using ConfigureAwait(false) missing bug. 2021-10-22
- fix: Fixed H.Pipes.AccessControl warnings. 2021-10-22