diff --git a/src/libraries/System.Configuration.ConfigurationManager/src/System/Diagnostics/TraceConfiguration.cs b/src/libraries/System.Configuration.ConfigurationManager/src/System/Diagnostics/TraceConfiguration.cs index de819c301df57c..27fa11cc8e7808 100644 --- a/src/libraries/System.Configuration.ConfigurationManager/src/System/Diagnostics/TraceConfiguration.cs +++ b/src/libraries/System.Configuration.ConfigurationManager/src/System/Diagnostics/TraceConfiguration.cs @@ -3,6 +3,9 @@ namespace System.Diagnostics { + /// + /// Provides methods to register and configure tracing settings from configuration files to and related classes. + /// public static class TraceConfiguration { private static volatile bool s_registered; diff --git a/src/libraries/System.Data.Common/src/System/Data/SQLTypes/SQLBinary.cs b/src/libraries/System.Data.Common/src/System/Data/SQLTypes/SQLBinary.cs index ef6fc2d2f0412c..5771769ba908b0 100644 --- a/src/libraries/System.Data.Common/src/System/Data/SQLTypes/SQLBinary.cs +++ b/src/libraries/System.Data.Common/src/System/Data/SQLTypes/SQLBinary.cs @@ -460,6 +460,11 @@ public static XmlQualifiedName GetXsdType(XmlSchemaSet schemaSet) return new XmlQualifiedName("base64Binary", XmlSchema.Namespace); } + /// + /// Wraps a byte array in a without copying the data. + /// + /// The byte array to wrap. + /// A that wraps the provided byte array. public static SqlBinary WrapBytes(byte[] bytes) { return new SqlBinary(bytes, copy: false); diff --git a/src/libraries/System.Data.Common/src/System/Data/SQLTypes/SQLDecimal.cs b/src/libraries/System.Data.Common/src/System/Data/SQLTypes/SQLDecimal.cs index 309fc79d90bbc5..b985e7ce88a186 100644 --- a/src/libraries/System.Data.Common/src/System/Data/SQLTypes/SQLDecimal.cs +++ b/src/libraries/System.Data.Common/src/System/Data/SQLTypes/SQLDecimal.cs @@ -1154,6 +1154,13 @@ private decimal ToDecimal() } } + /// + /// Writes the TDS (Tabular Data Stream) representation of this to the specified destination. + /// + /// The destination span to write the TDS (Tabular Data Stream) value to. Must be at least 4 elements long. + /// The number of values written to the destination. + /// Thrown when the is . + /// Thrown when the destination span is too small. [CLSCompliant(false)] public int WriteTdsValue(Span destination) { diff --git a/src/libraries/System.Data.Common/src/System/Data/SQLTypes/SQLMoney.cs b/src/libraries/System.Data.Common/src/System/Data/SQLTypes/SQLMoney.cs index 8d028c5906d489..216769c6ea1abe 100644 --- a/src/libraries/System.Data.Common/src/System/Data/SQLTypes/SQLMoney.cs +++ b/src/libraries/System.Data.Common/src/System/Data/SQLTypes/SQLMoney.cs @@ -208,6 +208,11 @@ public override string ToString() return money.ToString("#0.00##", null); } + /// + /// Gets the TDS (Tabular Data Stream) representation of this value. + /// + /// A long value representing the TDS (Tabular Data Stream) representation. + /// Thrown when the is . public long GetTdsValue() { if (IsNull) @@ -249,6 +254,11 @@ public static SqlMoney Parse(string s) return money; } + /// + /// Creates a from a TDS (Tabular Data Stream) value. + /// + /// The TDS value to convert to . + /// A representing the TDS value. public static SqlMoney FromTdsValue(long value) { return new SqlMoney(value, 0); diff --git a/src/libraries/System.Diagnostics.TraceSource/src/System/Diagnostics/InitializingSwitchEventArgs.cs b/src/libraries/System.Diagnostics.TraceSource/src/System/Diagnostics/InitializingSwitchEventArgs.cs index 651bfd29fb0c77..f277ea680e4e19 100644 --- a/src/libraries/System.Diagnostics.TraceSource/src/System/Diagnostics/InitializingSwitchEventArgs.cs +++ b/src/libraries/System.Diagnostics.TraceSource/src/System/Diagnostics/InitializingSwitchEventArgs.cs @@ -8,11 +8,18 @@ namespace System.Diagnostics /// public sealed class InitializingSwitchEventArgs : EventArgs { + /// + /// Initializes a new instance of the class. + /// + /// The switch that is being initialized. public InitializingSwitchEventArgs(Switch @switch) { Switch = @switch; } + /// + /// Gets the that is being initialized. + /// public Switch Switch { get; } } } diff --git a/src/libraries/System.Diagnostics.TraceSource/src/System/Diagnostics/InitializingTraceSourceEventArgs.cs b/src/libraries/System.Diagnostics.TraceSource/src/System/Diagnostics/InitializingTraceSourceEventArgs.cs index b4b3aac66ac5cc..873234cc72d06e 100644 --- a/src/libraries/System.Diagnostics.TraceSource/src/System/Diagnostics/InitializingTraceSourceEventArgs.cs +++ b/src/libraries/System.Diagnostics.TraceSource/src/System/Diagnostics/InitializingTraceSourceEventArgs.cs @@ -8,12 +8,23 @@ namespace System.Diagnostics /// public sealed class InitializingTraceSourceEventArgs : EventArgs { + /// + /// Initializes a new instance of the class. + /// + /// The trace source that is being initialized. public InitializingTraceSourceEventArgs(TraceSource traceSource) { TraceSource = traceSource; } + /// + /// Gets the trace source that is being initialized. + /// public TraceSource TraceSource { get; } + + /// + /// Gets or sets a value indicating whether the trace source was initialized from configuration. + /// public bool WasInitialized { get; set; } } } diff --git a/src/libraries/System.Private.CoreLib/src/System/Runtime/Versioning/PlatformAttributes.cs b/src/libraries/System.Private.CoreLib/src/System/Runtime/Versioning/PlatformAttributes.cs index 85fbeb604c669c..86f621c82023b0 100644 --- a/src/libraries/System.Private.CoreLib/src/System/Runtime/Versioning/PlatformAttributes.cs +++ b/src/libraries/System.Private.CoreLib/src/System/Runtime/Versioning/PlatformAttributes.cs @@ -134,14 +134,32 @@ public UnsupportedOSPlatformAttribute(string platformName, string? message) : ba #endif sealed class ObsoletedOSPlatformAttribute : OSPlatformAttribute { + /// + /// Initializes a new instance of the class with the specified platform name. + /// + /// The name of the platform where the API was obsoleted. public ObsoletedOSPlatformAttribute(string platformName) : base(platformName) { } + + /// + /// Initializes a new instance of the class with the specified platform name and message. + /// + /// The name of the platform where the API was obsoleted. + /// The message that explains the obsolescence. public ObsoletedOSPlatformAttribute(string platformName, string? message) : base(platformName) { Message = message; } + + /// + /// Gets the message that explains the obsolescence. + /// public string? Message { get; } + + /// + /// Gets or sets the URL that provides more information about the obsolescence. + /// public string? Url { get; set; } } diff --git a/src/libraries/System.Private.DataContractSerialization/src/System/Runtime/Serialization/DataContract.cs b/src/libraries/System.Private.DataContractSerialization/src/System/Runtime/Serialization/DataContract.cs index 3b8c59d2ca3117..9f41125199f554 100644 --- a/src/libraries/System.Private.DataContractSerialization/src/System/Runtime/Serialization/DataContract.cs +++ b/src/libraries/System.Private.DataContractSerialization/src/System/Runtime/Serialization/DataContract.cs @@ -21,6 +21,9 @@ namespace System.Runtime.Serialization.DataContracts { + /// + /// Represents a data contract that defines serialization and deserialization behavior for types. + /// public abstract class DataContract { internal const string SerializerTrimmerWarning = "Data Contract Serialization and Deserialization might require types that cannot be statically analyzed. Make sure all of the " + @@ -46,6 +49,9 @@ internal DataContract(DataContractCriticalHelper helper) _ns = helper.Namespace; } + /// + /// Gets the contract type name for this data contract. + /// public virtual string? ContractType => null; internal MethodInfo? ParseMethod => _helper.ParseMethod; @@ -190,24 +196,36 @@ internal virtual object ReadXmlElement(XmlReaderDelegator xmlReader, XmlObjectSe throw new InvalidDataContractException(SR.Format(SR.UnexpectedContractType, DataContract.GetClrTypeFullName(GetType()), DataContract.GetClrTypeFullName(UnderlyingType))); } + /// + /// Gets a value indicating whether the data contract represents a value type. + /// public virtual bool IsValueType { get => _helper.IsValueType; internal set => _helper.IsValueType = value; } + /// + /// Gets a value indicating whether the data contract is serialized by reference. + /// public virtual bool IsReference { get => _helper.IsReference; internal set => _helper.IsReference = value; } + /// + /// Gets the XML qualified name for the data contract. + /// public virtual XmlQualifiedName XmlName { get => _helper.XmlName; internal set => _helper.XmlName = value; } + /// + /// Gets the base data contract for this data contract. + /// public virtual DataContract? BaseContract { [RequiresDynamicCode(DataContract.SerializerAOTWarning)] diff --git a/src/libraries/System.Private.DataContractSerialization/src/System/Runtime/Serialization/Json/DataContractJsonSerializer.cs b/src/libraries/System.Private.DataContractSerialization/src/System/Runtime/Serialization/Json/DataContractJsonSerializer.cs index 5072642b0087b2..8c86f0a3713e01 100644 --- a/src/libraries/System.Private.DataContractSerialization/src/System/Runtime/Serialization/Json/DataContractJsonSerializer.cs +++ b/src/libraries/System.Private.DataContractSerialization/src/System/Runtime/Serialization/Json/DataContractJsonSerializer.cs @@ -206,11 +206,20 @@ private XmlDictionaryString RootName // These Get/Set methods mirror the extensions that were added to DCS in the early days of Core, which allowed // using a slimmed-down surrogate on both NetFx and Core via type-forwarding mechanisms. That's why these are // a pair of methods instead of making the property itself public. + + /// + /// Gets the current serialization surrogate provider. + /// + /// The current instance, or if no provider is set. public ISerializationSurrogateProvider? GetSerializationSurrogateProvider() { return SerializationSurrogateProvider; } + /// + /// Sets the serialization surrogate provider. + /// + /// The to use for serialization, or to remove the current provider. public void SetSerializationSurrogateProvider(ISerializationSurrogateProvider? provider) { SerializationSurrogateProvider = provider; diff --git a/src/libraries/System.Reflection.Metadata/src/System/Reflection/Metadata/Ecma335/Encoding/BlobEncoders.cs b/src/libraries/System.Reflection.Metadata/src/System/Reflection/Metadata/Ecma335/Encoding/BlobEncoders.cs index 3ed78ab777a1bc..aeb6eae3bfb0df 100644 --- a/src/libraries/System.Reflection.Metadata/src/System/Reflection/Metadata/Ecma335/Encoding/BlobEncoders.cs +++ b/src/libraries/System.Reflection.Metadata/src/System/Reflection/Metadata/Ecma335/Encoding/BlobEncoders.cs @@ -424,6 +424,10 @@ public FieldTypeEncoder(BlobBuilder builder) Builder = builder; } + /// + /// Creates object that can be used to encode custom modifiers. + /// + /// A instance that can be used to encode custom modifiers. public CustomModifiersEncoder CustomModifiers() { return new CustomModifiersEncoder(Builder); diff --git a/src/libraries/System.Security.Cryptography/src/System/Security/Cryptography/X509Certificates/X509SubjectAlternativeNameExtension.cs b/src/libraries/System.Security.Cryptography/src/System/Security/Cryptography/X509Certificates/X509SubjectAlternativeNameExtension.cs index c6781214acc9c9..61dd5c2a8ed252 100644 --- a/src/libraries/System.Security.Cryptography/src/System/Security/Cryptography/X509Certificates/X509SubjectAlternativeNameExtension.cs +++ b/src/libraries/System.Security.Cryptography/src/System/Security/Cryptography/X509Certificates/X509SubjectAlternativeNameExtension.cs @@ -9,33 +9,57 @@ namespace System.Security.Cryptography.X509Certificates { + /// + /// Represents the Subject Alternative Name X.509 Extension (2.5.29.17). + /// public sealed class X509SubjectAlternativeNameExtension : X509Extension { private List? _decoded; + /// + /// Initializes a new instance of the class. + /// public X509SubjectAlternativeNameExtension() : base(Oids.SubjectAltNameOid) { _decoded = new List(0); } + /// + /// Initializes a new instance of the class from an encoded representation of the extension and an optional critical marker. + /// + /// The encoded data to use to create the extension. + /// if the extension is critical; otherwise, . The default is . public X509SubjectAlternativeNameExtension(byte[] rawData, bool critical = false) : base(Oids.SubjectAltNameOid, rawData, critical) { _decoded = Decode(RawData); } + /// + /// Initializes a new instance of the class from an encoded representation of the extension and an optional critical marker. + /// + /// The encoded data to use to create the extension. + /// if the extension is critical; otherwise, . The default is . public X509SubjectAlternativeNameExtension(ReadOnlySpan rawData, bool critical = false) : base(Oids.SubjectAltNameOid, rawData, critical) { _decoded = Decode(RawData); } + /// + /// Copies the extension properties of the specified object. + /// + /// The object whose extension properties to copy. public override void CopyFrom(AsnEncodedData asnEncodedData) { base.CopyFrom(asnEncodedData); _decoded = null; } + /// + /// Enumerates the alternative name entries with a DNS Name type identifier. + /// + /// An enumerable collection of alternative names with DNS Name type identifiers. public IEnumerable EnumerateDnsNames() { List decoded = (_decoded ??= Decode(RawData)); @@ -54,6 +78,10 @@ private static IEnumerable EnumerateDnsNames(List decode } } + /// + /// Enumerates the alternative name entries with an IP Address type identifier. + /// + /// An enumerable collection of alternative names with IP Address type identifiers. public IEnumerable EnumerateIPAddresses() { List decoded = (_decoded ??= Decode(RawData));