Merge pull request #7396 from carlossanlop/ApiDiffPrev3

API-diff between 7.0-preview2 and 7.0-preview3

release-notes/7.0/preview/api-diff/preview3/Microsoft.AspNetCore.App/7.0-preview3.md

@@ -0,0 +1,16 @@
+# API Difference 7.0-preview2 vs 7.0-preview3
+
+API listing follows standard diff formatting.
+Lines preceded by a '+' are additions and a '-' indicates removal.
+
+* [Microsoft.AspNetCore.Http](7.0-preview3_Microsoft.AspNetCore.Http.md)
+* [Microsoft.AspNetCore.Mvc](7.0-preview3_Microsoft.AspNetCore.Mvc.md)
+* [Microsoft.AspNetCore.Mvc.ModelBinding.Binders](7.0-preview3_Microsoft.AspNetCore.Mvc.ModelBinding.Binders.md)
+* [Microsoft.AspNetCore.Routing](7.0-preview3_Microsoft.AspNetCore.Routing.md)
+* [Microsoft.Extensions.Caching.Memory](7.0-preview3_Microsoft.Extensions.Caching.Memory.md)
+* [Microsoft.Extensions.Configuration](7.0-preview3_Microsoft.Extensions.Configuration.md)
+* [Microsoft.Extensions.FileSystemGlobbing.Internal.PatternContexts](7.0-preview3_Microsoft.Extensions.FileSystemGlobbing.Internal.PatternContexts.md)
+* [Microsoft.Extensions.Hosting](7.0-preview3_Microsoft.Extensions.Hosting.md)
+* [Microsoft.Extensions.Logging](7.0-preview3_Microsoft.Extensions.Logging.md)
+* [Microsoft.Extensions.Primitives](7.0-preview3_Microsoft.Extensions.Primitives.md)
+

release-notes/7.0/preview/api-diff/preview3/Microsoft.AspNetCore.App/7.0-preview3_Microsoft.AspNetCore.Http.md

