Ignore CancellationToken parameters by default

I can’t find a way to flag a parameter on my method to exclude the CancellationToken parameter from generating in the documentation.

I propose a convention of ignoring this type of parameter during generation.

[dementeddevil]

Finally found out why my controller wasn’t working and this was it - just spent all weekend trying to get this going.

If you are using swashbuckle v6 and ASP.NET 5 then the code you need differs slightly from the above sample.

The code below was what I had to use to get things going…

    public class SwaggerRemoveCancellationTokenParameterFilter : IOperationFilter
    {
        public void Apply(Operation operation, OperationFilterContext context)
        {
            context.ApiDescription.ParameterDescriptions
                .Where(pd =>
                    pd.ModelMetadata.ContainerType == typeof(CancellationToken) ||
                    pd.ModelMetadata.ContainerType == typeof(WaitHandle) ||
                    pd.ModelMetadata.ContainerType == typeof(SafeWaitHandle))
                .ToList()
                .ForEach(
                    pd =>
                    {
                        if (operation.Parameters != null)
                        {
                            var cancellationTokenParameter = operation.Parameters.Single(p => p.Name == pd.Name);
                            operation.Parameters.Remove(cancellationTokenParameter);
                        }
                    });
        }
    }

[domaindrivendev]

Fixed by 7ab9b842c5ad068dd7115a102bed45559133e0a6. Will automatically ignore parameters of type CancellationToken without the need for custom filters.