diff --git a/src/Components/Components/src/BindElementAttribute.cs b/src/Components/Components/src/BindElementAttribute.cs index ffc17a6049..4907b3e27e 100644 --- a/src/Components/Components/src/BindElementAttribute.cs +++ b/src/Components/Components/src/BindElementAttribute.cs @@ -1,4 +1,4 @@ -// Copyright (c) .NET Foundation. All rights reserved. +// Copyright (c) .NET Foundation. All rights reserved. // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information. using System; @@ -15,7 +15,7 @@ namespace Microsoft.AspNetCore.Components /// Constructs an instance of . /// /// The tag name of the element. - /// The suffix value. For example, set this to value for bind-value, or set this to null for bind. + /// The suffix value. For example, set this to value for bind-value, or set this to for bind. /// The name of the value attribute to be bound. /// The name of an attribute that will register an associated change event. public BindElementAttribute(string element, string suffix, string valueAttribute, string changeAttribute) @@ -47,7 +47,7 @@ namespace Microsoft.AspNetCore.Components /// /// Gets the suffix value. - /// For example, this will be value to mean bind-value, or null to mean bind. + /// For example, this will be value to mean bind-value, or to mean bind. /// public string Suffix { get; } diff --git a/src/Components/Web/src/BindInputElementAttribute.cs b/src/Components/Web/src/BindInputElementAttribute.cs index 0cba1a8e84..f6169c0ca5 100644 --- a/src/Components/Web/src/BindInputElementAttribute.cs +++ b/src/Components/Web/src/BindInputElementAttribute.cs @@ -7,7 +7,7 @@ using System.Globalization; namespace Microsoft.AspNetCore.Components { /// - /// Configures options for binding subtypes of an HTML input element. + /// Configures options for binding subtypes of an HTML input element. /// [AttributeUsage(AttributeTargets.Class, AllowMultiple = true, Inherited = true)] public sealed class BindInputElementAttribute : Attribute @@ -15,7 +15,7 @@ namespace Microsoft.AspNetCore.Components /// /// Constructs an instance of . /// - /// The value of the element's type attribute. + /// The value of the element's type attribute. /// The suffix value. /// The name of the value attribute to be bound. /// The name of an attribute that will register an associated change event. @@ -46,7 +46,7 @@ namespace Microsoft.AspNetCore.Components } /// - /// Gets the value of the element's type attribute. + /// Gets the value of the element's type attribute. /// public string Type { get; } diff --git a/src/Http/Authentication.Abstractions/src/IAuthenticationRequestHandler.cs b/src/Http/Authentication.Abstractions/src/IAuthenticationRequestHandler.cs index d2822cdc88..d0013725c6 100644 --- a/src/Http/Authentication.Abstractions/src/IAuthenticationRequestHandler.cs +++ b/src/Http/Authentication.Abstractions/src/IAuthenticationRequestHandler.cs @@ -13,7 +13,7 @@ namespace Microsoft.AspNetCore.Authentication /// /// Returns true if request processing should stop. /// - /// true if request processing should stop. + /// if request processing should stop. Task HandleRequestAsync(); } diff --git a/src/Http/Headers/src/HeaderUtilities.cs b/src/Http/Headers/src/HeaderUtilities.cs index 54034359fb..ff5bb5400c 100644 --- a/src/Http/Headers/src/HeaderUtilities.cs +++ b/src/Http/Headers/src/HeaderUtilities.cs @@ -230,8 +230,8 @@ namespace Microsoft.Net.Http.Headers /// any value originally supplied in result will be overwritten. /// /// - /// true if is found and successfully parsed; otherwise, - /// false. + /// if is found and successfully parsed; otherwise, + /// . /// // e.g. { "headerValue=10, targetHeaderValue=30" } public static bool TryParseSeconds(StringValues headerValues, string targetValue, out TimeSpan? value) @@ -286,8 +286,8 @@ namespace Microsoft.Net.Http.Headers /// The target cache control directives to look for. /// /// - /// true if is contained in ; - /// otherwise, false. + /// if is contained in ; + /// otherwise, . /// public static bool ContainsCacheDirective(StringValues cacheControlDirectives, string targetDirectives) { @@ -367,7 +367,7 @@ namespace Microsoft.Net.Http.Headers /// greater than Int64.MaxValue. This parameter is passed uninitialized; any value originally supplied in /// result will be overwritten. /// - /// true if parsing succeeded; otherwise, false. + /// if parsing succeeded; otherwise, . public static unsafe bool TryParseNonNegativeInt32(StringSegment value, out int result) { if (string.IsNullOrEmpty(value.Buffer) || value.Length == 0) @@ -418,7 +418,7 @@ namespace Microsoft.Net.Http.Headers /// represents a number greater than Int64.MaxValue. This parameter is passed uninitialized; any value /// originally supplied in result will be overwritten. /// - /// true if parsing succeeded; otherwise, false. + /// if parsing succeeded; otherwise, . public static unsafe bool TryParseNonNegativeInt64(StringSegment value, out long result) { if (string.IsNullOrEmpty(value.Buffer) || value.Length == 0) diff --git a/src/Http/Http.Abstractions/src/HostString.cs b/src/Http/Http.Abstractions/src/HostString.cs index 23850231bf..0f7cbd73f6 100644 --- a/src/Http/Http.Abstractions/src/HostString.cs +++ b/src/Http/Http.Abstractions/src/HostString.cs @@ -223,7 +223,7 @@ namespace Microsoft.AspNetCore.Http /// "abc.example.com:443" but not "example.com:443". /// Matching is case insensitive. /// - /// true if matches any of the patterns. + /// if matches any of the patterns. public static bool MatchesAny(StringSegment value, IList patterns) { if (value == null) @@ -282,7 +282,7 @@ namespace Microsoft.AspNetCore.Http /// Compares the equality of the Value property, ignoring case. /// /// The to compare against. - /// true if they have the same value. + /// if they have the same value. public bool Equals(HostString other) { if (!HasValue && !other.HasValue) @@ -296,7 +296,7 @@ namespace Microsoft.AspNetCore.Http /// Compares against the given object only if it is a HostString. /// /// The to compare against. - /// true if they have the same value. + /// if they have the same value. public override bool Equals(object obj) { if (ReferenceEquals(null, obj)) @@ -320,7 +320,7 @@ namespace Microsoft.AspNetCore.Http /// /// The left parameter. /// The right parameter. - /// true if both 's have the same value. + /// if both 's have the same value. public static bool operator ==(HostString left, HostString right) { return left.Equals(right); @@ -331,7 +331,7 @@ namespace Microsoft.AspNetCore.Http /// /// The left parameter. /// The right parameter. - /// true if both 's values are not equal. + /// if both 's values are not equal. public static bool operator !=(HostString left, HostString right) { return !left.Equals(right); diff --git a/src/Http/Http.Extensions/src/RequestHeaders.cs b/src/Http/Http.Extensions/src/RequestHeaders.cs index 94fa8149b9..2874be00b8 100644 --- a/src/Http/Http.Extensions/src/RequestHeaders.cs +++ b/src/Http/Http.Extensions/src/RequestHeaders.cs @@ -282,7 +282,7 @@ namespace Microsoft.AspNetCore.Http.Headers /// /// Gets the value of header with . /// - /// must contain a TryParse method with the signature public static bool TryParse(string, out T). + /// must contain a TryParse method with the signature public static bool TryParse(string, out T). /// The type of the header. /// The given type must have a static TryParse method. /// The name of the header to retrieve. @@ -295,7 +295,7 @@ namespace Microsoft.AspNetCore.Http.Headers /// /// Gets the values of header with . /// - /// must contain a TryParseList method with the signature public static bool TryParseList(IList<string>, out IList<T>). + /// must contain a TryParseList method with the signature public static bool TryParseList(IList<string>, out IList<T>). /// The type of the header. /// The given type must have a static TryParseList method. /// The name of the header to retrieve. diff --git a/src/Http/Http.Extensions/src/ResponseHeaders.cs b/src/Http/Http.Extensions/src/ResponseHeaders.cs index 2feff2fe3c..55aec1f575 100644 --- a/src/Http/Http.Extensions/src/ResponseHeaders.cs +++ b/src/Http/Http.Extensions/src/ResponseHeaders.cs @@ -161,7 +161,7 @@ namespace Microsoft.AspNetCore.Http.Headers /// /// Gets the value of header with . /// - /// must contain a TryParse method with the signature public static bool TryParse(string, out T). + /// must contain a TryParse method with the signature public static bool TryParse(string, out T). /// The type of the header. /// The given type must have a static TryParse method. /// The name of the header to retrieve. @@ -174,7 +174,7 @@ namespace Microsoft.AspNetCore.Http.Headers /// /// Gets the values of header with . /// - /// must contain a TryParseList method with the signature public static bool TryParseList(IList<string>, out IList<T>). + /// must contain a TryParseList method with the signature public static bool TryParseList(IList<string>, out IList<T>). /// The type of the header. /// The given type must have a static TryParseList method. /// The name of the header to retrieve. diff --git a/src/Http/Routing/src/RouteConstraintBuilder.cs b/src/Http/Routing/src/RouteConstraintBuilder.cs index 14c4e12f3c..9ff60e52a9 100644 --- a/src/Http/Routing/src/RouteConstraintBuilder.cs +++ b/src/Http/Routing/src/RouteConstraintBuilder.cs @@ -90,8 +90,8 @@ namespace Microsoft.AspNetCore.Routing /// /// If the is a string, it will be converted to a . /// - /// For example, the string Product[0-9]+ will be converted to the regular expression - /// ^(Product[0-9]+). See for more details. + /// For example, the string Product[0-9]+ will be converted to the regular expression + /// ^(Product[0-9]+). See for more details. /// public void AddConstraint(string key, object value) { diff --git a/src/Mvc/Mvc.Abstractions/src/ModelBinding/ModelStateDictionary.cs b/src/Mvc/Mvc.Abstractions/src/ModelBinding/ModelStateDictionary.cs index 53c475d199..48b8b9ee3a 100644 --- a/src/Mvc/Mvc.Abstractions/src/ModelBinding/ModelStateDictionary.cs +++ b/src/Mvc/Mvc.Abstractions/src/ModelBinding/ModelStateDictionary.cs @@ -81,7 +81,7 @@ namespace Microsoft.AspNetCore.Mvc.ModelBinding /// tracks the number of model errors added by calls to /// or /// . - /// Once the value of MaxAllowedErrors - 1 is reached, if another attempt is made to add an error, + /// Once the value of MaxAllowedErrors - 1 is reached, if another attempt is made to add an error, /// the error message will be ignored and a will be added. /// /// diff --git a/src/Mvc/Mvc.Core/src/Controllers/ControllerFeatureProvider.cs b/src/Mvc/Mvc.Core/src/Controllers/ControllerFeatureProvider.cs index 6b5a3616d2..caff2fc22b 100644 --- a/src/Mvc/Mvc.Core/src/Controllers/ControllerFeatureProvider.cs +++ b/src/Mvc/Mvc.Core/src/Controllers/ControllerFeatureProvider.cs @@ -1,4 +1,4 @@ -// Copyright (c) .NET Foundation. All rights reserved. +// Copyright (c) .NET Foundation. All rights reserved. // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information. using System; @@ -37,7 +37,7 @@ namespace Microsoft.AspNetCore.Mvc.Controllers /// Determines if a given is a controller. /// /// The candidate. - /// true if the type is a controller; otherwise false. + /// if the type is a controller; otherwise . protected virtual bool IsController(TypeInfo typeInfo) { if (!typeInfo.IsClass) diff --git a/src/Mvc/Mvc.Core/src/Formatters/MediaTypeCollection.cs b/src/Mvc/Mvc.Core/src/Formatters/MediaTypeCollection.cs index b5b52f3ebb..a596862b36 100644 --- a/src/Mvc/Mvc.Core/src/Formatters/MediaTypeCollection.cs +++ b/src/Mvc/Mvc.Core/src/Formatters/MediaTypeCollection.cs @@ -50,8 +50,8 @@ namespace Microsoft.AspNetCore.Mvc.Formatters /// Removes the first occurrence of a specific media type from the . /// /// - /// true if is successfully removed; otherwise, false. - /// This method also returns false if was not found in the original + /// if is successfully removed; otherwise, . + /// This method also returns if was not found in the original /// . public bool Remove(MediaTypeHeaderValue item) { diff --git a/src/Mvc/Mvc.Core/src/Routing/IRouteValueProvider.cs b/src/Mvc/Mvc.Core/src/Routing/IRouteValueProvider.cs index 6bd09db26b..e40059bbbd 100644 --- a/src/Mvc/Mvc.Core/src/Routing/IRouteValueProvider.cs +++ b/src/Mvc/Mvc.Core/src/Routing/IRouteValueProvider.cs @@ -25,7 +25,7 @@ namespace Microsoft.AspNetCore.Mvc.Routing /// /// /// - /// For an action like MyApp.Controllers.HomeController.Index(), in order to be selected, the + /// For an action like MyApp.Controllers.HomeController.Index(), in order to be selected, the /// must contain the values /// { /// "action": "Index", @@ -39,11 +39,11 @@ namespace Microsoft.AspNetCore.Mvc.Routing /// ) or are considered 'outside' of areas by having the value null. /// /// - /// Consider an application with two controllers, each with an Index action method: - /// - MyApp.Controllers.HomeController.Index() - /// - MyApp.Areas.Blog.Controllers.HomeController.Index() - /// where MyApp.Areas.Blog.Controllers.HomeController has an area attribute - /// [Area("Blog")]. + /// Consider an application with two controllers, each with an Index action method: + /// - MyApp.Controllers.HomeController.Index() + /// - MyApp.Areas.Blog.Controllers.HomeController.Index() + /// where MyApp.Areas.Blog.Controllers.HomeController has an area attribute + /// [Area("Blog")]. /// /// For like: /// { @@ -51,8 +51,8 @@ namespace Microsoft.AspNetCore.Mvc.Routing /// "controller": "Home" /// } /// - /// MyApp.Controllers.HomeController.Index() will be selected. - /// MyApp.Area.Blog.Controllers.HomeController.Index() is not considered eligible because the + /// MyApp.Controllers.HomeController.Index() will be selected. + /// MyApp.Area.Blog.Controllers.HomeController.Index() is not considered eligible because the /// does not contain the value 'Blog' for 'area'. /// /// For like: @@ -62,9 +62,9 @@ namespace Microsoft.AspNetCore.Mvc.Routing /// "controller": "Home" /// } /// - /// MyApp.Area.Blog.Controllers.HomeController.Index() will be selected. - /// MyApp.Controllers.HomeController.Index() is not considered eligible because the route values - /// contain a value for 'area'. MyApp.Controllers.HomeController.Index() cannot match any value + /// MyApp.Area.Blog.Controllers.HomeController.Index() will be selected. + /// MyApp.Controllers.HomeController.Index() is not considered eligible because the route values + /// contain a value for 'area'. MyApp.Controllers.HomeController.Index() cannot match any value /// for 'area' other than null. /// /// diff --git a/src/Mvc/Mvc.Razor/src/Internal/RazorInjectAttribute.cs b/src/Mvc/Mvc.Razor/src/Internal/RazorInjectAttribute.cs index a981e6eb66..7f1c211da3 100644 --- a/src/Mvc/Mvc.Razor/src/Internal/RazorInjectAttribute.cs +++ b/src/Mvc/Mvc.Razor/src/Internal/RazorInjectAttribute.cs @@ -8,7 +8,7 @@ namespace Microsoft.AspNetCore.Mvc.Razor.Internal /// /// Specifies that the attributed property should be bound using request services. /// - /// This attribute is used as the backing attribute for the @inject + /// This attribute is used as the backing attribute for the @inject /// Razor directive. /// /// diff --git a/src/Mvc/Mvc.Testing/src/WebApplicationFactoryContentRootAttribute.cs b/src/Mvc/Mvc.Testing/src/WebApplicationFactoryContentRootAttribute.cs index 51832bd7a8..19faf8d7f1 100644 --- a/src/Mvc/Mvc.Testing/src/WebApplicationFactoryContentRootAttribute.cs +++ b/src/Mvc/Mvc.Testing/src/WebApplicationFactoryContentRootAttribute.cs @@ -1,4 +1,4 @@ -// Copyright (c) .NET Foundation. All rights reserved. +// Copyright (c) .NET Foundation. All rights reserved. // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information. using System; @@ -16,7 +16,7 @@ namespace Microsoft.AspNetCore.Mvc.Testing /// is equal to TEntryPoint , /// order them by in ascending order. /// will check for the existence of the marker - /// in Path.Combine(, Path.GetFileName())" + /// in Path.Combine(, Path.GetFileName())" /// and if the file exists it will set the content root to . /// [AttributeUsage(AttributeTargets.Assembly, Inherited = false, AllowMultiple = true)] @@ -33,7 +33,7 @@ namespace Microsoft.AspNetCore.Mvc.Testing /// /// The path to the content root. This path can be either relative or absolute. /// In case the path is relative, the path will be combined with - /// + /// /// /// A file that will be use as a marker to determine that the content root path for the given context is correct. /// diff --git a/src/Mvc/Mvc.ViewFeatures/src/Rendering/MultiSelectList.cs b/src/Mvc/Mvc.ViewFeatures/src/Rendering/MultiSelectList.cs index 360b75b87e..f9205363a2 100644 --- a/src/Mvc/Mvc.ViewFeatures/src/Rendering/MultiSelectList.cs +++ b/src/Mvc/Mvc.ViewFeatures/src/Rendering/MultiSelectList.cs @@ -12,7 +12,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering { /// /// Represents a list that lets users select multiple items. - /// This class is typically rendered as an HTML <select multiple="multiple"> element with the specified collection + /// This class is typically rendered as an HTML <select multiple="multiple"> element with the specified collection /// of objects. /// public class MultiSelectList : IEnumerable diff --git a/src/Mvc/Mvc.ViewFeatures/src/Rendering/SelectList.cs b/src/Mvc/Mvc.ViewFeatures/src/Rendering/SelectList.cs index 7d30bffeb7..69649326c8 100644 --- a/src/Mvc/Mvc.ViewFeatures/src/Rendering/SelectList.cs +++ b/src/Mvc/Mvc.ViewFeatures/src/Rendering/SelectList.cs @@ -8,7 +8,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering { /// /// Represents a list that lets users select a single item. - /// This class is typically rendered as an HTML <select> element with the specified collection + /// This class is typically rendered as an HTML <select> element with the specified collection /// of objects. /// public class SelectList : MultiSelectList diff --git a/src/Mvc/Mvc.ViewFeatures/src/Rendering/SelectListItem.cs b/src/Mvc/Mvc.ViewFeatures/src/Rendering/SelectListItem.cs index 4a3efe43fb..4735b973c8 100644 --- a/src/Mvc/Mvc.ViewFeatures/src/Rendering/SelectListItem.cs +++ b/src/Mvc/Mvc.ViewFeatures/src/Rendering/SelectListItem.cs @@ -5,7 +5,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering { /// /// Represents an item in a or . - /// This class is typically rendered as an HTML <option> element with the specified + /// This class is typically rendered as an HTML <option> element with the specified /// attribute values. /// public class SelectListItem @@ -54,8 +54,8 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// Gets or sets a value that indicates whether this is disabled. - /// This property is typically rendered as a disabled="disabled" attribute in the HTML - /// <option> element. + /// This property is typically rendered as a disabled="disabled" attribute in the HTML + /// <option> element. /// public bool Disabled { get; set; } @@ -68,21 +68,21 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// Gets or sets a value that indicates whether this is selected. - /// This property is typically rendered as a selected="selected" attribute in the HTML - /// <option> element. + /// This property is typically rendered as a selected="selected" attribute in the HTML + /// <option> element. /// public bool Selected { get; set; } /// /// Gets or sets a value that indicates the display text of this . - /// This property is typically rendered as the inner HTML in the HTML <option> element. + /// This property is typically rendered as the inner HTML in the HTML <option> element. /// public string Text { get; set; } /// /// Gets or sets a value that indicates the value of this . - /// This property is typically rendered as a value="..." attribute in the HTML - /// <option> element. + /// This property is typically rendered as a value="..." attribute in the HTML + /// <option> element. /// public string Value { get; set; } } diff --git a/src/Mvc/Mvc.ViewFeatures/src/ViewComponents/ViewComponentDescriptor.cs b/src/Mvc/Mvc.ViewFeatures/src/ViewComponents/ViewComponentDescriptor.cs index 4aa1125757..cc7578de77 100644 --- a/src/Mvc/Mvc.ViewFeatures/src/ViewComponents/ViewComponentDescriptor.cs +++ b/src/Mvc/Mvc.ViewFeatures/src/ViewComponents/ViewComponentDescriptor.cs @@ -57,7 +57,7 @@ namespace Microsoft.AspNetCore.Mvc.ViewComponents /// /// The full name is defaulted to the full namespace of the view component class, prepended to /// the class name with a '.' character as the separator. If the view component class uses - /// ViewComponent as a suffix, the suffix will be omitted from the . + /// ViewComponent as a suffix, the suffix will be omitted from the . /// /// /// Class Name: Contoso.Products.LoginViewComponent @@ -92,7 +92,7 @@ namespace Microsoft.AspNetCore.Mvc.ViewComponents /// /// /// The short name is defaulted to the name of the view component class. If the view component class uses - /// ViewComponent as a suffix, the suffix will be omitted from the . + /// ViewComponent as a suffix, the suffix will be omitted from the . /// /// /// Class Name: Contoso.Products.LoginViewComponent diff --git a/src/Security/Authentication/WsFederation/src/WsFederationHandler.cs b/src/Security/Authentication/WsFederation/src/WsFederationHandler.cs index 27bb332ccf..41b9509f57 100644 --- a/src/Security/Authentication/WsFederation/src/WsFederationHandler.cs +++ b/src/Security/Authentication/WsFederation/src/WsFederationHandler.cs @@ -1,4 +1,4 @@ -// Copyright (c) .NET Foundation. All rights reserved. +// Copyright (c) .NET Foundation. All rights reserved. // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information. using System; @@ -54,7 +54,7 @@ namespace Microsoft.AspNetCore.Authentication.WsFederation /// /// Overridden to handle remote signout requests /// - /// true if request processing should stop. + /// if request processing should stop. public override Task HandleRequestAsync() { // RemoteSignOutPath and CallbackPath may be the same, fall through if the message doesn't match.