@@ -0,0 +1,207 @@
+# Microsoft.AspNetCore.Http
+
+``` diff
+ namespace Microsoft.AspNetCore.Http {
++    public sealed class AcceptedAtRouteHttpResult : IResult {
++        public string RouteName { get; }
++        public RouteValueDictionary RouteValues { get; }
++        public int StatusCode { get; }
++        public object Value { get; }
++        public Task ExecuteAsync(HttpContext httpContext);
++    }
++    public sealed class AcceptedHttpResult : IResult {
++        public string Location { get; }
++        public int StatusCode { get; }
++        public object Value { get; }
++        public Task ExecuteAsync(HttpContext httpContext);
++    }
++    public sealed class BadRequestObjectHttpResult : IResult {
++        public int StatusCode { get; }
++        public object Value { get; internal set; }
++        public Task ExecuteAsync(HttpContext httpContext);
++    }
++    public sealed class ChallengeHttpResult : IResult {
++        public IReadOnlyList<string> AuthenticationSchemes { get; internal set; }
++        public AuthenticationProperties? Properties { get; internal set; }
++        public Task ExecuteAsync(HttpContext httpContext);
++    }
++    public sealed class ConflictObjectHttpResult : IResult {
++        public int StatusCode { get; }
++        public object Value { get; internal set; }
++        public Task ExecuteAsync(HttpContext httpContext);
++    }
++    public sealed class ContentHttpResult : IResult {
++        public string Content { get; internal set; }
++        public string ContentType { get; internal set; }
++        public int? StatusCode { get; internal set; }
++        public Task ExecuteAsync(HttpContext httpContext);
++    }
++    public sealed class CreatedAtRouteHttpResult : IResult {
++        public string RouteName { get; }
++        public RouteValueDictionary RouteValues { get; }
++        public int StatusCode { get; }
++        public object Value { get; }
++        public Task ExecuteAsync(HttpContext httpContext);
++    }
++    public sealed class CreatedHttpResult : IResult {
++        public string Location { get; }
++        public int StatusCode { get; }
++        public object Value { get; }
++        public Task ExecuteAsync(HttpContext httpContext);
++    }
++    public sealed class EmptyHttpResult : IResult {
++        public static EmptyHttpResult Instance { get; }
++        public Task ExecuteAsync(HttpContext httpContext);
++    }
+     public sealed class EndpointMetadataCollection : IEnumerable, IEnumerable<object>, IReadOnlyCollection<object>, IReadOnlyList<object> {
++        public T GetRequiredMetadata<T>() where T : class;
+     }
++    public sealed class FileContentHttpResult : IResult {
++        public string ContentType { get; internal set; }
++        public bool EnableRangeProcessing { get; internal set; }
++        public EntityTagHeaderValue EntityTag { get; internal set; }
++        public ReadOnlyMemory<byte> FileContents { get; internal set; }
++        public string FileDownloadName { get; internal set; }
++        public long? FileLength { get; internal set; }
++        public DateTimeOffset? LastModified { get; internal set; }
++        public Task ExecuteAsync(HttpContext httpContext);
++    }
++    public sealed class FileStreamHttpResult : IResult {
++        public string ContentType { get; internal set; }
++        public bool EnableRangeProcessing { get; internal set; }
++        public EntityTagHeaderValue EntityTag { get; internal set; }
++        public string FileDownloadName { get; internal set; }
++        public long? FileLength { get; internal set; }
++        public Stream FileStream { get; }
++        public DateTimeOffset? LastModified { get; internal set; }
++        public Task ExecuteAsync(HttpContext httpContext);
++    }
++    public sealed class ForbidHttpResult : IResult {
++        public IReadOnlyList<string> AuthenticationSchemes { get; internal set; }
++        public AuthenticationProperties? Properties { get; internal set; }
++        public Task ExecuteAsync(HttpContext httpContext);
++    }
++    public interface IRouteHandlerFilter {
++        ValueTask<object?> InvokeAsync(RouteHandlerInvocationContext context, RouteHandlerFilterDelegate next);
++    }
++    public sealed class JsonHttpResult : IResult {
++        public string ContentType { get; internal set; }
++        public JsonSerializerOptions JsonSerializerOptions { get; internal set; }
++        public int? StatusCode { get; }
++        public object Value { get; }
++        public Task ExecuteAsync(HttpContext httpContext);
++    }
++    public class NoContentHttpResult : IResult {
++        public int StatusCode { get; }
++        public Task ExecuteAsync(HttpContext httpContext);
++    }
++    public sealed class NotFoundObjectHttpResult : IResult {
++        public int StatusCode { get; }
++        public object Value { get; internal set; }
++        public Task ExecuteAsync(HttpContext httpContext);
++    }
++    public sealed class OkObjectHttpResult : IResult {
++        public int StatusCode { get; }
++        public object Value { get; internal set; }
++        public Task ExecuteAsync(HttpContext httpContext);
++    }
++    public sealed class PhysicalFileHttpResult : IResult {
++        public string ContentType { get; internal set; }
++        public bool EnableRangeProcessing { get; internal set; }
++        public EntityTagHeaderValue? EntityTag { get; internal set; }
++        public string? FileDownloadName { get; internal set; }
++        public long? FileLength { get; internal set; }
++        public string FileName { get; }
++        public DateTimeOffset? LastModified { get; internal set; }
++        public Task ExecuteAsync(HttpContext httpContext);
++    }
++    public sealed class ProblemHttpResult : IResult {
++        public string ContentType { get; }
++        public ProblemDetails ProblemDetails { get; }
++        public int? StatusCode { get; }
++        public Task ExecuteAsync(HttpContext httpContext);
++    }
++    public sealed class PushStreamHttpResult : IResult {
++        public string ContentType { get; internal set; }
++        public bool EnableRangeProcessing { get; internal set; }
++        public EntityTagHeaderValue EntityTag { get; internal set; }
++        public string FileDownloadName { get; internal set; }
++        public long? FileLength { get; internal set; }
++        public DateTimeOffset? LastModified { get; internal set; }
++        public Task ExecuteAsync(HttpContext httpContext);
++    }
++    public sealed class RedirectHttpResult : IResult {
++        public bool AcceptLocalUrlOnly { get; }
++        public bool Permanent { get; }
++        public bool PreserveMethod { get; }
++        public string Url { get; }
++        public Task ExecuteAsync(HttpContext httpContext);
++    }
++    public sealed class RedirectToRouteHttpResult : IResult {
++        public string Fragment { get; }
++        public bool Permanent { get; }
++        public bool PreserveMethod { get; }
++        public string RouteName { get; }
++        public RouteValueDictionary RouteValues { get; }
++        public Task ExecuteAsync(HttpContext httpContext);
++    }
+     public sealed class RequestDelegateFactoryOptions {
++        public IReadOnlyList<Func<RouteHandlerContext, RouteHandlerFilterDelegate, RouteHandlerFilterDelegate>>? RouteHandlerFilterFactories { get; set; }
+     }
+     public static class Results {
++        public static IResult Empty { get; }
+     }
++    public sealed class RouteHandlerContext {
++        public RouteHandlerContext(MethodInfo methodInfo, EndpointMetadataCollection endpointMetadata);
++        public EndpointMetadataCollection EndpointMetadata { get; }
++        public MethodInfo MethodInfo { get; }
++    }
++    public delegate ValueTask<object?> RouteHandlerFilterDelegate(RouteHandlerInvocationContext context);
++    public static class RouteHandlerFilterExtensions {
++        public static RouteHandlerBuilder AddFilter(this RouteHandlerBuilder builder, IRouteHandlerFilter filter);
++        public static RouteHandlerBuilder AddFilter(this RouteHandlerBuilder builder, Func<RouteHandlerContext, RouteHandlerFilterDelegate, RouteHandlerFilterDelegate> filterFactory);
++        public static RouteHandlerBuilder AddFilter(this RouteHandlerBuilder builder, Func<RouteHandlerInvocationContext, RouteHandlerFilterDelegate, ValueTask<object?>> routeHandlerFilter);
++        public static RouteHandlerBuilder AddFilter<TFilterType>(this RouteHandlerBuilder builder) where TFilterType : IRouteHandlerFilter;
++    }
++    public sealed class RouteHandlerInvocationContext {
++        public RouteHandlerInvocationContext(HttpContext httpContext, params object[] parameters);
++        public HttpContext HttpContext { get; }
++        public IList<object?> Parameters { get; }
++    }
++    public sealed class SignInHttpResult : IResult {
++        public string AuthenticationScheme { get; internal set; }
++        public ClaimsPrincipal Principal { get; internal set; }
++        public AuthenticationProperties Properties { get; internal set; }
++        public Task ExecuteAsync(HttpContext httpContext);
++    }
++    public sealed class SignOutHttpResult : IResult {
++        public IReadOnlyList<string> AuthenticationSchemes { get; internal set; }
++        public AuthenticationProperties? Properties { get; internal set; }
++        public Task ExecuteAsync(HttpContext httpContext);
++    }
++    public sealed class StatusCodeHttpResult : IResult {
++        public int StatusCode { get; }
++        public Task ExecuteAsync(HttpContext httpContext);
++    }
++    public sealed class UnauthorizedHttpResult : IResult {
++        public int StatusCode { get; }
++        public Task ExecuteAsync(HttpContext httpContext);
++    }
++    public sealed class UnprocessableEntityObjectHttpResult : IResult {
++        public int StatusCode { get; }
++        public object Value { get; internal set; }
++        public Task ExecuteAsync(HttpContext httpContext);
++    }
++    public sealed class VirtualFileHttpResult : IResult {
++        public string ContentType { get; internal set; }
++        public bool EnableRangeProcessing { get; internal set; }
++        public EntityTagHeaderValue? EntityTag { get; internal set; }
++        public string? FileDownloadName { get; internal set; }
++        public long? FileLength { get; internal set; }
++        public string FileName { get; internal set; }
++        public DateTimeOffset? LastModified { get; internal set; }
++        public Task ExecuteAsync(HttpContext httpContext);
++    }
+ }
+```
+

