Resolve issue #211

- Add ILoggingBuilder extension methods
- Markup ILoggerFactory extension methods obsolute
- Add sample codes in SampleAspNetCore

Author: Wuyafeng

samples/Exceptionless.SampleAspNetCore/Startup.cs

@@ -22,7 +22,8 @@ public void ConfigureServices(IServiceCollection services) {
             services.AddLogging(b => b
                 .AddConfiguration(Configuration.GetSection("Logging"))
                 .AddDebug()
-                .AddConsole());
+                .AddConsole()
+                .AddExceptionless());
             services.AddHttpContextAccessor();
             services.AddMvc();
         }
@@ -38,7 +39,7 @@ public void Configure(IApplicationBuilder app, IWebHostEnvironment env, ILoggerF
             //OR
             //loggerFactory.AddExceptionless((c) => c.ReadFromConfiguration(Configuration));
 
-            loggerFactory.AddExceptionless();
+            //loggerFactory.AddExceptionless();
             app.UseRouting();
             app.UseEndpoints(endpoints => {
                 endpoints.MapControllers();

src/Platforms/Exceptionless.Extensions.Logging/Exceptionless.Extensions.Logging.csproj

@@ -15,7 +15,7 @@
   </ItemGroup>
 
   <ItemGroup Label="Package References">
-    <PackageReference Include="Microsoft.Extensions.Logging.Abstractions" Version="2.2.0" />
+    <PackageReference Include="Microsoft.Extensions.Logging" Version="3.1.2" />
   </ItemGroup>
 
   <ItemGroup>

src/Platforms/Exceptionless.Extensions.Logging/ExceptionlessLoggerExtensions.cs

@@ -23,15 +23,56 @@ public static ExceptionlessLogLevel ToLogLevel(this LogLevel level) {
 
             return ExceptionlessLogLevel.Off;
         }
+        /// <summary>
+        /// Adds Exceptionless to the logging pipeline using the <see cref="ExceptionlessClient.Default"/>.
+        /// </summary>
+        /// <param name="builder">The <see cref="ILoggingBuilder"/>.</param>
+        /// <param name="client">If a client is not specified then the <see cref="ExceptionlessClient.Default"/> wil be used.</param>
+        /// <returns>The <see cref="ILoggingBuilder"/>.</returns>
+        public static ILoggingBuilder AddExceptionless(this ILoggingBuilder builder, ExceptionlessClient client = null) {
+            builder.AddProvider(new ExceptionlessLoggerProvider(client ?? ExceptionlessClient.Default));
+            return builder;
+        }
+        /// <summary>
+        /// Adds Exceptionless to the logging pipeline using a new client with the provided api key.
+        /// </summary>
+        /// <param name="builder">The <see cref="ILoggingBuilder"/>.</param>
+        /// <param name="apiKey">The project api key.</param>
+        /// <param name="serverUrl">The Server Url.</param>
+        /// <returns>The <see cref="ILoggingBuilder"/>.</returns>
+        public static ILoggingBuilder AddExceptionless(this ILoggingBuilder builder, string apiKey, string serverUrl = null) {
+            if (String.IsNullOrEmpty(apiKey) && String.IsNullOrEmpty(serverUrl))
+                return builder.AddExceptionless();
 
-        // TODO: Add support for ILoggingBuilder
+            builder.AddProvider(new ExceptionlessLoggerProvider(config => {
+                if (!String.IsNullOrEmpty(apiKey) && apiKey != "API_KEY_HERE")
+                    config.ApiKey = apiKey;
+                if (!String.IsNullOrEmpty(serverUrl))
+                    config.ServerUrl = serverUrl;
 
+                config.UseInMemoryStorage();
+            }));
+
+            return builder;
+        }
         /// <summary>
-        /// Adds Exceptionless to the logging pipeline using the default client.
+        /// Adds Exceptionless to the logging pipeline using a new client configured with the provided action.
+        /// </summary>
+        /// <param name="builder">The <see cref="ILoggingBuilder"/>.</param>
+        /// <param name="configure">An <see cref="Action{ExceptionlessConfiguration}"/> that applies additional settings and plugins. The project api key must be specified.</param>
+        /// <returns>The <see cref="ILoggerFactory"/>.</returns>
+        public static ILoggingBuilder AddExceptionless(this ILoggingBuilder builder, Action<ExceptionlessConfiguration> configure) {
+            builder.AddProvider(new ExceptionlessLoggerProvider(configure));
+            return builder;
+        }
+        #region Obsolute
+        /// <summary>
+        /// Adds Exceptionless to the logging pipeline using the <see cref="ExceptionlessClient.Default"/>.
         /// </summary>
         /// <param name="factory">The <see cref="ILoggerFactory"/>.</param>
-        /// <param name="client">If a client is not specified than the default instance will be used.</param>
+        /// <param name="client">If a client is not specified then the <see cref="ExceptionlessClient.Default"/> wil be used.</param>
         /// <returns>The <see cref="ILoggerFactory"/>.</returns>
+        [Obsolete("Use ExceptionlessLoggerExtensions.AddExceptionless(ILoggingBuilder,ExceptionlessClient) instead.")]
         public static ILoggerFactory AddExceptionless(this ILoggerFactory factory, ExceptionlessClient client = null) {
             factory.AddProvider(new ExceptionlessLoggerProvider(client ?? ExceptionlessClient.Default));
             return factory;
@@ -44,6 +85,7 @@ public static ILoggerFactory AddExceptionless(this ILoggerFactory factory, Excep
         /// <param name="apiKey">The project api key.</param>
         /// <param name="serverUrl">The Server Url</param>
         /// <returns>The <see cref="ILoggerFactory"/>.</returns>
+        [Obsolete("Use ExceptionlessLoggerExtensions.AddExceptionless(ILoggingBuilder,string,string) instead.")]
         public static ILoggerFactory AddExceptionless(this ILoggerFactory factory, string apiKey, string serverUrl = null) {
             if (String.IsNullOrEmpty(apiKey) && String.IsNullOrEmpty(serverUrl))
                 return factory.AddExceptionless();
@@ -66,9 +108,11 @@ public static ILoggerFactory AddExceptionless(this ILoggerFactory factory, strin
         /// <param name="factory">The <see cref="ILoggerFactory"/>.</param>
         /// <param name="configure">An <see cref="Action{ExceptionlessConfiguration}"/> that applies additional settings and plugins. The project api key must be specified.</param>
         /// <returns>The <see cref="ILoggerFactory"/>.</returns>
+        [Obsolete("Use ExceptionlessLoggerExtensions.AddExceptionless(ILoggingBuilder,Action<ExceptionlessConfiguration>) instead.")]
         public static ILoggerFactory AddExceptionless(this ILoggerFactory factory, Action<ExceptionlessConfiguration> configure) {
             factory.AddProvider(new ExceptionlessLoggerProvider(configure));
             return factory;
-        }
+        } 
+        #endregion
     }
 }