Logging API doc additions (#77127)

diff --git a/src/libraries/Microsoft.Extensions.Logging.Abstractions/src/NullLogger.cs b/src/libraries/Microsoft.Extensions.Logging.Abstractions/src/NullLogger.cs
index 991a383..e2b1cd8 100644 (file)
--- a/src/libraries/Microsoft.Extensions.Logging.Abstractions/src/NullLogger.cs
+++ b/src/libraries/Microsoft.Extensions.Logging.Abstractions/src/NullLogger.cs
@@ -15,6 +15,9 @@ namespace Microsoft.Extensions.Logging.Abstractions
         /// </summary>
         public static NullLogger Instance { get; } = new NullLogger();
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="NullLogger"/> class.
+        /// </summary>
         private NullLogger()
         {
         }

diff --git a/src/libraries/Microsoft.Extensions.Logging.Configuration/src/LoggerProviderOptionsChangeTokenSource.cs b/src/libraries/Microsoft.Extensions.Logging.Configuration/src/LoggerProviderOptionsChangeTokenSource.cs
index 4026b8c..6a1ebd0 100644 (file)
--- a/src/libraries/Microsoft.Extensions.Logging.Configuration/src/LoggerProviderOptionsChangeTokenSource.cs
+++ b/src/libraries/Microsoft.Extensions.Logging.Configuration/src/LoggerProviderOptionsChangeTokenSource.cs
@@ -8,6 +8,9 @@ namespace Microsoft.Extensions.Logging.Configuration
     /// <inheritdoc />
     public class LoggerProviderOptionsChangeTokenSource<TOptions, TProvider> : ConfigurationChangeTokenSource<TOptions>
     {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="LoggerProviderOptionsChangeTokenSource{TOptions, TProvider}"/> class.
+        /// </summary>
         public LoggerProviderOptionsChangeTokenSource(ILoggerProviderConfiguration<TProvider> providerConfiguration) : base(providerConfiguration.Configuration)
         {
         }

diff --git a/src/libraries/Microsoft.Extensions.Logging.Console/src/ConsoleFormatterOptions.cs b/src/libraries/Microsoft.Extensions.Logging.Console/src/ConsoleFormatterOptions.cs
index 18978a2..7ab51ad 100644 (file)
--- a/src/libraries/Microsoft.Extensions.Logging.Console/src/ConsoleFormatterOptions.cs
+++ b/src/libraries/Microsoft.Extensions.Logging.Console/src/ConsoleFormatterOptions.cs
@@ -12,6 +12,9 @@ namespace Microsoft.Extensions.Logging.Console
     /// </summary>
     public class ConsoleFormatterOptions
     {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="ConsoleFormatterOptions"/> class.
+        /// </summary>
         public ConsoleFormatterOptions() { }
 
         /// <summary>

diff --git a/src/libraries/Microsoft.Extensions.Logging.Console/src/ConsoleLogger.cs b/src/libraries/Microsoft.Extensions.Logging.Console/src/ConsoleLogger.cs
index 1d4e9c4..3a542e6 100644 (file)
--- a/src/libraries/Microsoft.Extensions.Logging.Console/src/ConsoleLogger.cs
+++ b/src/libraries/Microsoft.Extensions.Logging.Console/src/ConsoleLogger.cs
@@ -9,6 +9,9 @@ using Microsoft.Extensions.Logging.Abstractions;
 
 namespace Microsoft.Extensions.Logging.Console
 {
+    /// <summary>
+    /// A logger that writes messages in the console.
+    /// </summary>
     [UnsupportedOSPlatform("browser")]
     internal sealed class ConsoleLogger : ILogger
     {
@@ -38,6 +41,7 @@ namespace Microsoft.Extensions.Logging.Console
         [ThreadStatic]
         private static StringWriter? t_stringWriter;
 
+        /// <inheritdoc />
         public void Log<TState>(LogLevel logLevel, EventId eventId, TState state, Exception? exception, Func<TState, Exception?, string> formatter)
         {
             if (!IsEnabled(logLevel))
@@ -65,11 +69,13 @@ namespace Microsoft.Extensions.Logging.Console
             _queueProcessor.EnqueueMessage(new LogMessageEntry(computedAnsiString, logAsError: logLevel >= Options.LogToStandardErrorThreshold));
         }
 
+        /// <inheritdoc />
         public bool IsEnabled(LogLevel logLevel)
         {
             return logLevel != LogLevel.None;
         }
 
+        /// <inheritdoc />
         public IDisposable BeginScope<TState>(TState state) where TState : notnull => ScopeProvider?.Push(state) ?? NullScope.Instance;
     }
 }

diff --git a/src/libraries/Microsoft.Extensions.Logging.Console/src/JsonConsoleFormatterOptions.cs b/src/libraries/Microsoft.Extensions.Logging.Console/src/JsonConsoleFormatterOptions.cs
index 3603cc9..215e859 100644 (file)
--- a/src/libraries/Microsoft.Extensions.Logging.Console/src/JsonConsoleFormatterOptions.cs
+++ b/src/libraries/Microsoft.Extensions.Logging.Console/src/JsonConsoleFormatterOptions.cs
@@ -10,6 +10,9 @@ namespace Microsoft.Extensions.Logging.Console
     /// </summary>
     public class JsonConsoleFormatterOptions : ConsoleFormatterOptions
     {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="JsonConsoleFormatterOptions"/> class.
+        /// </summary>
         public JsonConsoleFormatterOptions() { }
 
         /// <summary>

diff --git a/src/libraries/Microsoft.Extensions.Logging.Console/src/SimpleConsoleFormatterOptions.cs b/src/libraries/Microsoft.Extensions.Logging.Console/src/SimpleConsoleFormatterOptions.cs
index e824b68..2b32f91 100644 (file)
--- a/src/libraries/Microsoft.Extensions.Logging.Console/src/SimpleConsoleFormatterOptions.cs
+++ b/src/libraries/Microsoft.Extensions.Logging.Console/src/SimpleConsoleFormatterOptions.cs
@@ -8,6 +8,9 @@ namespace Microsoft.Extensions.Logging.Console
     /// </summary>
     public class SimpleConsoleFormatterOptions : ConsoleFormatterOptions
     {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="SimpleConsoleFormatterOptions"/> class.
+        /// </summary>
         public SimpleConsoleFormatterOptions() { }
 
         /// <summary>

diff --git a/src/libraries/Microsoft.Extensions.Logging.Debug/src/DebugLoggerProvider.cs b/src/libraries/Microsoft.Extensions.Logging.Debug/src/DebugLoggerProvider.cs
index d434686..3f9d1af 100644 (file)
--- a/src/libraries/Microsoft.Extensions.Logging.Debug/src/DebugLoggerProvider.cs
+++ b/src/libraries/Microsoft.Extensions.Logging.Debug/src/DebugLoggerProvider.cs
@@ -15,6 +15,7 @@ namespace Microsoft.Extensions.Logging.Debug
             return new DebugLogger(name);
         }
 
+        /// <inheritdoc />
         public void Dispose()
         {
         }

diff --git a/src/libraries/Microsoft.Extensions.Logging.EventLog/src/EventLogLogger.cs b/src/libraries/Microsoft.Extensions.Logging.EventLog/src/EventLogLogger.cs
index e4b89bd..a5d6e6a 100644 (file)
--- a/src/libraries/Microsoft.Extensions.Logging.EventLog/src/EventLogLogger.cs
+++ b/src/libraries/Microsoft.Extensions.Logging.EventLog/src/EventLogLogger.cs
@@ -48,6 +48,9 @@ namespace Microsoft.Extensions.Logging.EventLog
             _intermediateMessageSegmentSize = EventLog.MaxMessageSize - 2 * ContinuationString.Length;
         }
 
+        /// <summary>
+        /// The event log.
+        /// </summary>
         public IEventLog EventLog { get; }
 
         /// <inheritdoc />

diff --git a/src/libraries/Microsoft.Extensions.Logging.EventLog/src/WindowsEventLog.cs b/src/libraries/Microsoft.Extensions.Logging.EventLog/src/WindowsEventLog.cs
index d2b8c92..a43f746 100644 (file)
--- a/src/libraries/Microsoft.Extensions.Logging.EventLog/src/WindowsEventLog.cs
+++ b/src/libraries/Microsoft.Extensions.Logging.EventLog/src/WindowsEventLog.cs
@@ -8,6 +8,9 @@ using System.Runtime.Versioning;
 
 namespace Microsoft.Extensions.Logging.EventLog
 {
+    /// <summary>
+    /// The windows event log.
+    /// </summary>
     [SupportedOSPlatform("windows")]
     internal sealed class WindowsEventLog : IEventLog
     {
@@ -15,13 +18,22 @@ namespace Microsoft.Extensions.Logging.EventLog
         private const int MaximumMessageSize = 31839;
         private bool _enabled = true;
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="WindowsEventLog"/> class.
+        /// </summary>
         public WindowsEventLog(string logName, string machineName, string sourceName)
         {
             DiagnosticsEventLog = new System.Diagnostics.EventLog(logName, machineName, sourceName);
         }
 
+        /// <summary>
+        /// The diagnostics event log.
+        /// </summary>
         public System.Diagnostics.EventLog DiagnosticsEventLog { get; }
 
+        /// <summary>
+        /// The maximum message size.
+        /// </summary>
         public int MaxMessageSize => MaximumMessageSize;
 
         public int? DefaultEventId { get; set; }

diff --git a/src/libraries/Microsoft.Extensions.Logging.EventSource/src/EventSourceLogger.cs b/src/libraries/Microsoft.Extensions.Logging.EventSource/src/EventSourceLogger.cs
index e69ad6a..b0e405e 100644 (file)
--- a/src/libraries/Microsoft.Extensions.Logging.EventSource/src/EventSourceLogger.cs
+++ b/src/libraries/Microsoft.Extensions.Logging.EventSource/src/EventSourceLogger.cs
@@ -50,6 +50,7 @@ namespace Microsoft.Extensions.Logging.EventSource
             return logLevel != LogLevel.None && logLevel >= Level;
         }
 
+        /// <inheritdoc />
         public void Log<TState>(LogLevel logLevel, EventId eventId, TState state, Exception? exception, Func<TState, Exception?, string> formatter)
         {
             if (!IsEnabled(logLevel))

diff --git a/src/libraries/Microsoft.Extensions.Logging.EventSource/src/EventSourceLoggerProvider.cs b/src/libraries/Microsoft.Extensions.Logging.EventSource/src/EventSourceLoggerProvider.cs
index 9c62c8f..6a5343d 100644 (file)
--- a/src/libraries/Microsoft.Extensions.Logging.EventSource/src/EventSourceLoggerProvider.cs
+++ b/src/libraries/Microsoft.Extensions.Logging.EventSource/src/EventSourceLoggerProvider.cs
@@ -20,6 +20,10 @@ namespace Microsoft.Extensions.Logging.EventSource
         private EventSourceLogger? _loggers; // Linked list of loggers that I have created
         private readonly LoggingEventSource _eventSource;
 
+        /// <summary>
+        /// Creates an instance of <see cref="EventSourceLoggerProvider"/>.
+        /// </summary>
+        /// <param name="eventSource">The logging event source.</param>
         public EventSourceLoggerProvider(LoggingEventSource eventSource)
         {
             ThrowHelper.ThrowIfNull(eventSource);

diff --git a/src/libraries/Microsoft.Extensions.Logging.TraceSource/src/TraceSourceLogger.cs b/src/libraries/Microsoft.Extensions.Logging.TraceSource/src/TraceSourceLogger.cs
index 02e93b8..7d94f25 100644 (file)
--- a/src/libraries/Microsoft.Extensions.Logging.TraceSource/src/TraceSourceLogger.cs
+++ b/src/libraries/Microsoft.Extensions.Logging.TraceSource/src/TraceSourceLogger.cs
@@ -7,15 +7,23 @@ using DiagnosticsTraceSource = System.Diagnostics.TraceSource;
 
 namespace Microsoft.Extensions.Logging.TraceSource
 {
+    /// <summary>
+    /// A logger that writes a trace source log message.
+    /// </summary>
     internal sealed class TraceSourceLogger : ILogger
     {
         private readonly DiagnosticsTraceSource _traceSource;
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="TraceSourceLogger"/> class.
+        /// </summary>
+        /// <param name="traceSource">trace source</param>
         public TraceSourceLogger(DiagnosticsTraceSource traceSource)
         {
             _traceSource = traceSource;
         }
 
+        /// <inheritdoc />
         public void Log<TState>(LogLevel logLevel, EventId eventId, TState state, Exception? exception, Func<TState, Exception?, string> formatter)
         {
             if (!IsEnabled(logLevel))