release-notes/7.0/preview/api-diff/preview3/Microsoft.AspNetCore.App/7.0-preview3_Microsoft.AspNetCore.Mvc.ModelBinding.Binders.md

@@ -0,0 +1,11 @@
+# Microsoft.AspNetCore.Mvc.ModelBinding.Binders
+
+``` diff
+ namespace Microsoft.AspNetCore.Mvc.ModelBinding.Binders {
++    public sealed class TryParseModelBinderProvider : IModelBinderProvider {
++        public TryParseModelBinderProvider();
++        public IModelBinder? GetBinder(ModelBinderProviderContext context);
++    }
+ }
+```
+

release-notes/7.0/preview/api-diff/preview3/Microsoft.AspNetCore.App/7.0-preview3_Microsoft.AspNetCore.Mvc.md

@@ -0,0 +1,10 @@
+# Microsoft.AspNetCore.Mvc
+
+``` diff
+ namespace Microsoft.AspNetCore.Mvc {
+     public abstract class ControllerBase {
++        public static EmptyResult Empty { get; }
+     }
+ }
+```
+

release-notes/7.0/preview/api-diff/preview3/Microsoft.AspNetCore.App/7.0-preview3_Microsoft.AspNetCore.Routing.md

@@ -0,0 +1,12 @@
+# Microsoft.AspNetCore.Routing
+
+``` diff
+ namespace Microsoft.AspNetCore.Routing {
+     public class RouteValueDictionary : ICollection<KeyValuePair<string, object?>>, IDictionary<string, object?>, IEnumerable, IEnumerable<KeyValuePair<string, object?>>, IReadOnlyCollection<KeyValuePair<string, object?>>, IReadOnlyDictionary<string, object?> {
++        public RouteValueDictionary(RouteValueDictionary? dictionary);
++        public RouteValueDictionary(IEnumerable<KeyValuePair<string, object?>>? values);
++        public RouteValueDictionary(IEnumerable<KeyValuePair<string, string?>>? values);
+     }
+ }
+```
+

