// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
// See the LICENSE file in the project root for more information.

using System;
using System.ComponentModel;
using System.Diagnostics.CodeAnalysis;
using System.IO;
using System.Runtime.InteropServices;
using System.Threading;

namespace CommunityToolkit.Diagnostics;

/// <summary>
/// Helper methods to efficiently throw exceptions.
/// </summary>
public static partial class ThrowHelper
{
    /// <summary>
    /// Throws a new <see cref="ArrayTypeMismatchException"/>.
    /// </summary>
    /// <exception cref="ArrayTypeMismatchException">Thrown with no parameters.</exception>
    [DoesNotReturn]
    public static void ThrowArrayTypeMismatchException()
    {
        throw new ArrayTypeMismatchException();
    }

    /// <summary>
    /// Throws a new <see cref="ArrayTypeMismatchException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <exception cref="ArrayTypeMismatchException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowArrayTypeMismatchException(string? message)
    {
        throw new ArrayTypeMismatchException(message);
    }

    /// <summary>
    /// Throws a new <see cref="ArrayTypeMismatchException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <param name="innerException">The inner <see cref="Exception"/> to include.</param>
    /// <exception cref="ArrayTypeMismatchException">Thrown with the specified parameters.</exception>
    [DoesNotReturn]
    public static void ThrowArrayTypeMismatchException(string? message, Exception? innerException)
    {
        throw new ArrayTypeMismatchException(message, innerException);
    }

    /// <summary>
    /// Throws a new <see cref="ArgumentException"/>.
    /// </summary>
    /// <exception cref="ArgumentException">Thrown with no parameters.</exception>
    [DoesNotReturn]
    public static void ThrowArgumentException()
    {
        throw new ArgumentException();
    }

    /// <summary>
    /// Throws a new <see cref="ArgumentException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <exception cref="ArgumentException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowArgumentException(string? message)
    {
        throw new ArgumentException(message);
    }

    /// <summary>
    /// Throws a new <see cref="ArgumentException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <param name="innerException">The inner <see cref="Exception"/> to include.</param>
    /// <exception cref="ArgumentException">Thrown with the specified parameters.</exception>
    [DoesNotReturn]
    public static void ThrowArgumentException(string? message, Exception? innerException)
    {
        throw new ArgumentException(message, innerException);
    }

    /// <summary>
    /// Throws a new <see cref="ArgumentException"/>.
    /// </summary>
    /// <param name="name">The argument name.</param>
    /// <param name="message">The message to include in the exception.</param>
    /// <exception cref="ArgumentException">Thrown with the specified parameters.</exception>
    [DoesNotReturn]
    public static void ThrowArgumentException(string? name, string? message)
    {
        throw new ArgumentException(message, name);
    }

    /// <summary>
    /// Throws a new <see cref="ArgumentException"/>.
    /// </summary>
    /// <param name="name">The argument name.</param>
    /// <param name="message">The message to include in the exception.</param>
    /// <param name="innerException">The inner <see cref="Exception"/> to include.</param>
    /// <exception cref="ArgumentException">Thrown with the specified parameters.</exception>
    [DoesNotReturn]
    public static void ThrowArgumentException(string? name, string? message, Exception? innerException)
    {
        throw new ArgumentException(message, name, innerException);
    }

    /// <summary>
    /// Throws a new <see cref="ArgumentNullException"/>.
    /// </summary>
    /// <exception cref="ArgumentNullException">Thrown with no parameters.</exception>
    [DoesNotReturn]
    public static void ThrowArgumentNullException()
    {
        throw new ArgumentNullException();
    }

    /// <summary>
    /// Throws a new <see cref="ArgumentNullException"/>.
    /// </summary>
    /// <param name="name">The argument name.</param>
    /// <exception cref="ArgumentNullException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowArgumentNullException(string? name)
    {
        throw new ArgumentNullException(name);
    }

    /// <summary>
    /// Throws a new <see cref="ArgumentNullException"/>.
    /// </summary>
    /// <param name="name">The argument name.</param>
    /// <param name="innerException">The inner <see cref="Exception"/> to include.</param>
    /// <exception cref="ArgumentNullException">Thrown with the specified parameters.</exception>
    [DoesNotReturn]
    public static void ThrowArgumentNullException(string? name, Exception? innerException)
    {
        throw new ArgumentNullException(name, innerException);
    }

