Jozkee

namespace System.IO;

public abstract class NewStream : Stream
{
    private bool _disposed;

    public sealed override int Read(byte[] buffer, int offset, int count)
    {
        ValidateBufferArguments(buffer, offset, count);
        return Read(buffer.AsSpan(offset, count));

Jozkee

public abstract class Stream2022 : Stream
{
    public sealed override int Read(byte[] buffer, int offset, int count)
        => Read(buffer.AsSpan(offset, count));

    public abstract override int Read(Span<byte> buffer);

    public sealed override Task<int> ReadAsync(byte[] buffer, int offset, int count, CancellationToken cancellationToken)
        => ReadAsync(buffer.AsMemory(offset, count), cancellationToken).AsTask();

Jozkee

Legend

• Statistical Test threshold: 10%, the noise filter: 2 ns
• Result is conclusion: Slower|Faster|Same|Noise|Unknown. Noise means that the difference was larger than 10% but not 2 ns.
• Ratio = Base/Diff (the higher the better).
• Alloc Delta = Allocated bytes diff - Allocated bytes base (the lower the better)

Statistics

Total: 86862

Jozkee

public class TempWorkingDirectory
{
    string _directory;
    public TempWorkingDirectory(string directory)
    {
        _directory = directory;
    }

    public void CreateFile(string filepath)
    {

Jozkee

How to install

1. Add dotnet7 nuget feed (https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet7/nuget/v3/index.json) in your Package Sources.
2. Search and install System.Security.Cryptography.Cose. Don't forget to check the "Include prerelease" checkbox.

Encode and Sign

using System.Security.Cryptography;

Jozkee

// Assuming that you have a list of `Employee`s and you have to serialize each one individually 
// and you also want to take advantage of the references saved in the `ReferenceHandler`'s resolver.
using System;
using System.Collections.Generic;
using System.Text.Json;
using System.Text.Json.Serialization;

namespace ConsoleApp4
{
    class Program

Jozkee

// Assuming that you wrote a custom converter for `Company` and you don't want to manually serialize the `Supervisor`, which is an `Employee`. 
// you want to delegate that to the Serializer and you also want to preserve the references that you have already saved.

using System;
using System.Collections.Generic;
using System.Text.Json;
using System.Text.Json.Serialization;

namespace ConsoleApp4
{

Jozkee

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>netcoreapp3.1</TargetFramework>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="System.Text.Json" Version="5.0.0-preview.2.20160.6" />
  </ItemGroup>

Jozkee

Handle output created from Serializing an object using Preserve References Handling

This specification describes the mechanism to handle payloads that contain metadata properties ($id, $ref & $values) written on a serialization with Preserved References Handling turned on.

Circular references occur when a property of the object refers to the object itself, directly (a -> a) or indirectly (a -> b -> a).

Multiple ocurrences of the same reference does not imply circularity.

The goal of this specification is to define the boundaries of the Reference Handling feature when opting-in for Preserve References.

Other libraries