API diff between .NET 8.0 Preview 2 and .NET 8 Preview 3 (#8387)

* API diff between .NET 8.0 Preview 2 and .NET 8 Preview 3 * Microsoft.AspNetCore.App * Microsoft.NETCore.App * Microsoft.WindowsDesktop.App * Update release-notes/8.0/preview/api-diff/preview3/Microsoft.NETCore.App/8.0-preview3_System.Net.md Co-authored-by: Stephen Toub <stoub@microsoft.com> --------- Co-authored-by: Stephen Toub <stoub@microsoft.com>
dotnet · Apr 26, 2023 · 2fa55a9 · 2fa55a9
1 parent 06717d0
commit 2fa55a9
Show file tree

Hide file tree

Showing 40 changed files with 1,271 additions and 0 deletions.
diff --git a/...se-notes/8.0/preview/api-diff/preview3/Microsoft.AspNetCore.App/8.0-preview3.md b/...se-notes/8.0/preview/api-diff/preview3/Microsoft.AspNetCore.App/8.0-preview3.md
@@ -0,0 +1,25 @@
+# API Difference 8.0-preview2 vs 8.0-preview3
+
+API listing follows standard diff formatting.
+Lines preceded by a '+' are additions and a '-' indicates removal.
+
+* [Microsoft.AspNetCore.Builder](8.0-preview3_Microsoft.AspNetCore.Builder.md)
+* [Microsoft.AspNetCore.Components](8.0-preview3_Microsoft.AspNetCore.Components.md)
+* [Microsoft.AspNetCore.Components.Endpoints](8.0-preview3_Microsoft.AspNetCore.Components.Endpoints.md)
+* [Microsoft.AspNetCore.Components.Forms](8.0-preview3_Microsoft.AspNetCore.Components.Forms.md)
+* [Microsoft.AspNetCore.Components.Infrastructure](8.0-preview3_Microsoft.AspNetCore.Components.Infrastructure.md)
+* [Microsoft.AspNetCore.Components.Sections](8.0-preview3_Microsoft.AspNetCore.Components.Sections.md)
+* [Microsoft.AspNetCore.Components.Server.Circuits](8.0-preview3_Microsoft.AspNetCore.Components.Server.Circuits.md)
+* [Microsoft.AspNetCore.Components.Web](8.0-preview3_Microsoft.AspNetCore.Components.Web.md)
+* [Microsoft.AspNetCore.Connections.Features](8.0-preview3_Microsoft.AspNetCore.Connections.Features.md)
+* [Microsoft.AspNetCore.Diagnostics](8.0-preview3_Microsoft.AspNetCore.Diagnostics.md)
+* [Microsoft.AspNetCore.Html](8.0-preview3_Microsoft.AspNetCore.Html.md)
+* [Microsoft.AspNetCore.Http](8.0-preview3_Microsoft.AspNetCore.Http.md)
+* [Microsoft.AspNetCore.Http.Timeouts](8.0-preview3_Microsoft.AspNetCore.Http.Timeouts.md)
+* [Microsoft.AspNetCore.Routing](8.0-preview3_Microsoft.AspNetCore.Routing.md)
+* [Microsoft.AspNetCore.Server.Kestrel.Core.Features](8.0-preview3_Microsoft.AspNetCore.Server.Kestrel.Core.Features.md)
+* [Microsoft.Extensions.DependencyInjection](8.0-preview3_Microsoft.Extensions.DependencyInjection.md)
+* [Microsoft.Extensions.FileProviders](8.0-preview3_Microsoft.Extensions.FileProviders.md)
+* [Microsoft.Extensions.Options](8.0-preview3_Microsoft.Extensions.Options.md)
+* [Microsoft.Net.Http.Headers](8.0-preview3_Microsoft.Net.Http.Headers.md)
+
diff --git a/.../preview3/Microsoft.AspNetCore.App/8.0-preview3_Microsoft.AspNetCore.Builder.md b/.../preview3/Microsoft.AspNetCore.App/8.0-preview3_Microsoft.AspNetCore.Builder.md
@@ -0,0 +1,33 @@
+# Microsoft.AspNetCore.Builder
+
+``` diff
+ namespace Microsoft.AspNetCore.Builder {
++    public class ComponentTypeMetadata {
++        public ComponentTypeMetadata(Type componentType);
++        public Type Type { get; }
++    }
+     public static class CorsEndpointConventionBuilderExtensions {
++        public static TBuilder RequireCors<TBuilder>(this TBuilder builder) where TBuilder : IEndpointConventionBuilder;
+     }
++    public class RazorComponentEndpointConventionBuilder : IEndpointConventionBuilder {
++        public void Add(Action<EndpointBuilder> convention);
++        public void Finally(Action<EndpointBuilder> finallyConvention);
++    }
++    public static class RazorComponentsEndpointRouteBuilderExtensions {
++        public static RazorComponentEndpointConventionBuilder MapRazorComponents<TRootComponent>(this IEndpointRouteBuilder endpoints) where TRootComponent : IRazorComponentApplication<TRootComponent>;
++    }
++    public static class RequestTimeoutsIApplicationBuilderExtensions {
++        public static IApplicationBuilder UseRequestTimeouts(this IApplicationBuilder builder);
++    }
++    public static class RequestTimeoutsIEndpointConventionBuilderExtensions {
++        public static IEndpointConventionBuilder DisableRequestTimeout(this IEndpointConventionBuilder builder);
++        public static IEndpointConventionBuilder WithRequestTimeout(this IEndpointConventionBuilder builder, RequestTimeoutPolicy policy);
++        public static IEndpointConventionBuilder WithRequestTimeout(this IEndpointConventionBuilder builder, string policyName);
++        public static IEndpointConventionBuilder WithRequestTimeout(this IEndpointConventionBuilder builder, TimeSpan timeout);
++    }
++    public static class RouteShortCircuitEndpointConventionBuilderExtensions {
++        public static IEndpointConventionBuilder ShortCircuit(this IEndpointConventionBuilder builder, int? statusCode = default(int?));
++    }
+ }
+```
+
diff --git a/...rosoft.AspNetCore.App/8.0-preview3_Microsoft.AspNetCore.Components.Endpoints.md b/...rosoft.AspNetCore.App/8.0-preview3_Microsoft.AspNetCore.Components.Endpoints.md
@@ -0,0 +1,36 @@
+# Microsoft.AspNetCore.Components.Endpoints
+
+``` diff
++namespace Microsoft.AspNetCore.Components.Endpoints {
++    public interface IComponentPrerenderer {
++        Dispatcher Dispatcher { get; }
++        ValueTask<IHtmlAsyncContent> PrerenderComponentAsync(HttpContext httpContext, Type componentType, RenderMode renderMode, ParameterView parameters);
++        ValueTask<IHtmlContent> PrerenderPersistedStateAsync(HttpContext httpContext, PersistedStateSerializationMode serializationMode);
++    }
++    public interface IRazorComponentsBuilder {
++        IServiceCollection Services { get; }
++    }
++    public class RazorComponentResult : IResult {
++        public RazorComponentResult(Type componentType);
++        public RazorComponentResult(Type componentType, IReadOnlyDictionary<string, object?>? parameters);
++        public RazorComponentResult(Type componentType, object? parameters);
++        public Type ComponentType { get; }
++        public string? ContentType { get; set; }
++        public IReadOnlyDictionary<string, object?> Parameters { get; }
++        public RenderMode RenderMode { get; set; }
++        public int? StatusCode { get; set; }
++        public Task ExecuteAsync(HttpContext httpContext);
++    }
++    public class RazorComponentResult<TComponent> : RazorComponentResult where TComponent : IComponent {
++        public RazorComponentResult();
++        public RazorComponentResult(IReadOnlyDictionary<string, object?> parameters);
++        public RazorComponentResult(object parameters);
++    }
++    public class RazorComponentResultExecutor {
++        public static readonly string DefaultContentType;
++        public RazorComponentResultExecutor();
++        public virtual Task ExecuteAsync(HttpContext httpContext, RazorComponentResult result);
++    }
++}
+```
+
diff --git a/.../Microsoft.AspNetCore.App/8.0-preview3_Microsoft.AspNetCore.Components.Forms.md b/.../Microsoft.AspNetCore.App/8.0-preview3_Microsoft.AspNetCore.Components.Forms.md
@@ -0,0 +1,10 @@
+# Microsoft.AspNetCore.Components.Forms
+
+``` diff
+ namespace Microsoft.AspNetCore.Components.Forms {
+     public class InputFile : ComponentBase, IDisposable, IInputFileJsCallbacks {
+-        protected override void OnInitialized();
+     }
+ }
+```
+
diff --git a/...t.AspNetCore.App/8.0-preview3_Microsoft.AspNetCore.Components.Infrastructure.md b/...t.AspNetCore.App/8.0-preview3_Microsoft.AspNetCore.Components.Infrastructure.md
@@ -0,0 +1,10 @@
+# Microsoft.AspNetCore.Components.Infrastructure
+
+``` diff
+ namespace Microsoft.AspNetCore.Components.Infrastructure {
+     public class ComponentStatePersistenceManager {
++        public Task PersistStateAsync(IPersistentComponentStateStore store, Dispatcher dispatcher);
+     }
+ }
+```
+
diff --git a/...crosoft.AspNetCore.App/8.0-preview3_Microsoft.AspNetCore.Components.Sections.md b/...crosoft.AspNetCore.App/8.0-preview3_Microsoft.AspNetCore.Components.Sections.md
@@ -0,0 +1,29 @@
+# Microsoft.AspNetCore.Components.Sections
+
+``` diff
++namespace Microsoft.AspNetCore.Components.Sections {
++    public sealed class SectionContent : IComponent, IDisposable, ISectionContentProvider {
++        public SectionContent();
++        [ParameterAttribute]
++        public RenderFragment ChildContent { get; set; }
++        [ParameterAttribute]
++        public object SectionId { get; set; }
++        [ParameterAttribute]
++        public string SectionName { get; set; }
++        public void Dispose();
++        void IComponent.Attach(RenderHandle renderHandle);
++        Task IComponent.SetParametersAsync(ParameterView parameters);
++    }
++    public sealed class SectionOutlet : IComponent, IDisposable, ISectionContentSubscriber {
++        public SectionOutlet();
++        [ParameterAttribute]
++        public object SectionId { get; set; }
++        [ParameterAttribute]
++        public string SectionName { get; set; }
++        public void Dispose();
++        void IComponent.Attach(RenderHandle renderHandle);
++        Task IComponent.SetParametersAsync(ParameterView parameters);
++    }
++}
+```
+
diff --git a/....AspNetCore.App/8.0-preview3_Microsoft.AspNetCore.Components.Server.Circuits.md b/....AspNetCore.App/8.0-preview3_Microsoft.AspNetCore.Components.Server.Circuits.md
@@ -0,0 +1,13 @@
+# Microsoft.AspNetCore.Components.Server.Circuits
+
+``` diff
+ namespace Microsoft.AspNetCore.Components.Server.Circuits {
+     public abstract class CircuitHandler {
++        public virtual Func<CircuitInboundActivityContext, Task> CreateInboundActivityHandler(Func<CircuitInboundActivityContext, Task> next);
+     }
++    public sealed class CircuitInboundActivityContext {
++        public Circuit Circuit { get; }
++    }
+ }
+```
+
diff --git a/...w3/Microsoft.AspNetCore.App/8.0-preview3_Microsoft.AspNetCore.Components.Web.md b/...w3/Microsoft.AspNetCore.App/8.0-preview3_Microsoft.AspNetCore.Components.Web.md
@@ -0,0 +1,27 @@
+# Microsoft.AspNetCore.Components.Web
+
+``` diff
+ namespace Microsoft.AspNetCore.Components.Web {
++    public sealed class HtmlComponent {
++        public static HtmlComponent Empty { get; }
++        public string ToHtmlString();
++        public Task WaitForQuiescenceAsync();
++        public void WriteHtmlTo(TextWriter output);
++    }
++    public sealed class HtmlRenderer : IAsyncDisposable, IDisposable {
++        public HtmlRenderer(IServiceProvider services, ILoggerFactory loggerFactory);
++        public Dispatcher Dispatcher { get; }
++        public HtmlComponent BeginRenderingComponent(Type componentType);
++        public HtmlComponent BeginRenderingComponent(Type componentType, ParameterView parameters);
++        public HtmlComponent BeginRenderingComponent<TComponent>() where TComponent : IComponent;
++        public HtmlComponent BeginRenderingComponent<TComponent>(ParameterView parameters) where TComponent : IComponent;
++        public void Dispose();
++        public ValueTask DisposeAsync();
++        public Task<HtmlComponent> RenderComponentAsync(Type componentType);
++        public Task<HtmlComponent> RenderComponentAsync(Type componentType, ParameterView parameters);
++        public Task<HtmlComponent> RenderComponentAsync<TComponent>() where TComponent : IComponent;
++        public Task<HtmlComponent> RenderComponentAsync<TComponent>(ParameterView parameters) where TComponent : IComponent;
++    }
+ }
+```
+
diff --git a/...eview3/Microsoft.AspNetCore.App/8.0-preview3_Microsoft.AspNetCore.Components.md b/...eview3/Microsoft.AspNetCore.App/8.0-preview3_Microsoft.AspNetCore.Components.md
@@ -0,0 +1,45 @@
+# Microsoft.AspNetCore.Components
+
+``` diff
+ namespace Microsoft.AspNetCore.Components {
++    public class ComponentApplicationBuilder {
++        public ComponentApplicationBuilder();
++        public RazorComponentApplication Build();
++    }
+     public readonly struct EventCallback : IEventCallback {
+-        public EventCallback(IHandleEvent? receiver, MulticastDelegate? @delegate);
++        public EventCallback(IHandleEvent receiver, MulticastDelegate @delegate);
++        public override bool Equals(object obj);
++        public override int GetHashCode();
+     }
+     public readonly struct EventCallback<TValue> : IEventCallback {
++        public override bool Equals(object obj);
++        public override int GetHashCode();
+     }
++    public interface IRazorComponentApplication<TComponent> where TComponent : IRazorComponentApplication<TComponent> {
++        static ComponentApplicationBuilder GetBuilder();
++    }
++    public class PageDefinition {
++        public string DisplayName { get; }
++        public IReadOnlyList<object> Metadata { get; }
++        public string Route { get; }
++        public Type Type { get; }
++    }
++    public enum PersistedStateSerializationMode {
++        Infer = 1,
++        Server = 2,
++        WebAssembly = 3,
++    }
++    public class RazorComponentApplication {
++        public IEnumerable<PageDefinition> Pages { get; }
++    }
++    public enum RenderMode {
++        Server = 2,
++        ServerPrerendered = 3,
++        Static = 1,
++        WebAssembly = 4,
++        WebAssemblyPrerendered = 5,
++    }
+ }
+```
+
diff --git a/...rosoft.AspNetCore.App/8.0-preview3_Microsoft.AspNetCore.Connections.Features.md b/...rosoft.AspNetCore.App/8.0-preview3_Microsoft.AspNetCore.Connections.Features.md
@@ -0,0 +1,10 @@
+# Microsoft.AspNetCore.Connections.Features
+
+``` diff
+ namespace Microsoft.AspNetCore.Connections.Features {
+     public interface ITlsHandshakeFeature {
++        TlsCipherSuite? NegotiatedCipherSuite { get; }
+     }
+ }
+```
+
diff --git a/...view3/Microsoft.AspNetCore.App/8.0-preview3_Microsoft.AspNetCore.Diagnostics.md b/...view3/Microsoft.AspNetCore.App/8.0-preview3_Microsoft.AspNetCore.Diagnostics.md
@@ -0,0 +1,13 @@
+# Microsoft.AspNetCore.Diagnostics
+
+``` diff
+ namespace Microsoft.AspNetCore.Diagnostics {
+     public interface IStatusCodeReExecuteFeature {
++        int OriginalStatusCode { get; }
+     }
+     public class StatusCodeReExecuteFeature : IStatusCodeReExecuteFeature {
++        public int OriginalStatusCode { get; internal set; }
+     }
+ }
+```
+
diff --git a/...iff/preview3/Microsoft.AspNetCore.App/8.0-preview3_Microsoft.AspNetCore.Html.md b/...iff/preview3/Microsoft.AspNetCore.App/8.0-preview3_Microsoft.AspNetCore.Html.md
@@ -0,0 +1,10 @@
+# Microsoft.AspNetCore.Html
+
+``` diff
+ namespace Microsoft.AspNetCore.Html {
++    public interface IHtmlAsyncContent : IHtmlContent {
++        ValueTask WriteToAsync(TextWriter writer);
++    }
+ }
+```
+
diff --git a/...ew3/Microsoft.AspNetCore.App/8.0-preview3_Microsoft.AspNetCore.Http.Timeouts.md b/...ew3/Microsoft.AspNetCore.App/8.0-preview3_Microsoft.AspNetCore.Http.Timeouts.md
@@ -0,0 +1,35 @@
+# Microsoft.AspNetCore.Http.Timeouts
+
+``` diff
++namespace Microsoft.AspNetCore.Http.Timeouts {
++    [AttributeUsageAttribute(68)]
++    public sealed class DisableRequestTimeoutAttribute : Attribute {
++        public DisableRequestTimeoutAttribute();
++    }
++    public interface IHttpRequestTimeoutFeature {
++        CancellationToken RequestTimeoutToken { get; }
++        void DisableTimeout();
++    }
++    [AttributeUsageAttribute(68)]
++    public sealed class RequestTimeoutAttribute : Attribute {
++        public RequestTimeoutAttribute(int milliseconds);
++        public RequestTimeoutAttribute(string policyName);
++        public string PolicyName { get; }
++        public TimeSpan? Timeout { get; }
++    }
++    public sealed class RequestTimeoutOptions {
++        public RequestTimeoutOptions();
++        public RequestTimeoutPolicy? DefaultPolicy { get; set; }
++        public IDictionary<string, RequestTimeoutPolicy> Policies { get; }
++        public RequestTimeoutOptions AddPolicy(string policyName, RequestTimeoutPolicy policy);
++        public RequestTimeoutOptions AddPolicy(string policyName, TimeSpan timeout);
++    }
++    public sealed class RequestTimeoutPolicy {
++        public RequestTimeoutPolicy();
++        public TimeSpan? Timeout { get; set; }
++        public int? TimeoutStatusCode { get; set; }
++        public RequestDelegate WriteTimeoutResponse { get; set; }
++    }
++}
+```
+
diff --git a/...iff/preview3/Microsoft.AspNetCore.App/8.0-preview3_Microsoft.AspNetCore.Http.md b/...iff/preview3/Microsoft.AspNetCore.App/8.0-preview3_Microsoft.AspNetCore.Http.md
@@ -0,0 +1,21 @@
+# Microsoft.AspNetCore.Http
+
+``` diff
+ namespace Microsoft.AspNetCore.Http {
+     public abstract class EndpointFilterInvocationContext {
++        public static EndpointFilterInvocationContext Create(HttpContext httpContext);
++        public static EndpointFilterInvocationContext Create<T1, T2, T3, T4, T5, T6, T7, T8>(HttpContext httpContext, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8);
++        public static EndpointFilterInvocationContext Create<T1, T2, T3, T4, T5, T6, T7>(HttpContext httpContext, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7);
++        public static EndpointFilterInvocationContext Create<T1, T2, T3, T4, T5, T6>(HttpContext httpContext, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6);
++        public static EndpointFilterInvocationContext Create<T1, T2, T3, T4, T5>(HttpContext httpContext, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5);
++        public static EndpointFilterInvocationContext Create<T1, T2, T3, T4>(HttpContext httpContext, T1 arg1, T2 arg2, T3 arg3, T4 arg4);
++        public static EndpointFilterInvocationContext Create<T1, T2, T3>(HttpContext httpContext, T1 arg1, T2 arg2, T3 arg3);
++        public static EndpointFilterInvocationContext Create<T1, T2>(HttpContext httpContext, T1 arg1, T2 arg2);
++        public static EndpointFilterInvocationContext Create<T>(HttpContext httpContext, T arg);
+     }
+     public static class TypedResults {
++        public static IResultExtensions Extensions { get; }
+     }
+ }
+```
+
diff --git a/.../preview3/Microsoft.AspNetCore.App/8.0-preview3_Microsoft.AspNetCore.Routing.md b/.../preview3/Microsoft.AspNetCore.App/8.0-preview3_Microsoft.AspNetCore.Routing.md
@@ -0,0 +1,10 @@
+# Microsoft.AspNetCore.Routing
+
+``` diff
+ namespace Microsoft.AspNetCore.Routing {
++    public static class RouteShortCircuitEndpointRouteBuilderExtensions {
++        public static IEndpointConventionBuilder MapShortCircuit(this IEndpointRouteBuilder builder, int statusCode, params string[] routePrefixes);
++    }
+ }
+```
+
diff --git a/...spNetCore.App/8.0-preview3_Microsoft.AspNetCore.Server.Kestrel.Core.Features.md b/...spNetCore.App/8.0-preview3_Microsoft.AspNetCore.Server.Kestrel.Core.Features.md
@@ -0,0 +1,10 @@
+# Microsoft.AspNetCore.Server.Kestrel.Core.Features
+
+``` diff
+ namespace Microsoft.AspNetCore.Server.Kestrel.Core.Features {
++    public interface ISslStreamFeature {
++        SslStream SslStream { get; }
++    }
+ }
+```
+
diff --git a/...crosoft.AspNetCore.App/8.0-preview3_Microsoft.Extensions.DependencyInjection.md b/...crosoft.AspNetCore.App/8.0-preview3_Microsoft.Extensions.DependencyInjection.md
@@ -0,0 +1,14 @@
+# Microsoft.Extensions.DependencyInjection
+
+``` diff
+ namespace Microsoft.Extensions.DependencyInjection {
++    public static class RazorComponentsServiceCollectionExtensions {
++        public static IRazorComponentsBuilder AddRazorComponents(this IServiceCollection services);
++    }
++    public static class RequestTimeoutsIServiceCollectionExtensions {
++        public static IServiceCollection AddRequestTimeouts(this IServiceCollection services);
++        public static IServiceCollection AddRequestTimeouts(this IServiceCollection services, Action<RequestTimeoutOptions> configure);
++    }
+ }
+```
+
diff --git a/...ew3/Microsoft.AspNetCore.App/8.0-preview3_Microsoft.Extensions.FileProviders.md b/...ew3/Microsoft.AspNetCore.App/8.0-preview3_Microsoft.Extensions.FileProviders.md
@@ -0,0 +1,12 @@
+# Microsoft.Extensions.FileProviders
+
+``` diff
+ namespace Microsoft.Extensions.FileProviders {
+     public class EmbeddedFileProvider : IFileProvider {
+-        public EmbeddedFileProvider(Assembly assembly, string? baseNamespace);
++        [UnconditionalSuppressMessageAttribute("SingleFile", "IL3000:Assembly.Location", Justification="The code handles if the Assembly.Location is empty. Workaround https://github.com/dotnet/runtime/issues/83607")]
++        public EmbeddedFileProvider(Assembly assembly, string? baseNamespace);
+     }
+ }
+```
+
diff --git a/.../preview3/Microsoft.AspNetCore.App/8.0-preview3_Microsoft.Extensions.Options.md b/.../preview3/Microsoft.AspNetCore.App/8.0-preview3_Microsoft.Extensions.Options.md
@@ -0,0 +1,16 @@
+# Microsoft.Extensions.Options
+
+``` diff
+ namespace Microsoft.Extensions.Options {
++    public class ValidateOptionsResultBuilder {
++        public ValidateOptionsResultBuilder();
++        public void AddError(string error, string? propertyName = null);
++        public void AddResult(ValidateOptionsResult result);
++        public void AddResult(ValidationResult? result);
++        public void AddResults(IEnumerable<ValidationResult?>? results);
++        public ValidateOptionsResult Build();
++        public void Clear();
++    }
+ }
+```
+