    /// <summary>
    /// Throws a new <see cref="ArgumentNullException"/>.
    /// </summary>
    /// <param name="name">The argument name.</param>
    /// <param name="message">The message to include in the exception.</param>
    /// <exception cref="ArgumentNullException">Thrown with the specified parameters.</exception>
    [DoesNotReturn]
    public static void ThrowArgumentNullException(string? name, string? message)
    {
        throw new ArgumentNullException(name, message);
    }

    /// <summary>
    /// Throws a new <see cref="ArgumentOutOfRangeException"/>.
    /// </summary>
    /// <exception cref="ArgumentOutOfRangeException">Thrown with no parameters.</exception>
    [DoesNotReturn]
    public static void ThrowArgumentOutOfRangeException()
    {
        throw new ArgumentOutOfRangeException();
    }

    /// <summary>
    /// Throws a new <see cref="ArgumentOutOfRangeException"/>.
    /// </summary>
    /// <param name="name">The argument name.</param>
    /// <exception cref="ArgumentOutOfRangeException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowArgumentOutOfRangeException(string? name)
    {
        throw new ArgumentOutOfRangeException(name);
    }

    /// <summary>
    /// Throws a new <see cref="ArgumentOutOfRangeException"/>.
    /// </summary>
    /// <param name="name">The argument name.</param>
    /// <param name="innerException">The inner <see cref="Exception"/> to include.</param>
    /// <exception cref="ArgumentOutOfRangeException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowArgumentOutOfRangeException(string? name, Exception? innerException)
    {
        throw new ArgumentOutOfRangeException(name, innerException);
    }

    /// <summary>
    /// Throws a new <see cref="ArgumentOutOfRangeException"/>.
    /// </summary>
    /// <param name="name">The argument name.</param>
    /// <param name="message">The message to include in the exception.</param>
    /// <exception cref="ArgumentOutOfRangeException">Thrown with the specified parameters.</exception>
    [DoesNotReturn]
    public static void ThrowArgumentOutOfRangeException(string? name, string? message)
    {
        throw new ArgumentOutOfRangeException(name, message);
    }

    /// <summary>
    /// Throws a new <see cref="ArgumentOutOfRangeException"/>.
    /// </summary>
    /// <param name="name">The argument name.</param>
    /// <param name="value">The current argument value.</param>
    /// <param name="message">The message to include in the exception.</param>
    /// <exception cref="ArgumentOutOfRangeException">Thrown with the specified parameters.</exception>
    [DoesNotReturn]
    public static void ThrowArgumentOutOfRangeException(string? name, object? value, string? message)
    {
        throw new ArgumentOutOfRangeException(name, value, message);
    }

    /// <summary>
    /// Throws a new <see cref="COMException"/>.
    /// </summary>
    /// <exception cref="COMException">Thrown with no parameters.</exception>
    [DoesNotReturn]
    public static void ThrowCOMException()
    {
        throw new COMException();
    }

    /// <summary>
    /// Throws a new <see cref="COMException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <exception cref="COMException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowCOMException(string? message)
    {
        throw new COMException(message);
    }

    /// <summary>
    /// Throws a new <see cref="COMException"/>.
    /// </summary>
    /// <param name="message">The argument name.</param>
    /// <param name="innerException">The inner <see cref="Exception"/> to include.</param>
    /// <exception cref="COMException">Thrown with the specified parameters.</exception>
    [DoesNotReturn]
    public static void ThrowCOMException(string? message, Exception? innerException)
    {
        throw new COMException(message, innerException);
    }

    /// <summary>
    /// Throws a new <see cref="COMException"/>.
    /// </summary>
    /// <param name="message">The argument name.</param>
    /// <param name="error">The HRESULT of the error to include.</param>
    /// <exception cref="COMException">Thrown with the specified parameters.</exception>
    [DoesNotReturn]
    public static void ThrowCOMException(string? message, int error)
    {
        throw new COMException(message, error);
    }

    /// <summary>
    /// Throws a new <see cref="ExternalException"/>.
    /// </summary>
    /// <exception cref="ExternalException">Thrown with no parameters.</exception>
    [DoesNotReturn]
    public static void ThrowExternalException()
    {
        throw new ExternalException();
    }

    /// <summary>
    /// Throws a new <see cref="ExternalException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <exception cref="ExternalException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowExternalException(string? message)
    {
        throw new ExternalException(message);
    }