release-notes/7.0/preview/api-diff/preview3/Microsoft.AspNetCore.App/7.0-preview3_Microsoft.Extensions.Caching.Memory.md

@@ -0,0 +1,11 @@
+# Microsoft.Extensions.Caching.Memory
+
+``` diff
+ namespace Microsoft.Extensions.Caching.Memory {
+     public static class CacheExtensions {
+-        public static Task<TItem> GetOrCreateAsync<TItem>(this IMemoryCache cache, object key, Func<ICacheEntry, Task<TItem>> factory);
++        public static Task<TItem?> GetOrCreateAsync<TItem>(this IMemoryCache cache, object key, Func<ICacheEntry, Task<TItem>> factory);
+     }
+ }
+```
+

release-notes/7.0/preview/api-diff/preview3/Microsoft.AspNetCore.App/7.0-preview3_Microsoft.Extensions.Configuration.md

@@ -0,0 +1,16 @@
+# Microsoft.Extensions.Configuration
+
+``` diff
+ namespace Microsoft.Extensions.Configuration {
+     public static class ConfigurationBinder {
+-        public static object? GetValue(this IConfiguration configuration, Type type, string key, object defaultValue);
++        public static object? GetValue(this IConfiguration configuration, Type type, string key, object? defaultValue);
+     }
+     public sealed class ConfigurationManager : IConfiguration, IConfigurationBuilder, IConfigurationRoot, IDisposable {
+-        IList<IConfigurationSource> IConfigurationBuilder.Sources { get; }
+
++        public IList<IConfigurationSource> Sources { get; }
+     }
+ }
+```
+

release-notes/7.0/preview/api-diff/preview3/Microsoft.AspNetCore.App/7.0-preview3_Microsoft.Extensions.FileSystemGlobbing.Internal.PatternContexts.md

@@ -0,0 +1,14 @@
+# Microsoft.Extensions.FileSystemGlobbing.Internal.PatternContexts
+
+``` diff
+ namespace Microsoft.Extensions.FileSystemGlobbing.Internal.PatternContexts {
+-    public abstract class PatternContext<TFrame> : IPatternContext {
++    public abstract class PatternContext<TFrame> : IPatternContext where TFrame : struct {
+-        protected TFrame? Frame;
++        protected TFrame Frame;
+-        protected void PushDataFrame(TFrame? frame);
++        protected void PushDataFrame(TFrame frame);
+     }
+ }
+```
+

release-notes/7.0/preview/api-diff/preview3/Microsoft.AspNetCore.App/7.0-preview3_Microsoft.Extensions.Hosting.md

@@ -0,0 +1,46 @@
+# Microsoft.Extensions.Hosting
+
+``` diff
+ namespace Microsoft.Extensions.Hosting {
+     public abstract class BackgroundService : IDisposable, IHostedService {
+-        public virtual Task ExecuteTask { get; }
++        public virtual Task? ExecuteTask { get; }
+     }
+     public static class GenericHostBuilderExtensions {
++        public static IHostBuilder ConfigureWebHostDefaults(this IHostBuilder builder, Action<IWebHostBuilder> configure, Action<WebHostBuilderOptions> configureOptions);
+     }
+     public static class Host {
++        public static HostApplicationBuilder CreateApplicationBuilder();
++        public static HostApplicationBuilder CreateApplicationBuilder(string[] args);
+     }
++    public sealed class HostApplicationBuilder {
++        public HostApplicationBuilder();
++        public HostApplicationBuilder(HostApplicationBuilderSettings settings);
++        public HostApplicationBuilder(string[] args);
++        public ConfigurationManager Configuration { get; }
++        public IHostEnvironment Environment { get; }
++        public ILoggingBuilder Logging { get; }
++        public IServiceCollection Services { get; }
++        public IHost Build();
++        public void ConfigureContainer<TContainerBuilder>(IServiceProviderFactory<TContainerBuilder> factory, Action<TContainerBuilder> configure = null) where TContainerBuilder : notnull;
++    }
++    public sealed class HostApplicationBuilderSettings {
++        public HostApplicationBuilderSettings();
++        public string ApplicationName { get; set; }
++        public string[] Args { get; set; }
++        public ConfigurationManager Configuration { get; set; }
++        public string ContentRootPath { get; set; }
++        public bool DisableDefaults { get; set; }
++        public string EnvironmentName { get; set; }
++    }
+     public interface IHostEnvironment {
+-        string ApplicationName { get; set; }
++        string? ApplicationName { get; set; }
+     }
+     public interface IHostingEnvironment {
+-        string ApplicationName { get; set; }
++        string? ApplicationName { get; set; }
+     }
+ }
+```
+