    /// <summary>
    /// Throws a new <see cref="ExternalException"/>.
    /// </summary>
    /// <param name="message">The argument name.</param>
    /// <param name="innerException">The inner <see cref="Exception"/> to include.</param>
    /// <exception cref="ExternalException">Thrown with the specified parameters.</exception>
    [DoesNotReturn]
    public static void ThrowExternalException(string? message, Exception? innerException)
    {
        throw new ExternalException(message, innerException);
    }

    /// <summary>
    /// Throws a new <see cref="ExternalException"/>.
    /// </summary>
    /// <param name="message">The argument name.</param>
    /// <param name="error">The HRESULT of the error to include.</param>
    /// <exception cref="ExternalException">Thrown with the specified parameters.</exception>
    [DoesNotReturn]
    public static void ThrowExternalException(string? message, int error)
    {
        throw new ExternalException(message, error);
    }

    /// <summary>
    /// Throws a new <see cref="FormatException"/>.
    /// </summary>
    /// <exception cref="FormatException">Thrown with no parameters.</exception>
    [DoesNotReturn]
    public static void ThrowFormatException()
    {
        throw new FormatException();
    }

    /// <summary>
    /// Throws a new <see cref="FormatException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <exception cref="FormatException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowFormatException(string? message)
    {
        throw new FormatException(message);
    }

    /// <summary>
    /// Throws a new <see cref="FormatException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <param name="innerException">The inner <see cref="Exception"/> to include.</param>
    /// <exception cref="FormatException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowFormatException(string? message, Exception? innerException)
    {
        throw new FormatException(message, innerException);
    }

    /// <summary>
    /// Throws a new <see cref="InsufficientMemoryException"/>.
    /// </summary>
    /// <exception cref="InsufficientMemoryException">Thrown with no parameters.</exception>
    [DoesNotReturn]
    public static void ThrowInsufficientMemoryException()
    {
        throw new InsufficientMemoryException();
    }

    /// <summary>
    /// Throws a new <see cref="InsufficientMemoryException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <exception cref="InsufficientMemoryException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowInsufficientMemoryException(string? message)
    {
        throw new InsufficientMemoryException(message);
    }

    /// <summary>
    /// Throws a new <see cref="InsufficientMemoryException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <param name="innerException">The inner <see cref="Exception"/> to include.</param>
    /// <exception cref="InsufficientMemoryException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowInsufficientMemoryException(string? message, Exception? innerException)
    {
        throw new InsufficientMemoryException(message, innerException);
    }

    /// <summary>
    /// Throws a new <see cref="InvalidDataException"/>.
    /// </summary>
    /// <exception cref="InvalidDataException">Thrown with no parameters.</exception>
    [DoesNotReturn]
    public static void ThrowInvalidDataException()
    {
        throw new InvalidDataException();
    }

    /// <summary>
    /// Throws a new <see cref="InvalidDataException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <exception cref="InvalidDataException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowInvalidDataException(string? message)
    {
        throw new InvalidDataException(message);
    }

    /// <summary>
    /// Throws a new <see cref="InvalidDataException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <param name="innerException">The inner <see cref="Exception"/> to include.</param>
    /// <exception cref="InvalidDataException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowInvalidDataException(string? message, Exception? innerException)
    {
        throw new InvalidDataException(message, innerException);
    }

    /// <summary>
    /// Throws a new <see cref="InvalidOperationException"/>.
    /// </summary>
    /// <exception cref="InvalidOperationException">Thrown with no parameters.</exception>
    [DoesNotReturn]
    public static void ThrowInvalidOperationException()
    {
        throw new InvalidOperationException();
    }

    /// <summary>
    /// Throws a new <see cref="InvalidOperationException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <exception cref="InvalidOperationException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowInvalidOperationException(string? message)
    {
        throw new InvalidOperationException(message);
    }

    /// <summary>
    /// Throws a new <see cref="InvalidOperationException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <param name="innerException">The inner <see cref="Exception"/> to include.</param>
    /// <exception cref="InvalidOperationException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowInvalidOperationException(string? message, Exception? innerException)
    {
        throw new InvalidOperationException(message, innerException);
    }

    /// <summary>
    /// Throws a new <see cref="LockRecursionException"/>.
    /// </summary>
    /// <exception cref="LockRecursionException">Thrown with no parameters.</exception>
    [DoesNotReturn]
    public static void ThrowLockRecursionException()
    {
        throw new LockRecursionException();
    }

    /// <summary>
    /// Throws a new <see cref="LockRecursionException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <exception cref="LockRecursionException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowLockRecursionException(string? message)
    {
        throw new LockRecursionException(message);
    }

    /// <summary>
    /// Throws a new <see cref="LockRecursionException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <param name="innerException">The inner <see cref="Exception"/> to include.</param>
    /// <exception cref="LockRecursionException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowLockRecursionException(string? message, Exception? innerException)
    {
        throw new LockRecursionException(message, innerException);
    }

    /// <summary>
    /// Throws a new <see cref="MissingFieldException"/>.
    /// </summary>
    /// <exception cref="MissingFieldException">Thrown with no parameters.</exception>
    [DoesNotReturn]
    public static void ThrowMissingFieldException()
    {
        throw new MissingFieldException();
    }

    /// <summary>
    /// Throws a new <see cref="MissingFieldException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <exception cref="MissingFieldException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowMissingFieldException(string? message)
    {
        throw new MissingFieldException(message);
    }

    /// <summary>
    /// Throws a new <see cref="MissingFieldException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <param name="innerException">The inner <see cref="Exception"/> to include.</param>
    /// <exception cref="MissingFieldException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowMissingFieldException(string? message, Exception? innerException)
    {
        throw new MissingFieldException(message, innerException);
    }

    /// <summary>
    /// Throws a new <see cref="MissingFieldException"/>.
    /// </summary>
    /// <param name="className">The target class being inspected.</param>
    /// <param name="fieldName">The target field being retrieved.</param>
    /// <exception cref="MissingFieldException">Thrown with the specified parameters.</exception>
    [DoesNotReturn]
    public static void ThrowMissingFieldException(string? className, string? fieldName)
    {
        throw new MissingFieldException(className, fieldName);
    }

    /// <summary>
    /// Throws a new <see cref="MissingMemberException"/>.
    /// </summary>
    /// <exception cref="MissingMemberException">Thrown with no parameters.</exception>
    [DoesNotReturn]
    public static void ThrowMissingMemberException()
    {
        throw new MissingMemberException();
    }

    /// <summary>
    /// Throws a new <see cref="MissingMemberException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <exception cref="MissingMemberException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowMissingMemberException(string? message)
    {
        throw new MissingMemberException(message);
    }

    /// <summary>
    /// Throws a new <see cref="MissingMemberException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <param name="innerException">The inner <see cref="Exception"/> to include.</param>
    /// <exception cref="MissingMemberException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowMissingMemberException(string? message, Exception? innerException)
    {
        throw new MissingMemberException(message, innerException);
    }

    /// <summary>
    /// Throws a new <see cref="MissingMemberException"/>.
    /// </summary>
    /// <param name="className">The target class being inspected.</param>
    /// <param name="memberName">The target member being retrieved.</param>
    /// <exception cref="MissingMemberException">Thrown with the specified parameters.</exception>
    [DoesNotReturn]
    public static void ThrowMissingMemberException(string? className, string? memberName)
    {
        throw new MissingMemberException(className, memberName);
    }

    /// <summary>
    /// Throws a new <see cref="MissingMethodException"/>.
    /// </summary>
    /// <exception cref="MissingMethodException">Thrown with no parameters.</exception>
    [DoesNotReturn]
    public static void ThrowMissingMethodException()
    {
        throw new MissingMethodException();
    }

    /// <summary>
    /// Throws a new <see cref="MissingMethodException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <exception cref="MissingMethodException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowMissingMethodException(string? message)
    {
        throw new MissingMethodException(message);
    }

    /// <summary>
    /// Throws a new <see cref="MissingMethodException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <param name="innerException">The inner <see cref="Exception"/> to include.</param>
    /// <exception cref="MissingMethodException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowMissingMethodException(string? message, Exception? innerException)
    {
        throw new MissingMethodException(message, innerException);
    }

    /// <summary>
    /// Throws a new <see cref="MissingMethodException"/>.
    /// </summary>
    /// <param name="className">The target class being inspected.</param>
    /// <param name="methodName">The target method being retrieved.</param>
    /// <exception cref="MissingMethodException">Thrown with the specified parameters.</exception>
    [DoesNotReturn]
    public static void ThrowMissingMethodException(string? className, string? methodName)
    {
        throw new MissingMethodException(className, methodName);
    }

    /// <summary>
    /// Throws a new <see cref="NotSupportedException"/>.
    /// </summary>
    /// <exception cref="NotSupportedException">Thrown with no parameters.</exception>
    [DoesNotReturn]
    public static void ThrowNotSupportedException()
    {
        throw new NotSupportedException();
    }

    /// <summary>
    /// Throws a new <see cref="NotSupportedException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <exception cref="NotSupportedException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowNotSupportedException(string? message)
    {
        throw new NotSupportedException(message);
    }

    /// <summary>
    /// Throws a new <see cref="NotSupportedException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <param name="innerException">The inner <see cref="Exception"/> to include.</param>
    /// <exception cref="NotSupportedException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowNotSupportedException(string? message, Exception? innerException)
    {
        throw new NotSupportedException(message, innerException);
    }

    /// <summary>
    /// Throws a new <see cref="ObjectDisposedException"/>.
    /// </summary>
    /// <param name="objectName">The name of the disposed object.</param>
    /// <exception cref="ObjectDisposedException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowObjectDisposedException(string? objectName)
    {
        throw new ObjectDisposedException(objectName);
    }

    /// <summary>
    /// Throws a new <see cref="ObjectDisposedException"/>.
    /// </summary>
    /// <param name="objectName">The name of the disposed object.</param>
    /// <param name="innerException">The inner <see cref="Exception"/> to include.</param>
    /// <exception cref="ObjectDisposedException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowObjectDisposedException(string? objectName, Exception? innerException)
    {
        throw new ObjectDisposedException(objectName, innerException);
    }

    /// <summary>
    /// Throws a new <see cref="ObjectDisposedException"/>.
    /// </summary>
    /// <param name="objectName">The name of the disposed object.</param>
    /// <param name="message">The message to include in the exception.</param>
    /// <exception cref="ObjectDisposedException">Thrown with the specified parameters.</exception>
    [DoesNotReturn]
    public static void ThrowObjectDisposedException(string? objectName, string? message)
    {
        throw new ObjectDisposedException(objectName, message);
    }

    /// <summary>
    /// Throws a new <see cref="OperationCanceledException"/>.
    /// </summary>
    /// <exception cref="OperationCanceledException">Thrown with no parameters.</exception>
    [DoesNotReturn]
    public static void ThrowOperationCanceledException()
    {
        throw new OperationCanceledException();
    }

    /// <summary>
    /// Throws a new <see cref="OperationCanceledException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <exception cref="OperationCanceledException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowOperationCanceledException(string? message)
    {
        throw new OperationCanceledException(message);
    }

    /// <summary>
    /// Throws a new <see cref="OperationCanceledException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <param name="innerException">The inner <see cref="Exception"/> to include.</param>
    /// <exception cref="OperationCanceledException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowOperationCanceledException(string? message, Exception? innerException)
    {
        throw new OperationCanceledException(message, innerException);
    }

    /// <summary>
    /// Throws a new <see cref="OperationCanceledException"/>.
    /// </summary>
    /// <param name="token">The <see cref="CancellationToken"/> in use.</param>
    /// <exception cref="OperationCanceledException">Thrown with the specified parameters.</exception>
    [DoesNotReturn]
    public static void ThrowOperationCanceledException(CancellationToken token)
    {
        throw new OperationCanceledException(token);
    }

    /// <summary>
    /// Throws a new <see cref="OperationCanceledException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <param name="token">The <see cref="CancellationToken"/> in use.</param>
    /// <exception cref="OperationCanceledException">Thrown with the specified parameters.</exception>
    [DoesNotReturn]
    public static void ThrowOperationCanceledException(string? message, CancellationToken token)
    {
        throw new OperationCanceledException(message, token);
    }

    /// <summary>
    /// Throws a new <see cref="OperationCanceledException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <param name="innerException">The inner <see cref="Exception"/> to include.</param>
    /// <param name="token">The <see cref="CancellationToken"/> in use.</param>
    /// <exception cref="OperationCanceledException">Thrown with the specified parameters.</exception>
    [DoesNotReturn]
    public static void ThrowOperationCanceledException(string? message, Exception? innerException, CancellationToken token)
    {
        throw new OperationCanceledException(message, innerException, token);
    }

    /// <summary>
    /// Throws a new <see cref="PlatformNotSupportedException"/>.
    /// </summary>
    /// <exception cref="PlatformNotSupportedException">Thrown with no parameters.</exception>
    [DoesNotReturn]
    public static void ThrowPlatformNotSupportedException()
    {
        throw new PlatformNotSupportedException();
    }

    /// <summary>
    /// Throws a new <see cref="PlatformNotSupportedException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <exception cref="PlatformNotSupportedException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowPlatformNotSupportedException(string? message)
    {
        throw new PlatformNotSupportedException(message);
    }

    /// <summary>
    /// Throws a new <see cref="PlatformNotSupportedException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <param name="innerException">The inner <see cref="Exception"/> to include.</param>
    /// <exception cref="PlatformNotSupportedException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowPlatformNotSupportedException(string? message, Exception? innerException)
    {
        throw new PlatformNotSupportedException(message, innerException);
    }

    /// <summary>
    /// Throws a new <see cref="SynchronizationLockException"/>.
    /// </summary>
    /// <exception cref="SynchronizationLockException">Thrown with no parameters.</exception>
    [DoesNotReturn]
    public static void ThrowSynchronizationLockException()
    {
        throw new SynchronizationLockException();
    }

    /// <summary>
    /// Throws a new <see cref="SynchronizationLockException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <exception cref="SynchronizationLockException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowSynchronizationLockException(string? message)
    {
        throw new SynchronizationLockException(message);
    }

    /// <summary>
    /// Throws a new <see cref="SynchronizationLockException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <param name="innerException">The inner <see cref="Exception"/> to include.</param>
    /// <exception cref="SynchronizationLockException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowSynchronizationLockException(string? message, Exception? innerException)
    {
        throw new SynchronizationLockException(message, innerException);
    }

    /// <summary>
    /// Throws a new <see cref="TimeoutException"/>.
    /// </summary>
    /// <exception cref="TimeoutException">Thrown with no parameters.</exception>
    [DoesNotReturn]
    public static void ThrowTimeoutException()
    {
        throw new TimeoutException();
    }

    /// <summary>
    /// Throws a new <see cref="TimeoutException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <exception cref="TimeoutException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowTimeoutException(string? message)
    {
        throw new TimeoutException(message);
    }

    /// <summary>
    /// Throws a new <see cref="TimeoutException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <param name="innerException">The inner <see cref="Exception"/> to include.</param>
    /// <exception cref="TimeoutException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowTimeoutException(string? message, Exception? innerException)
    {
        throw new TimeoutException(message, innerException);
    }

    /// <summary>
    /// Throws a new <see cref="UnauthorizedAccessException"/>.
    /// </summary>
    /// <exception cref="UnauthorizedAccessException">Thrown with no parameters.</exception>
    [DoesNotReturn]
    public static void ThrowUnauthorizedAccessException()
    {
        throw new UnauthorizedAccessException();
    }

    /// <summary>
    /// Throws a new <see cref="UnauthorizedAccessException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <exception cref="UnauthorizedAccessException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowUnauthorizedAccessException(string? message)
    {
        throw new UnauthorizedAccessException(message);
    }

    /// <summary>
    /// Throws a new <see cref="UnauthorizedAccessException"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <param name="innerException">The inner <see cref="Exception"/> to include.</param>
    /// <exception cref="UnauthorizedAccessException">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowUnauthorizedAccessException(string? message, Exception? innerException)
    {
        throw new UnauthorizedAccessException(message, innerException);
    }

    /// <summary>
    /// Throws a new <see cref="Win32Exception"/>.
    /// </summary>
    /// <exception cref="Win32Exception">Thrown with no parameters.</exception>
    [DoesNotReturn]
    public static void ThrowWin32Exception()
    {
        throw new Win32Exception();
    }

    /// <summary>
    /// Throws a new <see cref="Win32Exception"/>.
    /// </summary>
    /// <param name="error">The Win32 error code associated with this exception.</param>
    /// <exception cref="Win32Exception">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowWin32Exception(int error)
    {
        throw new Win32Exception(error);
    }

    /// <summary>
    /// Throws a new <see cref="Win32Exception"/>.
    /// </summary>
    /// <param name="error">The Win32 error code associated with this exception.</param>
    /// <param name="message">The message to include in the exception.</param>
    /// <exception cref="Win32Exception">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowWin32Exception(int error, string? message)
    {
        throw new Win32Exception(error, message);
    }

    /// <summary>
    /// Throws a new <see cref="Win32Exception"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <exception cref="Win32Exception">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowWin32Exception(string? message)
    {
        throw new Win32Exception(message);
    }

    /// <summary>
    /// Throws a new <see cref="Win32Exception"/>.
    /// </summary>
    /// <param name="message">The message to include in the exception.</param>
    /// <param name="innerException">The inner <see cref="Exception"/> to include.</param>
    /// <exception cref="Win32Exception">Thrown with the specified parameter.</exception>
    [DoesNotReturn]
    public static void ThrowWin32Exception(string? message, Exception? innerException)
    {
        throw new Win32Exception(message, innerException);
    }
}