diff --git a/NuGetPackageVerifier.json b/NuGetPackageVerifier.json index d77ace68be..21c36d6f60 100644 --- a/NuGetPackageVerifier.json +++ b/NuGetPackageVerifier.json @@ -1,12 +1,7 @@ { "adx": { // Packages written by the ADX team and that ship on NuGet.org "rules": [ - "AssemblyHasDocumentFileRule", - "AssemblyHasVersionAttributesRule", - "AssemblyHasServicingAttributeRule", - "AssemblyHasNeutralResourcesLanguageAttributeRule", - "SatellitePackageRule", - "StrictSemanticVersionValidationRule" + "AdxVerificationCompositeRule" ], "packages": { "Microsoft.AspNetCore.Mvc": { }, @@ -27,12 +22,7 @@ }, "Default": { // Rules to run for packages not listed in any other set. "rules": [ - "AssemblyHasDocumentFileRule", - "AssemblyHasVersionAttributesRule", - "AssemblyHasServicingAttributeRule", - "AssemblyHasNeutralResourcesLanguageAttributeRule", - "SatellitePackageRule", - "StrictSemanticVersionValidationRule" + "DefaultCompositeRule" ] } } diff --git a/src/Microsoft.AspNetCore.Mvc.Abstractions/ActionConstraints/ActionConstraintProviderContext.cs b/src/Microsoft.AspNetCore.Mvc.Abstractions/ActionConstraints/ActionConstraintProviderContext.cs index 01ac6d223c..5618cfe2b5 100644 --- a/src/Microsoft.AspNetCore.Mvc.Abstractions/ActionConstraints/ActionConstraintProviderContext.cs +++ b/src/Microsoft.AspNetCore.Mvc.Abstractions/ActionConstraints/ActionConstraintProviderContext.cs @@ -16,6 +16,7 @@ namespace Microsoft.AspNetCore.Mvc.ActionConstraints /// /// Creates a new . /// + /// The associated with the request. /// The for which constraints are being created. /// The list of objects. public ActionConstraintProviderContext( @@ -43,6 +44,9 @@ namespace Microsoft.AspNetCore.Mvc.ActionConstraints Results = items; } + /// + /// The associated with the request. + /// public HttpContext HttpContext { get; } /// diff --git a/src/Microsoft.AspNetCore.Mvc.Abstractions/Filters/IOrderedFilter.cs b/src/Microsoft.AspNetCore.Mvc.Abstractions/Filters/IOrderedFilter.cs index b29788592d..452cb70d63 100644 --- a/src/Microsoft.AspNetCore.Mvc.Abstractions/Filters/IOrderedFilter.cs +++ b/src/Microsoft.AspNetCore.Mvc.Abstractions/Filters/IOrderedFilter.cs @@ -21,7 +21,7 @@ namespace Microsoft.AspNetCore.Mvc.Filters /// /// /// Synchronous filters, such as , have a before-method, such as - /// , and an after-method, such as + /// , and an after-method, such as /// . A synchronous filter with a lower numeric /// value will have its before-method executed before that of a filter with a higher value of /// . During the after-stage of the filter, a synchronous filter with a lower diff --git a/src/Microsoft.AspNetCore.Mvc.Abstractions/ModelBinding/ModelBindingContext.cs b/src/Microsoft.AspNetCore.Mvc.Abstractions/ModelBinding/ModelBindingContext.cs index 35690dc1e1..46bba22316 100644 --- a/src/Microsoft.AspNetCore.Mvc.Abstractions/ModelBinding/ModelBindingContext.cs +++ b/src/Microsoft.AspNetCore.Mvc.Abstractions/ModelBinding/ModelBindingContext.cs @@ -139,12 +139,12 @@ namespace Microsoft.AspNetCore.Mvc.ModelBinding public abstract NestedScope EnterNestedScope(); /// - /// Removes a layer of state pushed by calling . + /// Removes a layer of state pushed by calling . /// protected abstract void ExitNestedScope(); /// - /// Return value of . Should be disposed + /// Return value of . Should be disposed /// by caller when child binding context state should be popped off of /// the . /// @@ -162,7 +162,7 @@ namespace Microsoft.AspNetCore.Mvc.ModelBinding } /// - /// Exits the created by calling . + /// Exits the created by calling . /// public void Dispose() { diff --git a/src/Microsoft.AspNetCore.Mvc.Abstractions/ModelBinding/ModelMetadata.cs b/src/Microsoft.AspNetCore.Mvc.Abstractions/ModelBinding/ModelMetadata.cs index 923bcd158c..c21f6489c0 100644 --- a/src/Microsoft.AspNetCore.Mvc.Abstractions/ModelBinding/ModelMetadata.cs +++ b/src/Microsoft.AspNetCore.Mvc.Abstractions/ModelBinding/ModelMetadata.cs @@ -143,7 +143,7 @@ namespace Microsoft.AspNetCore.Mvc.ModelBinding /// . /// /// - /// An of mappings between + /// An of of mappings between /// field groups, names and values. null if is false. /// public abstract IEnumerable> EnumGroupedDisplayNamesAndValues { get; } @@ -152,7 +152,7 @@ namespace Microsoft.AspNetCore.Mvc.ModelBinding /// Gets the names and values of all values in . /// /// - /// An of mappings between field names + /// An of mappings between field names /// and values. null if is false. /// public abstract IReadOnlyDictionary EnumNamesAndValues { get; } diff --git a/src/Microsoft.AspNetCore.Mvc.Abstractions/ModelBinding/ModelStateDictionary.cs b/src/Microsoft.AspNetCore.Mvc.Abstractions/ModelBinding/ModelStateDictionary.cs index 4d97e7d8eb..f6bdaf83dd 100644 --- a/src/Microsoft.AspNetCore.Mvc.Abstractions/ModelBinding/ModelStateDictionary.cs +++ b/src/Microsoft.AspNetCore.Mvc.Abstractions/ModelBinding/ModelStateDictionary.cs @@ -110,7 +110,7 @@ namespace Microsoft.AspNetCore.Mvc.ModelBinding /// /// Gets the number of errors added to this instance of via - /// or . + /// or . /// public int ErrorCount { get; private set; } @@ -203,6 +203,7 @@ namespace Microsoft.AspNetCore.Mvc.ModelBinding /// /// The key of the to add errors to. /// The to add. + /// The associated with the model. public void AddModelError(string key, Exception exception, ModelMetadata metadata) { if (key == null) @@ -230,6 +231,7 @@ namespace Microsoft.AspNetCore.Mvc.ModelBinding /// /// The key of the to add errors to. /// The to add. + /// The associated with the model. /// /// True if the given error was added, false if the error was ignored. /// See . @@ -449,9 +451,9 @@ namespace Microsoft.AspNetCore.Mvc.ModelBinding /// the with the specified . /// /// The key for the entry. - /// The raw value for the entry. + /// The raw value for the entry. /// - /// The values of in a comma-separated . + /// The values of in a comma-separated . /// public void SetModelValue(string key, object rawValue, string attemptedValue) { diff --git a/src/Microsoft.AspNetCore.Mvc.Abstractions/ModelBinding/Validation/ClientValidatorProviderContext.cs b/src/Microsoft.AspNetCore.Mvc.Abstractions/ModelBinding/Validation/ClientValidatorProviderContext.cs index fcfcadf14d..68ced77b45 100644 --- a/src/Microsoft.AspNetCore.Mvc.Abstractions/ModelBinding/Validation/ClientValidatorProviderContext.cs +++ b/src/Microsoft.AspNetCore.Mvc.Abstractions/ModelBinding/Validation/ClientValidatorProviderContext.cs @@ -44,7 +44,7 @@ namespace Microsoft.AspNetCore.Mvc.ModelBinding.Validation /// /// Gets the list of instances. /// instances should add the appropriate properties when - /// + /// /// is called. /// public IList Results { get; } diff --git a/src/Microsoft.AspNetCore.Mvc.Abstractions/ModelBinding/ValueProviderResult.cs b/src/Microsoft.AspNetCore.Mvc.Abstractions/ModelBinding/ValueProviderResult.cs index d0e3d206b7..69b1b27af6 100644 --- a/src/Microsoft.AspNetCore.Mvc.Abstractions/ModelBinding/ValueProviderResult.cs +++ b/src/Microsoft.AspNetCore.Mvc.Abstractions/ModelBinding/ValueProviderResult.cs @@ -21,7 +21,7 @@ namespace Microsoft.AspNetCore.Mvc.ModelBinding /// multiple values were submitted. /// /// - /// Treat as an to consume all values, + /// Treat as an to consume all values, /// regardless of whether a single value or multiple values were submitted. /// /// @@ -46,7 +46,7 @@ namespace Microsoft.AspNetCore.Mvc.ModelBinding /// /// Creates a new . /// - /// The submitted value. + /// The submitted values. /// The associated with this value. public ValueProviderResult(StringValues values, CultureInfo culture) { @@ -134,9 +134,9 @@ namespace Microsoft.AspNetCore.Mvc.ModelBinding } /// - /// Gets an for this . + /// Gets an for this . /// - /// An . + /// An . public IEnumerator GetEnumerator() { return ((IEnumerable)Values).GetEnumerator(); diff --git a/src/Microsoft.AspNetCore.Mvc.Abstractions/project.json b/src/Microsoft.AspNetCore.Mvc.Abstractions/project.json index e46d5043cb..439c1b112a 100644 --- a/src/Microsoft.AspNetCore.Mvc.Abstractions/project.json +++ b/src/Microsoft.AspNetCore.Mvc.Abstractions/project.json @@ -7,7 +7,9 @@ }, "compilationOptions": { "warningsAsErrors": true, - "keyFile": "../../tools/Key.snk" + "keyFile": "../../tools/Key.snk", + "nowarn": [ "CS1591" ], + "xmlDoc": true }, "dependencies": { "Microsoft.AspNetCore.Routing.Abstractions": "1.0.0-*", diff --git a/src/Microsoft.AspNetCore.Mvc.ApiExplorer/ApiDescriptionGroupCollectionProvider.cs b/src/Microsoft.AspNetCore.Mvc.ApiExplorer/ApiDescriptionGroupCollectionProvider.cs index 4a1ae7ae98..1d7976d5bd 100644 --- a/src/Microsoft.AspNetCore.Mvc.ApiExplorer/ApiDescriptionGroupCollectionProvider.cs +++ b/src/Microsoft.AspNetCore.Mvc.ApiExplorer/ApiDescriptionGroupCollectionProvider.cs @@ -22,7 +22,7 @@ namespace Microsoft.AspNetCore.Mvc.ApiExplorer /// The . /// /// - /// The . + /// The . /// public ApiDescriptionGroupCollectionProvider( IActionDescriptorCollectionProvider actionDescriptorCollectionProvider, diff --git a/src/Microsoft.AspNetCore.Mvc.ApiExplorer/DefaultApiDescriptionProvider.cs b/src/Microsoft.AspNetCore.Mvc.ApiExplorer/DefaultApiDescriptionProvider.cs index 11740057a9..8215cfe67a 100644 --- a/src/Microsoft.AspNetCore.Mvc.ApiExplorer/DefaultApiDescriptionProvider.cs +++ b/src/Microsoft.AspNetCore.Mvc.ApiExplorer/DefaultApiDescriptionProvider.cs @@ -589,13 +589,6 @@ namespace Microsoft.AspNetCore.Mvc.ApiExplorer Visit(context, source, containerName: string.Empty); } - /// - /// Visits a node in a model, and attempts to create for any - /// model properties that are leaf nodes (see comments). - /// - /// The metadata for the model. - /// The from the ambient context. - /// The current name prefix (to prepend to property names). private void Visit( ApiParameterDescriptionContext bindingContext, BindingSource ambientSource, diff --git a/src/Microsoft.AspNetCore.Mvc.ApiExplorer/project.json b/src/Microsoft.AspNetCore.Mvc.ApiExplorer/project.json index 0f8cb2957b..fa0664a164 100644 --- a/src/Microsoft.AspNetCore.Mvc.ApiExplorer/project.json +++ b/src/Microsoft.AspNetCore.Mvc.ApiExplorer/project.json @@ -7,7 +7,9 @@ }, "compilationOptions": { "warningsAsErrors": true, - "keyFile": "../../tools/Key.snk" + "keyFile": "../../tools/Key.snk", + "nowarn": [ "CS1591" ], + "xmlDoc": true }, "dependencies": { "Microsoft.AspNetCore.Mvc.Core": "1.0.0-*", diff --git a/src/Microsoft.AspNetCore.Mvc.Core/ChallengeResult.cs b/src/Microsoft.AspNetCore.Mvc.Core/ChallengeResult.cs index 2d8b6c8277..5f1fb28767 100644 --- a/src/Microsoft.AspNetCore.Mvc.Core/ChallengeResult.cs +++ b/src/Microsoft.AspNetCore.Mvc.Core/ChallengeResult.cs @@ -12,7 +12,7 @@ using Microsoft.Extensions.Logging; namespace Microsoft.AspNetCore.Mvc { /// - /// An that on execution invokes . + /// An that on execution invokes . /// public class ChallengeResult : ActionResult { @@ -38,7 +38,7 @@ namespace Microsoft.AspNetCore.Mvc /// Initializes a new instance of with the /// specified authentication schemes. /// - /// The authentication schemes to challenge. + /// The authentication schemes to challenge. public ChallengeResult(IList authenticationSchemes) : this(authenticationSchemes, properties: null) { @@ -71,7 +71,7 @@ namespace Microsoft.AspNetCore.Mvc /// Initializes a new instance of with the /// specified authentication schemes and . /// - /// The authentication scheme to challenge. + /// The authentication scheme to challenge. /// used to perform the authentication /// challenge. public ChallengeResult(IList authenticationSchemes, AuthenticationProperties properties) diff --git a/src/Microsoft.AspNetCore.Mvc.Core/ControllerBase.cs b/src/Microsoft.AspNetCore.Mvc.Core/ControllerBase.cs index e44e9795e3..e60e2d2fa6 100644 --- a/src/Microsoft.AspNetCore.Mvc.Core/ControllerBase.cs +++ b/src/Microsoft.AspNetCore.Mvc.Core/ControllerBase.cs @@ -935,7 +935,7 @@ namespace Microsoft.AspNetCore.Mvc /// /// Creates a with the specified authentication schemes. /// - /// The authentication schemes to challenge. + /// The authentication schemes to challenge. /// The created for the response. [NonAction] public virtual ChallengeResult Challenge(IList authenticationSchemes) @@ -967,7 +967,7 @@ namespace Microsoft.AspNetCore.Mvc /// Creates a with the specified specified authentication schemes and /// . /// - /// The authentication schemes to challenge. + /// The authentication schemes to challenge. /// used to perform the authentication /// challenge. /// The created for the response. @@ -997,7 +997,7 @@ namespace Microsoft.AspNetCore.Mvc /// /// Creates a with the specified authentication schemes. /// - /// The authentication schemes to challenge. + /// The authentication schemes to challenge. /// The created for the response. [NonAction] public virtual ForbidResult Forbid(IList authenticationSchemes) @@ -1029,7 +1029,7 @@ namespace Microsoft.AspNetCore.Mvc /// Creates a with the specified specified authentication schemes and /// . /// - /// The authentication schemes to challenge. + /// The authentication schemes to challenge. /// used to perform the authentication /// challenge. /// The created for the response. diff --git a/src/Microsoft.AspNetCore.Mvc.Core/Controllers/IControllerActivator.cs b/src/Microsoft.AspNetCore.Mvc.Core/Controllers/IControllerActivator.cs index 46c7259638..72ff618b48 100644 --- a/src/Microsoft.AspNetCore.Mvc.Core/Controllers/IControllerActivator.cs +++ b/src/Microsoft.AspNetCore.Mvc.Core/Controllers/IControllerActivator.cs @@ -19,6 +19,7 @@ namespace Microsoft.AspNetCore.Mvc.Controllers /// /// Releases a controller. /// + /// The for the executing action. /// The controller to release. void Release(ControllerContext context, object controller); } diff --git a/src/Microsoft.AspNetCore.Mvc.Core/Controllers/IControllerFactory.cs b/src/Microsoft.AspNetCore.Mvc.Core/Controllers/IControllerFactory.cs index e4a16086f1..ae66e446a7 100644 --- a/src/Microsoft.AspNetCore.Mvc.Core/Controllers/IControllerFactory.cs +++ b/src/Microsoft.AspNetCore.Mvc.Core/Controllers/IControllerFactory.cs @@ -18,6 +18,7 @@ namespace Microsoft.AspNetCore.Mvc.Controllers /// /// Releases a controller instance. /// + /// for the executing action. /// The controller. void ReleaseController(ControllerContext context, object controller); } diff --git a/src/Microsoft.AspNetCore.Mvc.Core/ForbidResult.cs b/src/Microsoft.AspNetCore.Mvc.Core/ForbidResult.cs index 37b86e3e42..6effcb8673 100644 --- a/src/Microsoft.AspNetCore.Mvc.Core/ForbidResult.cs +++ b/src/Microsoft.AspNetCore.Mvc.Core/ForbidResult.cs @@ -12,7 +12,7 @@ using Microsoft.Extensions.Logging; namespace Microsoft.AspNetCore.Mvc { /// - /// An that on execution invokes . + /// An that on execution invokes . /// public class ForbidResult : ActionResult { @@ -38,7 +38,7 @@ namespace Microsoft.AspNetCore.Mvc /// Initializes a new instance of with the /// specified authentication schemes. /// - /// The authentication schemes to challenge. + /// The authentication schemes to challenge. public ForbidResult(IList authenticationSchemes) : this(authenticationSchemes, properties: null) { @@ -71,7 +71,7 @@ namespace Microsoft.AspNetCore.Mvc /// Initializes a new instance of with the /// specified authentication schemes and . /// - /// The authentication scheme to challenge. + /// The authentication scheme to challenge. /// used to perform the authentication /// challenge. public ForbidResult(IList authenticationSchemes, AuthenticationProperties properties) diff --git a/src/Microsoft.AspNetCore.Mvc.Core/Formatters/TextOutputFormatter.cs b/src/Microsoft.AspNetCore.Mvc.Core/Formatters/TextOutputFormatter.cs index 808c906e13..05af51ffcb 100644 --- a/src/Microsoft.AspNetCore.Mvc.Core/Formatters/TextOutputFormatter.cs +++ b/src/Microsoft.AspNetCore.Mvc.Core/Formatters/TextOutputFormatter.cs @@ -58,7 +58,7 @@ namespace Microsoft.AspNetCore.Mvc.Formatters /// /// Determines the best amongst the supported encodings - /// for reading or writing an HTTP entity body based on the provided . + /// for reading or writing an HTTP entity body based on the provided content type. /// /// The formatter context associated with the call. /// diff --git a/src/Microsoft.AspNetCore.Mvc.Core/Internal/ActionSelector.cs b/src/Microsoft.AspNetCore.Mvc.Core/Internal/ActionSelector.cs index c6a6685399..5c8d4e84e3 100644 --- a/src/Microsoft.AspNetCore.Mvc.Core/Internal/ActionSelector.cs +++ b/src/Microsoft.AspNetCore.Mvc.Core/Internal/ActionSelector.cs @@ -26,7 +26,8 @@ namespace Microsoft.AspNetCore.Mvc.Internal /// Creates a new . /// /// The . - /// The set of instances. + /// The that + /// providers a set of instances. /// The . public ActionSelector( IActionSelectorDecisionTreeProvider decisionTreeProvider, diff --git a/src/Microsoft.AspNetCore.Mvc.Core/Internal/DefaultObjectValidator.cs b/src/Microsoft.AspNetCore.Mvc.Core/Internal/DefaultObjectValidator.cs index 5c86e2a8eb..dbdceb5f85 100644 --- a/src/Microsoft.AspNetCore.Mvc.Core/Internal/DefaultObjectValidator.cs +++ b/src/Microsoft.AspNetCore.Mvc.Core/Internal/DefaultObjectValidator.cs @@ -19,6 +19,7 @@ namespace Microsoft.AspNetCore.Mvc.Internal /// Initializes a new instance of . /// /// The . + /// The . public DefaultObjectValidator( IModelMetadataProvider modelMetadataProvider, ValidatorCache validatorCache) diff --git a/src/Microsoft.AspNetCore.Mvc.Core/Internal/ITypeActivatorCache.cs b/src/Microsoft.AspNetCore.Mvc.Core/Internal/ITypeActivatorCache.cs index b77c47e76c..a097b29910 100644 --- a/src/Microsoft.AspNetCore.Mvc.Core/Internal/ITypeActivatorCache.cs +++ b/src/Microsoft.AspNetCore.Mvc.Core/Internal/ITypeActivatorCache.cs @@ -15,8 +15,8 @@ namespace Microsoft.AspNetCore.Mvc.Internal /// Creates an instance of . /// /// The used to resolve dependencies for - /// . - /// The of the to create. + /// . + /// The of the to create. TInstance CreateInstance(IServiceProvider serviceProvider, Type optionType); } } \ No newline at end of file diff --git a/src/Microsoft.AspNetCore.Mvc.Core/Internal/MemoryPoolHttpRequestStreamReaderFactory.cs b/src/Microsoft.AspNetCore.Mvc.Core/Internal/MemoryPoolHttpRequestStreamReaderFactory.cs index d006ebcb54..108956b40b 100644 --- a/src/Microsoft.AspNetCore.Mvc.Core/Internal/MemoryPoolHttpRequestStreamReaderFactory.cs +++ b/src/Microsoft.AspNetCore.Mvc.Core/Internal/MemoryPoolHttpRequestStreamReaderFactory.cs @@ -26,10 +26,10 @@ namespace Microsoft.AspNetCore.Mvc.Internal /// Creates a new . /// /// - /// The for creating buffers. + /// The for creating buffers. /// /// - /// The for creating buffers. + /// The for creating buffers. /// public MemoryPoolHttpRequestStreamReaderFactory( ArrayPool bytePool, diff --git a/src/Microsoft.AspNetCore.Mvc.Core/Internal/MemoryPoolHttpResponseStreamWriterFactory.cs b/src/Microsoft.AspNetCore.Mvc.Core/Internal/MemoryPoolHttpResponseStreamWriterFactory.cs index 4d66f3af3a..95e0615613 100644 --- a/src/Microsoft.AspNetCore.Mvc.Core/Internal/MemoryPoolHttpResponseStreamWriterFactory.cs +++ b/src/Microsoft.AspNetCore.Mvc.Core/Internal/MemoryPoolHttpResponseStreamWriterFactory.cs @@ -26,10 +26,10 @@ namespace Microsoft.AspNetCore.Mvc.Internal /// Creates a new . /// /// - /// The for creating buffers. + /// The for creating buffers. /// /// - /// The for creating buffers. + /// The for creating buffers. /// public MemoryPoolHttpResponseStreamWriterFactory( ArrayPool bytePool, diff --git a/src/Microsoft.AspNetCore.Mvc.Core/LocalRedirectResult.cs b/src/Microsoft.AspNetCore.Mvc.Core/LocalRedirectResult.cs index dbc32011c0..b42b259df7 100644 --- a/src/Microsoft.AspNetCore.Mvc.Core/LocalRedirectResult.cs +++ b/src/Microsoft.AspNetCore.Mvc.Core/LocalRedirectResult.cs @@ -31,7 +31,7 @@ namespace Microsoft.AspNetCore.Mvc /// Initializes a new instance of the class with the values /// provided. /// - /// The local URL to redirect to. + /// The local URL to redirect to. /// Specifies whether the redirect should be permanent (301) or temporary (302). public LocalRedirectResult(string localUrl, bool permanent) { diff --git a/src/Microsoft.AspNetCore.Mvc.Core/ModelBinding/ModelBindingHelper.cs b/src/Microsoft.AspNetCore.Mvc.Core/ModelBinding/ModelBindingHelper.cs index 5b120d9f05..6c699515a6 100644 --- a/src/Microsoft.AspNetCore.Mvc.Core/ModelBinding/ModelBindingHelper.cs +++ b/src/Microsoft.AspNetCore.Mvc.Core/ModelBinding/ModelBindingHelper.cs @@ -632,12 +632,13 @@ namespace Microsoft.AspNetCore.Mvc.ModelBinding /// /// Clears entries for . /// - /// The . + /// The of the model. + /// The associated with the model. + /// The . /// The entry to clear. - /// The . public static void ClearValidationStateForModel( Type modelType, - ModelStateDictionary modelstate, + ModelStateDictionary modelState, IModelMetadataProvider metadataProvider, string modelKey) { @@ -646,9 +647,9 @@ namespace Microsoft.AspNetCore.Mvc.ModelBinding throw new ArgumentNullException(nameof(modelType)); } - if (modelstate == null) + if (modelState == null) { - throw new ArgumentNullException(nameof(modelstate)); + throw new ArgumentNullException(nameof(modelState)); } if (metadataProvider == null) @@ -656,18 +657,18 @@ namespace Microsoft.AspNetCore.Mvc.ModelBinding throw new ArgumentNullException(nameof(metadataProvider)); } - ClearValidationStateForModel(metadataProvider.GetMetadataForType(modelType), modelstate, modelKey); + ClearValidationStateForModel(metadataProvider.GetMetadataForType(modelType), modelState, modelKey); } /// /// Clears entries for . /// /// The . + /// The associated with the model. /// The entry to clear. - /// The . public static void ClearValidationStateForModel( ModelMetadata modelMetadata, - ModelStateDictionary modelstate, + ModelStateDictionary modelState, string modelKey) { if (modelMetadata == null) @@ -675,9 +676,9 @@ namespace Microsoft.AspNetCore.Mvc.ModelBinding throw new ArgumentNullException(nameof(modelMetadata)); } - if (modelstate == null) + if (modelState == null) { - throw new ArgumentNullException(nameof(modelstate)); + throw new ArgumentNullException(nameof(modelState)); } if (string.IsNullOrEmpty(modelKey)) @@ -692,7 +693,7 @@ namespace Microsoft.AspNetCore.Mvc.ModelBinding // // In the unlikely case that multiple top-level collections where bound to the empty prefix, // you're just out of luck. - foreach (var kvp in modelstate) + foreach (var kvp in modelState) { if (kvp.Key.Length > 0 && kvp.Key[0] == '[') { @@ -706,14 +707,14 @@ namespace Microsoft.AspNetCore.Mvc.ModelBinding { foreach (var property in modelMetadata.Properties) { - modelstate.ClearValidationState(property.BinderModelName ?? property.PropertyName); + modelState.ClearValidationState(property.BinderModelName ?? property.PropertyName); } } else { // Simple types bind to a single entry. So clear the entry with the empty-key, in the // unlikely event that it has errors. - var entry = modelstate[string.Empty]; + var entry = modelState[string.Empty]; if (entry != null) { entry.Errors.Clear(); @@ -726,7 +727,7 @@ namespace Microsoft.AspNetCore.Mvc.ModelBinding // If model key is non-empty, we just want to clear all keys with that prefix. We expect // model binding to have only used this key (and suffixes) for all entries related to // this model. - modelstate.ClearValidationState(modelKey); + modelState.ClearValidationState(modelKey); } } @@ -849,10 +850,10 @@ namespace Microsoft.AspNetCore.Mvc.ModelBinding } /// - /// Converts the provided to a value of + /// Converts the provided to a value of /// using the . /// - /// The value to convert."/> + /// The value to convert. /// The for conversion. /// /// The converted value or null if the value could not be converted. diff --git a/src/Microsoft.AspNetCore.Mvc.Core/ModelBinding/Validation/IObjectModelValidator.cs b/src/Microsoft.AspNetCore.Mvc.Core/ModelBinding/Validation/IObjectModelValidator.cs index 2ed2d9f8f8..d0ffa99264 100644 --- a/src/Microsoft.AspNetCore.Mvc.Core/ModelBinding/Validation/IObjectModelValidator.cs +++ b/src/Microsoft.AspNetCore.Mvc.Core/ModelBinding/Validation/IObjectModelValidator.cs @@ -15,7 +15,7 @@ namespace Microsoft.AspNetCore.Mvc.ModelBinding.Validation /// The . /// The . May be null. /// - /// The model prefix. Used to map the model object to entries in . + /// The model prefix. Used to map the model object to entries in . /// /// The model object. void Validate( diff --git a/src/Microsoft.AspNetCore.Mvc.Core/ModelBinding/Validation/ValidationVisitor.cs b/src/Microsoft.AspNetCore.Mvc.Core/ModelBinding/Validation/ValidationVisitor.cs index 3e66d91022..4e6ba85f1d 100644 --- a/src/Microsoft.AspNetCore.Mvc.Core/ModelBinding/Validation/ValidationVisitor.cs +++ b/src/Microsoft.AspNetCore.Mvc.Core/ModelBinding/Validation/ValidationVisitor.cs @@ -34,6 +34,8 @@ namespace Microsoft.AspNetCore.Mvc.ModelBinding.Validation /// /// The associated with the current request. /// The . + /// The that provides a list of s. + /// The provider used for reading metadata for the model type. /// The . public ValidationVisitor( ActionContext actionContext, diff --git a/src/Microsoft.AspNetCore.Mvc.Core/UrlHelperExtensions.cs b/src/Microsoft.AspNetCore.Mvc.Core/UrlHelperExtensions.cs index 5171f7ec4f..ff7bab72c4 100644 --- a/src/Microsoft.AspNetCore.Mvc.Core/UrlHelperExtensions.cs +++ b/src/Microsoft.AspNetCore.Mvc.Core/UrlHelperExtensions.cs @@ -31,6 +31,7 @@ namespace Microsoft.AspNetCore.Mvc /// /// Generates a fully qualified or absolute URL for an action method by using the specified action name. /// + /// The . /// The name of the action method. /// The fully qualified or absolute URL to an action method. public static string Action(this IUrlHelper helper, string action) @@ -47,6 +48,7 @@ namespace Microsoft.AspNetCore.Mvc /// Generates a fully qualified or absolute URL for an action method by using the specified action name, /// and route values. /// + /// The . /// The name of the action method. /// An object that contains route values. /// The fully qualified or absolute URL to an action method. @@ -64,6 +66,7 @@ namespace Microsoft.AspNetCore.Mvc /// Generates a fully qualified or absolute URL for an action method by using the specified action name, /// and controller name. /// + /// The . /// The name of the action method. /// The name of the controller. /// The fully qualified or absolute URL to an action method. @@ -81,6 +84,7 @@ namespace Microsoft.AspNetCore.Mvc /// Generates a fully qualified or absolute URL for an action method by using the specified action name, /// controller name, and route values. /// + /// The . /// The name of the action method. /// The name of the controller. /// An object that contains route values. @@ -99,6 +103,7 @@ namespace Microsoft.AspNetCore.Mvc /// Generates a fully qualified or absolute URL for an action method by using the specified action name, /// controller name, route values, and protocol to use. /// + /// The . /// The name of the action method. /// The name of the controller. /// An object that contains route values. @@ -123,6 +128,7 @@ namespace Microsoft.AspNetCore.Mvc /// Generates a fully qualified or absolute URL for an action method by using the specified action name, /// controller name, route values, protocol to use, and host name. /// + /// The . /// The name of the action method. /// The name of the controller. /// An object that contains route values. @@ -149,6 +155,7 @@ namespace Microsoft.AspNetCore.Mvc /// Generates a fully qualified or absolute URL for an action method by using the specified action name, /// controller name, route values, protocol to use, host name and fragment. /// + /// The . /// The name of the action method. /// The name of the controller. /// An object that contains route values. @@ -184,6 +191,7 @@ namespace Microsoft.AspNetCore.Mvc /// /// Generates a fully qualified or absolute URL for the specified route values. /// + /// The . /// An object that contains route values. /// The fully qualified or absolute URL. public static string RouteUrl(this IUrlHelper helper, object values) @@ -199,6 +207,7 @@ namespace Microsoft.AspNetCore.Mvc /// /// Generates a fully qualified or absolute URL for the specified route name. /// + /// The . /// The name of the route that is used to generate URL. /// The fully qualified or absolute URL. public static string RouteUrl(this IUrlHelper helper, string routeName) @@ -215,6 +224,7 @@ namespace Microsoft.AspNetCore.Mvc /// Generates a fully qualified or absolute URL for the specified route values by /// using the specified route name. /// + /// The . /// The name of the route that is used to generate URL. /// An object that contains route values. /// The fully qualified or absolute URL. @@ -232,6 +242,7 @@ namespace Microsoft.AspNetCore.Mvc /// Generates a fully qualified or absolute URL for the specified route values by /// using the specified route name, and protocol to use. /// + /// The . /// The name of the route that is used to generate URL. /// An object that contains route values. /// The protocol for the URL, such as "http" or "https". @@ -254,6 +265,7 @@ namespace Microsoft.AspNetCore.Mvc /// Generates a fully qualified or absolute URL for the specified route values by /// using the specified route name, protocol to use, and host name. /// + /// The . /// The name of the route that is used to generate URL. /// An object that contains route values. /// The protocol for the URL, such as "http" or "https". @@ -278,6 +290,7 @@ namespace Microsoft.AspNetCore.Mvc /// Generates a fully qualified or absolute URL for the specified route values by /// using the specified route name, protocol to use, host name and fragment. /// + /// The . /// The name of the route that is used to generate URL. /// An object that contains route values. /// The protocol for the URL, such as "http" or "https". diff --git a/src/Microsoft.AspNetCore.Mvc.Core/project.json b/src/Microsoft.AspNetCore.Mvc.Core/project.json index 5db836e30e..fd09312e8c 100644 --- a/src/Microsoft.AspNetCore.Mvc.Core/project.json +++ b/src/Microsoft.AspNetCore.Mvc.Core/project.json @@ -7,7 +7,9 @@ }, "compilationOptions": { "warningsAsErrors": true, - "keyFile": "../../tools/Key.snk" + "keyFile": "../../tools/Key.snk", + "nowarn": [ "CS1591" ], + "xmlDoc": true }, "dependencies": { "Microsoft.AspNetCore.Authorization": "1.0.0-*", diff --git a/src/Microsoft.AspNetCore.Mvc.Cors/project.json b/src/Microsoft.AspNetCore.Mvc.Cors/project.json index 51c371462e..ab48c315b4 100644 --- a/src/Microsoft.AspNetCore.Mvc.Cors/project.json +++ b/src/Microsoft.AspNetCore.Mvc.Cors/project.json @@ -7,7 +7,9 @@ }, "compilationOptions": { "warningsAsErrors": true, - "keyFile": "../../tools/Key.snk" + "keyFile": "../../tools/Key.snk", + "nowarn": [ "CS1591" ], + "xmlDoc": true }, "dependencies": { "Microsoft.AspNetCore.Cors": "1.0.0-*", diff --git a/src/Microsoft.AspNetCore.Mvc.DataAnnotations/Internal/DataAnnotationsClientModelValidatorProvider.cs b/src/Microsoft.AspNetCore.Mvc.DataAnnotations/Internal/DataAnnotationsClientModelValidatorProvider.cs index f68f8a120f..5c1dc946f4 100644 --- a/src/Microsoft.AspNetCore.Mvc.DataAnnotations/Internal/DataAnnotationsClientModelValidatorProvider.cs +++ b/src/Microsoft.AspNetCore.Mvc.DataAnnotations/Internal/DataAnnotationsClientModelValidatorProvider.cs @@ -15,7 +15,7 @@ namespace Microsoft.AspNetCore.Mvc.DataAnnotations.Internal /// for attributes which derive from . It also provides /// a validator for types which implement . /// The logic to support - /// is implemented in . + /// is implemented in . /// public class DataAnnotationsClientModelValidatorProvider : IClientModelValidatorProvider { @@ -26,6 +26,8 @@ namespace Microsoft.AspNetCore.Mvc.DataAnnotations.Internal /// /// Create a new instance of . /// + /// The + /// that supplies s. /// The . /// The . public DataAnnotationsClientModelValidatorProvider( diff --git a/src/Microsoft.AspNetCore.Mvc.DataAnnotations/Internal/DataAnnotationsModelValidatorProvider.cs b/src/Microsoft.AspNetCore.Mvc.DataAnnotations/Internal/DataAnnotationsModelValidatorProvider.cs index 2444b81938..c745bbf100 100644 --- a/src/Microsoft.AspNetCore.Mvc.DataAnnotations/Internal/DataAnnotationsModelValidatorProvider.cs +++ b/src/Microsoft.AspNetCore.Mvc.DataAnnotations/Internal/DataAnnotationsModelValidatorProvider.cs @@ -26,6 +26,8 @@ namespace Microsoft.AspNetCore.Mvc.DataAnnotations.Internal /// /// Create a new instance of . /// + /// The + /// that supplies s. /// The . /// The . /// and diff --git a/src/Microsoft.AspNetCore.Mvc.DataAnnotations/project.json b/src/Microsoft.AspNetCore.Mvc.DataAnnotations/project.json index 19f7efd6ca..73e9e3b3df 100644 --- a/src/Microsoft.AspNetCore.Mvc.DataAnnotations/project.json +++ b/src/Microsoft.AspNetCore.Mvc.DataAnnotations/project.json @@ -7,7 +7,9 @@ }, "compilationOptions": { "warningsAsErrors": true, - "keyFile": "../../tools/Key.snk" + "keyFile": "../../tools/Key.snk", + "nowarn": [ "CS1591" ], + "xmlDoc": true }, "dependencies": { "Microsoft.AspNetCore.Mvc.Core": "1.0.0-*", diff --git a/src/Microsoft.AspNetCore.Mvc.Formatters.Json/Internal/JsonResultExecutor.cs b/src/Microsoft.AspNetCore.Mvc.Formatters.Json/Internal/JsonResultExecutor.cs index 5a00321635..79c9ee851d 100644 --- a/src/Microsoft.AspNetCore.Mvc.Formatters.Json/Internal/JsonResultExecutor.cs +++ b/src/Microsoft.AspNetCore.Mvc.Formatters.Json/Internal/JsonResultExecutor.cs @@ -31,6 +31,7 @@ namespace Microsoft.AspNetCore.Mvc.Formatters.Json.Internal /// The . /// The . /// The . + /// The for creating buffers. public JsonResultExecutor( IHttpResponseStreamWriterFactory writerFactory, ILogger logger, diff --git a/src/Microsoft.AspNetCore.Mvc.Formatters.Json/JsonInputFormatter.cs b/src/Microsoft.AspNetCore.Mvc.Formatters.Json/JsonInputFormatter.cs index 45cb73608a..41415d5310 100644 --- a/src/Microsoft.AspNetCore.Mvc.Formatters.Json/JsonInputFormatter.cs +++ b/src/Microsoft.AspNetCore.Mvc.Formatters.Json/JsonInputFormatter.cs @@ -52,7 +52,7 @@ namespace Microsoft.AspNetCore.Mvc.Formatters /// /// The . /// The . - /// The . + /// The . /// The . public JsonInputFormatter( ILogger logger, diff --git a/src/Microsoft.AspNetCore.Mvc.Formatters.Json/project.json b/src/Microsoft.AspNetCore.Mvc.Formatters.Json/project.json index 712f305b71..bc3793a212 100644 --- a/src/Microsoft.AspNetCore.Mvc.Formatters.Json/project.json +++ b/src/Microsoft.AspNetCore.Mvc.Formatters.Json/project.json @@ -7,7 +7,9 @@ }, "compilationOptions": { "warningsAsErrors": true, - "keyFile": "../../tools/Key.snk" + "keyFile": "../../tools/Key.snk", + "nowarn": [ "CS1591" ], + "xmlDoc": true }, "dependencies": { "Microsoft.AspNetCore.JsonPatch": "1.0.0-*", diff --git a/src/Microsoft.AspNetCore.Mvc.Formatters.Xml/project.json b/src/Microsoft.AspNetCore.Mvc.Formatters.Xml/project.json index d266df7d19..032dad4259 100644 --- a/src/Microsoft.AspNetCore.Mvc.Formatters.Xml/project.json +++ b/src/Microsoft.AspNetCore.Mvc.Formatters.Xml/project.json @@ -7,7 +7,9 @@ }, "compilationOptions": { "warningsAsErrors": true, - "keyFile": "../../tools/Key.snk" + "keyFile": "../../tools/Key.snk", + "nowarn": [ "CS1591" ], + "xmlDoc": true }, "dependencies": { "Microsoft.AspNetCore.Mvc.Core": "1.0.0-*", diff --git a/src/Microsoft.AspNetCore.Mvc.Localization/HtmlLocalizerExtensions.cs b/src/Microsoft.AspNetCore.Mvc.Localization/HtmlLocalizerExtensions.cs index 4cb57175cc..30a463c9f6 100644 --- a/src/Microsoft.AspNetCore.Mvc.Localization/HtmlLocalizerExtensions.cs +++ b/src/Microsoft.AspNetCore.Mvc.Localization/HtmlLocalizerExtensions.cs @@ -15,7 +15,8 @@ namespace Microsoft.AspNetCore.Mvc.Localization /// /// Gets the resource for a specific name. /// - /// The key to use. + /// The . + /// The key to use. /// The resource. public static LocalizedHtmlString GetHtml(this IHtmlLocalizer htmlLocalizer, string name) { @@ -35,7 +36,8 @@ namespace Microsoft.AspNetCore.Mvc.Localization /// /// Gets the resource for a specific name. /// - /// The key to use. + /// The . + /// The key to use. /// The values to format the string with. /// The resource. public static LocalizedHtmlString GetHtml(this IHtmlLocalizer htmlLocalizer, string name, params object[] arguments) diff --git a/src/Microsoft.AspNetCore.Mvc.Localization/IHtmlLocalizer.cs b/src/Microsoft.AspNetCore.Mvc.Localization/IHtmlLocalizer.cs index 54716ed8a2..0129486bcf 100644 --- a/src/Microsoft.AspNetCore.Mvc.Localization/IHtmlLocalizer.cs +++ b/src/Microsoft.AspNetCore.Mvc.Localization/IHtmlLocalizer.cs @@ -32,7 +32,6 @@ namespace Microsoft.AspNetCore.Mvc.Localization /// /// Gets the string resource with the given name. /// - /// The . /// The name of the string resource. /// The string resource as a . LocalizedString GetString(string name); @@ -40,7 +39,6 @@ namespace Microsoft.AspNetCore.Mvc.Localization /// /// Gets the string resource with the given name and formatted with the supplied arguments. /// - /// The . /// The name of the string resource. /// The values to format the string with. /// The formatted string resource as a . diff --git a/src/Microsoft.AspNetCore.Mvc.Localization/project.json b/src/Microsoft.AspNetCore.Mvc.Localization/project.json index d6ed7266bb..cb5ed771aa 100644 --- a/src/Microsoft.AspNetCore.Mvc.Localization/project.json +++ b/src/Microsoft.AspNetCore.Mvc.Localization/project.json @@ -3,7 +3,9 @@ "version": "1.0.0-*", "compilationOptions": { "warningsAsErrors": true, - "keyFile": "../../tools/Key.snk" + "keyFile": "../../tools/Key.snk", + "nowarn": [ "CS1591" ], + "xmlDoc": true }, "dependencies": { "Microsoft.AspNetCore.Localization": "1.0.0-*", diff --git a/src/Microsoft.AspNetCore.Mvc.Razor.Host/Directives/IChunkMerger.cs b/src/Microsoft.AspNetCore.Mvc.Razor.Host/Directives/IChunkMerger.cs index eb4a7c98d1..d171efacf6 100644 --- a/src/Microsoft.AspNetCore.Mvc.Razor.Host/Directives/IChunkMerger.cs +++ b/src/Microsoft.AspNetCore.Mvc.Razor.Host/Directives/IChunkMerger.cs @@ -20,7 +20,7 @@ namespace Microsoft.AspNetCore.Mvc.Razor.Directives /// /// Merges an inherited into the . /// - /// The to merge into. + /// The to merge into. /// The s to merge. void MergeInheritedChunks(ChunkTree chunkTree, IReadOnlyList inheritedChunks); } diff --git a/src/Microsoft.AspNetCore.Mvc.Razor.Host/MvcRazorParser.cs b/src/Microsoft.AspNetCore.Mvc.Razor.Host/MvcRazorParser.cs index 3f418bde4e..086f4ba2c1 100644 --- a/src/Microsoft.AspNetCore.Mvc.Razor.Host/MvcRazorParser.cs +++ b/src/Microsoft.AspNetCore.Mvc.Razor.Host/MvcRazorParser.cs @@ -31,6 +31,7 @@ namespace Microsoft.AspNetCore.Mvc.Razor /// from parsed pages from _ViewImports files. /// The inherited by /// default by all Razor pages in the application. + /// The full name of the model expression . public MvcRazorParser( RazorParser parser, IReadOnlyList inheritedChunkTrees, diff --git a/src/Microsoft.AspNetCore.Mvc.Razor.Host/project.json b/src/Microsoft.AspNetCore.Mvc.Razor.Host/project.json index 0aed69a767..5a211fe9d1 100644 --- a/src/Microsoft.AspNetCore.Mvc.Razor.Host/project.json +++ b/src/Microsoft.AspNetCore.Mvc.Razor.Host/project.json @@ -7,7 +7,9 @@ }, "compilationOptions": { "warningsAsErrors": true, - "keyFile": "../../tools/Key.snk" + "keyFile": "../../tools/Key.snk", + "nowarn": [ "CS1591" ], + "xmlDoc": true }, "dependencies": { "Microsoft.AspNetCore.Razor.Runtime": "1.0.0-*", diff --git a/src/Microsoft.AspNetCore.Mvc.Razor/Internal/RazorCompilationService.cs b/src/Microsoft.AspNetCore.Mvc.Razor/Internal/RazorCompilationService.cs index b707707c55..f30af08729 100644 --- a/src/Microsoft.AspNetCore.Mvc.Razor/Internal/RazorCompilationService.cs +++ b/src/Microsoft.AspNetCore.Mvc.Razor/Internal/RazorCompilationService.cs @@ -32,6 +32,7 @@ namespace Microsoft.AspNetCore.Mvc.Razor.Internal /// The to compile generated code. /// The to generate code from Razor files. /// The . + /// The . public RazorCompilationService( ICompilationService compilationService, IMvcRazorHost razorHost, diff --git a/src/Microsoft.AspNetCore.Mvc.Razor/RazorPage.cs b/src/Microsoft.AspNetCore.Mvc.Razor/RazorPage.cs index 4def724109..c6ca34b420 100644 --- a/src/Microsoft.AspNetCore.Mvc.Razor/RazorPage.cs +++ b/src/Microsoft.AspNetCore.Mvc.Razor/RazorPage.cs @@ -761,6 +761,8 @@ namespace Microsoft.AspNetCore.Mvc.Razor /// In layout pages, asynchronously renders the content of the section named . /// /// The section to render. + /// Indicates the section must be registered + /// (using @section) in the page. /// A that on completion returns that /// allows the call to succeed. /// The method writes to the and the value returned is a token @@ -814,7 +816,7 @@ namespace Microsoft.AspNetCore.Mvc.Razor } /// - /// Invokes on and + /// Invokes on and /// on the response stream, writing out any buffered content to the . /// /// A that represents the asynchronous flush operation and on diff --git a/src/Microsoft.AspNetCore.Mvc.Razor/TagHelpers/UrlResolutionTagHelper.cs b/src/Microsoft.AspNetCore.Mvc.Razor/TagHelpers/UrlResolutionTagHelper.cs index c35d09a47a..75c0f7dbc4 100644 --- a/src/Microsoft.AspNetCore.Mvc.Razor/TagHelpers/UrlResolutionTagHelper.cs +++ b/src/Microsoft.AspNetCore.Mvc.Razor/TagHelpers/UrlResolutionTagHelper.cs @@ -87,7 +87,7 @@ namespace Microsoft.AspNetCore.Mvc.Razor.TagHelpers /// /// Creates a new . /// - /// The . + /// The . /// The . public UrlResolutionTagHelper(IUrlHelperFactory urlHelperFactory, HtmlEncoder htmlEncoder) { diff --git a/src/Microsoft.AspNetCore.Mvc.Razor/project.json b/src/Microsoft.AspNetCore.Mvc.Razor/project.json index a0b4ce0eda..75a48f0195 100644 --- a/src/Microsoft.AspNetCore.Mvc.Razor/project.json +++ b/src/Microsoft.AspNetCore.Mvc.Razor/project.json @@ -7,7 +7,9 @@ }, "compilationOptions": { "warningsAsErrors": true, - "keyFile": "../../tools/Key.snk" + "keyFile": "../../tools/Key.snk", + "nowarn": [ "CS1591" ], + "xmlDoc": true }, "dependencies": { "Microsoft.AspNetCore.Mvc.Razor.Host": "1.0.0-*", diff --git a/src/Microsoft.AspNetCore.Mvc.TagHelpers/CacheTagHelper.cs b/src/Microsoft.AspNetCore.Mvc.TagHelpers/CacheTagHelper.cs index ddc607c964..590bab435b 100644 --- a/src/Microsoft.AspNetCore.Mvc.TagHelpers/CacheTagHelper.cs +++ b/src/Microsoft.AspNetCore.Mvc.TagHelpers/CacheTagHelper.cs @@ -44,6 +44,7 @@ namespace Microsoft.AspNetCore.Mvc.TagHelpers /// Creates a new . /// /// The . + /// The to use. public CacheTagHelper(IMemoryCache memoryCache, HtmlEncoder htmlEncoder) { MemoryCache = memoryCache; diff --git a/src/Microsoft.AspNetCore.Mvc.TagHelpers/ImageTagHelper.cs b/src/Microsoft.AspNetCore.Mvc.TagHelpers/ImageTagHelper.cs index 498551204d..b873f8a17d 100644 --- a/src/Microsoft.AspNetCore.Mvc.TagHelpers/ImageTagHelper.cs +++ b/src/Microsoft.AspNetCore.Mvc.TagHelpers/ImageTagHelper.cs @@ -38,6 +38,7 @@ namespace Microsoft.AspNetCore.Mvc.TagHelpers /// /// The . /// The . + /// The to use. /// The . public ImageTagHelper( IHostingEnvironment hostingEnvironment, diff --git a/src/Microsoft.AspNetCore.Mvc.TagHelpers/project.json b/src/Microsoft.AspNetCore.Mvc.TagHelpers/project.json index ad259fff81..d205ae11b0 100644 --- a/src/Microsoft.AspNetCore.Mvc.TagHelpers/project.json +++ b/src/Microsoft.AspNetCore.Mvc.TagHelpers/project.json @@ -7,7 +7,9 @@ }, "compilationOptions": { "warningsAsErrors": true, - "keyFile": "../../tools/Key.snk" + "keyFile": "../../tools/Key.snk", + "nowarn": [ "CS1591" ], + "xmlDoc": true }, "dependencies": { "Microsoft.AspNetCore.Mvc.Razor": "1.0.0-*", diff --git a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Controller.cs b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Controller.cs index b839094e61..907fa4b4aa 100644 --- a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Controller.cs +++ b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Controller.cs @@ -244,7 +244,7 @@ namespace Microsoft.AspNetCore.Mvc /// . /// /// An with properties representing arguments to be passed to the invoked view component - /// method. Alternatively, an instance + /// method. Alternatively, an instance /// containing the invocation arguments. /// /// The created object for the response. @@ -267,7 +267,7 @@ namespace Microsoft.AspNetCore.Mvc /// The view component . /// /// An with properties representing arguments to be passed to the invoked view component - /// method. Alternatively, an instance + /// method. Alternatively, an instance /// containing the invocation arguments. /// /// The created object for the response. @@ -383,7 +383,7 @@ namespace Microsoft.AspNetCore.Mvc /// /// Releases all resources currently used by this instance. /// - /// true if this method is being invoked by the method, + /// true if this method is being invoked by the method, /// otherwise false. protected virtual void Dispose(bool disposing) { diff --git a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/IViewComponentHelper.cs b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/IViewComponentHelper.cs index 6c5bcb91da..60c2552ebc 100644 --- a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/IViewComponentHelper.cs +++ b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/IViewComponentHelper.cs @@ -18,7 +18,7 @@ namespace Microsoft.AspNetCore.Mvc /// The name of the view component. /// /// An with properties representing arguments to be passed to the invoked view component - /// method. Alternatively, an instance + /// method. Alternatively, an instance /// containing the invocation arguments. /// /// A that on completion returns the rendered . @@ -31,7 +31,7 @@ namespace Microsoft.AspNetCore.Mvc /// The view component . /// /// An with properties representing arguments to be passed to the invoked view component - /// method. Alternatively, an instance + /// method. Alternatively, an instance /// containing the invocation arguments. /// /// A that on completion returns the rendered . diff --git a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Internal/IViewBufferScope.cs b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Internal/IViewBufferScope.cs index 6d90277737..2250771fb4 100644 --- a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Internal/IViewBufferScope.cs +++ b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Internal/IViewBufferScope.cs @@ -6,20 +6,20 @@ using System.IO; namespace Microsoft.AspNetCore.Mvc.ViewFeatures.Internal { /// - /// Creates and manages the lifetime of instances. + /// Creates and manages the lifetime of instances. /// public interface IViewBufferScope { /// - /// Gets a . + /// Gets a . /// - /// The . + /// The . ViewBufferValue[] GetSegment(); /// - /// Returns a that can be reused. + /// Returns a that can be reused. /// - /// The . + /// The . void ReturnSegment(ViewBufferValue[] segment); /// diff --git a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Internal/MemoryPoolViewBufferScope.cs b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Internal/MemoryPoolViewBufferScope.cs index 362f5ab72e..d0613afe91 100644 --- a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Internal/MemoryPoolViewBufferScope.cs +++ b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Internal/MemoryPoolViewBufferScope.cs @@ -27,7 +27,7 @@ namespace Microsoft.AspNetCore.Mvc.ViewFeatures.Internal /// The for creating instances. /// /// - /// The for creating instances. + /// The for creating instances. /// public MemoryPoolViewBufferScope(ArrayPool viewBufferPool, ArrayPool charPool) { diff --git a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Internal/ViewBufferValue.cs b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Internal/ViewBufferValue.cs index 12b32e8caf..89c9581848 100644 --- a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Internal/ViewBufferValue.cs +++ b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Internal/ViewBufferValue.cs @@ -26,7 +26,7 @@ namespace Microsoft.AspNetCore.Mvc.ViewFeatures.Internal /// /// Initializes a new instance of with a value. /// - /// The . + /// The . public ViewBufferValue(IHtmlContent content) { Value = content; diff --git a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ModelStateDictionaryExtensions.cs b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ModelStateDictionaryExtensions.cs index 3cafb812c3..9c78d12614 100644 --- a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ModelStateDictionaryExtensions.cs +++ b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ModelStateDictionaryExtensions.cs @@ -52,6 +52,7 @@ namespace Microsoft.AspNetCore.Mvc.ModelBinding /// The instance this method extends. /// An expression to be evaluated against an item in the current model. /// The to add. + /// The associated with the model. public static void AddModelError( this ModelStateDictionary modelState, Expression> expression, diff --git a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperDisplayExtensions.cs b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperDisplayExtensions.cs index 58552939d4..c48dcf03fa 100644 --- a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperDisplayExtensions.cs +++ b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperDisplayExtensions.cs @@ -57,7 +57,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// that contains the properties to display. /// /// - /// An anonymous or + /// An anonymous or /// that can contain additional view data that will be merged into the /// instance created for the template. /// @@ -144,7 +144,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// The name of the template used to create the HTML markup. /// - /// An anonymous or + /// An anonymous or /// that can contain additional view data that will be merged into the /// instance created for the template. /// @@ -273,7 +273,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// The instance this method extends. /// An expression to be evaluated against the current model. /// - /// An anonymous or + /// An anonymous or /// that can contain additional view data that will be merged into the /// instance created for the template. /// @@ -364,7 +364,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// An expression to be evaluated against the current model. /// The name of the template used to create the HTML markup. /// - /// An anonymous or + /// An anonymous or /// that can contain additional view data that will be merged into the /// instance created for the template. /// @@ -488,7 +488,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// The instance this method extends. /// - /// An anonymous or + /// An anonymous or /// that can contain additional view data that will be merged into the /// instance created for the template. /// @@ -556,7 +556,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// The instance this method extends. /// The name of the template used to create the HTML markup. /// - /// An anonymous or + /// An anonymous or /// that can contain additional view data that will be merged into the /// instance created for the template. /// @@ -639,7 +639,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// properties that have the same name. /// /// - /// An anonymous or + /// An anonymous or /// that can contain additional view data that will be merged into the /// instance created for the template. /// diff --git a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperDisplayNameExtensions.cs b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperDisplayNameExtensions.cs index 536f071f7c..7280159990 100644 --- a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperDisplayNameExtensions.cs +++ b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperDisplayNameExtensions.cs @@ -32,7 +32,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// if the current model represents a collection. /// /// - /// The instance this method extends. + /// The of instance this method extends. /// /// An expression to be evaluated against an item in the current model. /// The type of items in the model collection. diff --git a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperEditorExtensions.cs b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperEditorExtensions.cs index bc21542e6c..645d75789b 100644 --- a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperEditorExtensions.cs +++ b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperEditorExtensions.cs @@ -57,7 +57,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// that contains the properties to edit. /// /// - /// An anonymous or + /// An anonymous or /// that can contain additional view data that will be merged into the /// instance created for the template. /// @@ -141,7 +141,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// The name of the template used to create the HTML markup. /// - /// An anonymous or + /// An anonymous or /// that can contain additional view data that will be merged into the /// instance created for the template. /// @@ -266,7 +266,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// The instance this method extends. /// An expression to be evaluated against the current model. /// - /// An anonymous or + /// An anonymous or /// that can contain additional view data that will be merged into the /// instance created for the template. /// @@ -353,7 +353,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// An expression to be evaluated against the current model. /// The name of the template that is used to create the HTML markup. /// - /// An anonymous or + /// An anonymous or /// that can contain additional view data that will be merged into the /// instance created for the template. /// @@ -446,7 +446,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// /// For example the default editor template includes <label> and <input> - /// elements for each property in the result. + /// elements for each property in the current model. /// /// /// Custom templates are found under a EditorTemplates folder. The folder name is case-sensitive on @@ -473,7 +473,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// The instance this method extends. /// - /// An anonymous or + /// An anonymous or /// that can contain additional view data that will be merged into the /// instance created for the template. /// @@ -541,7 +541,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// The instance this method extends. /// The name of the template used to create the HTML markup. /// - /// An anonymous or + /// An anonymous or /// that can contain additional view data that will be merged into the /// instance created for the template. /// @@ -624,7 +624,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// properties that have the same name. /// /// - /// An anonymous or + /// An anonymous or /// that can contain additional view data that will be merged into the /// instance created for the template. /// diff --git a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperFormExtensions.cs b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperFormExtensions.cs index 17e97801c7..3a354679c4 100644 --- a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperFormExtensions.cs +++ b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperFormExtensions.cs @@ -46,8 +46,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// If true, <form> elements will include an antiforgery token. /// If false, suppresses the generation an <input> of type "hidden" with an antiforgery token. - /// If null, <form> elements will include an antiforgery token only if - /// is not . + /// If null, <form> elements will include an antiforgery token. /// /// /// An instance which renders the </form> end tag when disposed. @@ -108,7 +107,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// The HTTP method for processing the form, either GET or POST. /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML + /// instance containing the HTML /// attributes. /// /// @@ -150,7 +149,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML + /// instance containing the HTML /// attributes. /// /// @@ -188,7 +187,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// An that contains the parameters for a route. The parameters are retrieved through /// reflection by examining the properties of the . This is typically /// created using initializer syntax. Alternatively, an - /// instance containing the route + /// instance containing the route /// parameters. /// /// @@ -256,7 +255,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// An that contains the parameters for a route. The parameters are retrieved through /// reflection by examining the properties of the . This is typically /// created using initializer syntax. Alternatively, an - /// instance containing the route + /// instance containing the route /// parameters. /// /// @@ -330,7 +329,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// An that contains the parameters for a route. The parameters are retrieved through /// reflection by examining the properties of the . This is typically /// created using initializer syntax. Alternatively, an - /// instance containing the route + /// instance containing the route /// parameters. /// /// The HTTP method for processing the form, either GET or POST. @@ -371,7 +370,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// The HTTP method for processing the form, either GET or POST. /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML + /// instance containing the HTML /// attributes. /// /// @@ -410,7 +409,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// An that contains the parameters for a route. The parameters are retrieved through /// reflection by examining the properties of the . This is typically /// created using initializer syntax. Alternatively, an - /// instance containing the route + /// instance containing the route /// parameters. /// /// @@ -443,14 +442,13 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// An that contains the parameters for a route. The parameters are retrieved through /// reflection by examining the properties of the . This is typically /// created using initializer syntax. Alternatively, an - /// instance containing the route + /// instance containing the route /// parameters. /// /// /// If true, <form> elements will include an antiforgery token. /// If false, suppresses the generation an <input> of type "hidden" with an antiforgery token. - /// If null, <form> elements will include an antiforgery token only if - /// is not . + /// If null, <form> elements will include an antiforgery token. /// /// /// An instance which renders the </form> end tag when disposed. @@ -509,8 +507,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// If true, <form> elements will include an antiforgery token. /// If false, suppresses the generation an <input> of type "hidden" with an antiforgery token. - /// If null, <form> elements will include an antiforgery token only if - /// is not . + /// If null, <form> elements will include an antiforgery token. /// /// /// An instance which renders the </form> end tag when disposed. @@ -543,7 +540,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// An that contains the parameters for a route. The parameters are retrieved through /// reflection by examining the properties of the . This is typically /// created using initializer syntax. Alternatively, an - /// instance containing the route + /// instance containing the route /// parameters. /// /// @@ -611,7 +608,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// An that contains the parameters for a route. The parameters are retrieved through /// reflection by examining the properties of the . This is typically /// created using initializer syntax. Alternatively, an - /// instance containing the route + /// instance containing the route /// parameters. /// /// The HTTP method for processing the form, either GET or POST. @@ -649,7 +646,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// The HTTP method for processing the form, either GET or POST. /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML + /// instance containing the HTML /// attributes. /// /// diff --git a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperInputExtensions.cs b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperInputExtensions.cs index 09ce8c314e..980f69ca2c 100644 --- a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperInputExtensions.cs +++ b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperInputExtensions.cs @@ -117,7 +117,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// Expression name, relative to the current model. /// /// An that contains the HTML attributes for the checkbox element. Alternatively, an - /// instance containing the HTML + /// instance containing the HTML /// attributes. /// /// A new containing the <input> elements. @@ -469,8 +469,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// In all but the default case, includes a "checked" attribute with /// value "checked" if the values is equal to a converted for - /// or is true (for that case); does not include - /// the attribute otherwise. + /// ; does not include the attribute otherwise. /// /// public static IHtmlContent RadioButton( @@ -497,7 +496,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML + /// instance containing the HTML /// attributes. /// /// A new containing the <input> element. @@ -535,8 +534,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// In all but the and default cases, includes a "checked" attribute with /// value "checked" if the values is equal to a converted for - /// or is true (for that case); does not include - /// the attribute otherwise. + /// ; does not include the attribute otherwise. /// /// public static IHtmlContent RadioButton( @@ -828,7 +826,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// If non-null, value to include in the element. /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML + /// instance containing the HTML /// attributes. /// /// A new containing the <input> element. @@ -974,7 +972,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// An expression to be evaluated against the current model. /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML + /// instance containing the HTML /// attributes. /// /// The type of the model. @@ -1067,7 +1065,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// Expression name, relative to the current model. /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML + /// instance containing the HTML /// attributes. /// /// A new containing the <textarea> element. @@ -1163,7 +1161,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// If non-null, value to include in the element. /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML + /// instance containing the HTML /// attributes. /// /// A new containing the <textarea> element. @@ -1257,7 +1255,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// An expression to be evaluated against the current model. /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML + /// instance containing the HTML /// attributes. /// /// The type of the model. diff --git a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperLabelExtensions.cs b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperLabelExtensions.cs index cffda91e8e..f28b30ef3f 100644 --- a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperLabelExtensions.cs +++ b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperLabelExtensions.cs @@ -104,7 +104,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// An expression to be evaluated against the current model. /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML + /// instance containing the HTML /// attributes. /// /// The type of the model. @@ -165,7 +165,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// The instance this method extends. /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML + /// instance containing the HTML /// attributes. /// /// A new containing the <label> element. @@ -186,7 +186,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// The inner text of the element. /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML + /// instance containing the HTML /// attributes. /// /// A new containing the <label> element. diff --git a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperLinkExtensions.cs b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperLinkExtensions.cs index 506745dd07..aab8bc53fa 100644 --- a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperLinkExtensions.cs +++ b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperLinkExtensions.cs @@ -54,7 +54,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// An that contains the parameters for a route. The parameters are retrieved through /// reflection by examining the properties of the . This is typically /// created using initializer syntax. Alternatively, an - /// instance containing the route + /// instance containing the route /// parameters. /// /// A new containing the anchor element. @@ -95,12 +95,12 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// An that contains the parameters for a route. The parameters are retrieved through /// reflection by examining the properties of the . This is typically /// created using initializer syntax. Alternatively, an - /// instance containing the route + /// instance containing the route /// parameters. /// /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML + /// instance containing the HTML /// attributes. /// /// A new containing the anchor element. @@ -178,7 +178,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// An that contains the parameters for a route. The parameters are retrieved through /// reflection by examining the properties of the . This is typically /// created using initializer syntax. Alternatively, an - /// instance containing the route + /// instance containing the route /// parameters. /// /// A new containing the anchor element. @@ -221,12 +221,12 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// An that contains the parameters for a route. The parameters are retrieved through /// reflection by examining the properties of the . This is typically /// created using initializer syntax. Alternatively, an - /// instance containing the route + /// instance containing the route /// parameters. /// /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML + /// instance containing the HTML /// attributes. /// /// A new containing the anchor element. @@ -268,7 +268,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// An that contains the parameters for a route. The parameters are retrieved through /// reflection by examining the properties of the . This is typically /// created using initializer syntax. Alternatively, an - /// instance containing the route + /// instance containing the route /// parameters. /// /// A new containing the anchor element. @@ -339,7 +339,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// An that contains the parameters for a route. The parameters are retrieved through /// reflection by examining the properties of the . This is typically /// created using initializer syntax. Alternatively, an - /// instance containing the route + /// instance containing the route /// parameters. /// /// A new containing the anchor element. @@ -378,12 +378,12 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// An that contains the parameters for a route. The parameters are retrieved through /// reflection by examining the properties of the . This is typically /// created using initializer syntax. Alternatively, an - /// instance containing the route + /// instance containing the route /// parameters. /// /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML + /// instance containing the HTML /// attributes. /// /// A new containing the anchor element. @@ -423,12 +423,12 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// An that contains the parameters for a route. The parameters are retrieved through /// reflection by examining the properties of the . This is typically /// created using initializer syntax. Alternatively, an - /// instance containing the route + /// instance containing the route /// parameters. /// /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML + /// instance containing the HTML /// attributes. /// /// A new containing the anchor element. diff --git a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperSelectExtensions.cs b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperSelectExtensions.cs index 4233634883..c6f42f787e 100644 --- a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperSelectExtensions.cs +++ b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperSelectExtensions.cs @@ -107,7 +107,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// /// An that contains the HTML attributes for the <select> element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// A new containing the <select> element. /// @@ -210,7 +210,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// /// An that contains the HTML attributes for the <select> element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// The type of the model. /// The type of the result. diff --git a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperValidationExtensions.cs b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperValidationExtensions.cs index 8cfafff1a7..9b5da1e9dd 100644 --- a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperValidationExtensions.cs +++ b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/HtmlHelperValidationExtensions.cs @@ -75,7 +75,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// An that contains the HTML attributes for the /// () element. Alternatively, an - /// instance containing the HTML + /// instance containing the HTML /// attributes. /// /// @@ -146,7 +146,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// An that contains the HTML attributes for the /// () element. Alternatively, an - /// instance containing the HTML + /// instance containing the HTML /// attributes. /// /// @@ -249,7 +249,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// An that contains the HTML attributes for the /// () element. Alternatively, an - /// instance containing the HTML + /// instance containing the HTML /// attributes. /// /// The type of the model. @@ -461,7 +461,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// The message to display with the validation summary. /// /// An that contains the HTML attributes for the topmost (<div>) element. - /// Alternatively, an instance containing + /// Alternatively, an instance containing /// the HTML attributes. /// /// @@ -495,7 +495,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// The message to display with the validation summary. /// /// An that contains the HTML attributes for the topmost (<div>) element. - /// Alternatively, an instance containing + /// Alternatively, an instance containing /// the HTML attributes. /// /// @@ -572,7 +572,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// The message to display with the validation summary. /// /// An that contains the HTML attributes for the topmost (<div>) element. - /// Alternatively, an instance containing + /// Alternatively, an instance containing /// the HTML attributes. /// /// diff --git a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/IHtmlHelper.cs b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/IHtmlHelper.cs index ef8a9f24d1..1f2a88e7e8 100644 --- a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/IHtmlHelper.cs +++ b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/IHtmlHelper.cs @@ -71,11 +71,11 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// An that contains the parameters for a route. The parameters are retrieved through /// reflection by examining the properties of the . This is typically /// created using initializer syntax. Alternatively, an - /// instance containing the route parameters. + /// instance containing the route parameters. /// /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// A new containing the anchor element. IHtmlContent ActionLink( @@ -105,7 +105,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// An that contains the parameters for a route. The parameters are retrieved through /// reflection by examining the properties of the . This is typically /// created using initializer syntax. Alternatively, an - /// instance containing the route parameters. + /// instance containing the route parameters. /// /// The HTTP method for processing the form, either GET or POST. /// @@ -116,7 +116,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// /// An instance which renders the </form> end tag when disposed. @@ -141,7 +141,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// An that contains the parameters for a route. The parameters are retrieved through /// reflection by examining the properties of the . This is typically /// created using initializer syntax. Alternatively, an - /// instance containing the route parameters. + /// instance containing the route parameters. /// /// The HTTP method for processing the form, either GET or POST. /// @@ -152,7 +152,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// /// An instance which renders the </form> end tag when disposed. @@ -175,7 +175,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// If true, checkbox is initially checked. /// /// An that contains the HTML attributes for the checkbox element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// A new containing the <input> elements. /// @@ -226,7 +226,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// properties that have the same name. /// /// - /// An anonymous or that can contain additional + /// An anonymous or that can contain additional /// view data that will be merged into the instance created for the /// template. /// @@ -278,7 +278,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// /// An that contains the HTML attributes for the <select> element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// A new containing the <select> element. /// @@ -307,7 +307,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// properties that have the same name. /// /// - /// An anonymous or that can contain additional + /// An anonymous or that can contain additional /// view data that will be merged into the instance created for the /// template. /// @@ -404,7 +404,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// If non-null, value to include in the element. /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// A new containing the <input> element. /// @@ -450,7 +450,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// The inner text of the element. /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// A new containing the <label> element. IHtmlContent Label(string expression, string labelText, object htmlAttributes); @@ -466,7 +466,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// /// An that contains the HTML attributes for the <select> element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// A new containing the <select> element. /// @@ -504,7 +504,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// If non-null, value to include in the element. /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// A new containing the <input> element. /// @@ -538,7 +538,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// A new containing the <input> element. /// @@ -624,11 +624,11 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// An that contains the parameters for a route. The parameters are retrieved through /// reflection by examining the properties of the . This is typically /// created using initializer syntax. Alternatively, an - /// instance containing the route parameters. + /// instance containing the route parameters. /// /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// A new containing the anchor element. IHtmlContent RouteLink( @@ -649,7 +649,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// Number of columns in the textarea. /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// A new containing the <textarea> element. /// @@ -690,7 +690,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// A new containing the <input> element. /// @@ -740,7 +740,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// /// An that contains the HTML attributes for the element. - /// Alternatively, an instance containing the HTML attributes. + /// Alternatively, an instance containing the HTML attributes. /// /// /// The tag to wrap the in the generated HTML. Its default value is @@ -762,7 +762,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// The message to display with the validation summary. /// /// An that contains the HTML attributes for the topmost (<div>) element. - /// Alternatively, an instance containing the HTML attributes. + /// Alternatively, an instance containing the HTML attributes. /// /// /// The tag to wrap the in the generated HTML. Its default value is diff --git a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/IHtmlHelperOfT.cs b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/IHtmlHelperOfT.cs index 2dd22dade4..eb1499488e 100644 --- a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/IHtmlHelperOfT.cs +++ b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/IHtmlHelperOfT.cs @@ -27,7 +27,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// An expression to be evaluated against the current model. /// /// An that contains the HTML attributes for the checkbox element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// A new containing the <input> elements. /// @@ -68,7 +68,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// that have the same name. /// /// - /// An anonymous or that can contain additional + /// An anonymous or that can contain additional /// view data that will be merged into the instance created for the /// template. /// @@ -129,7 +129,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// /// An that contains the HTML attributes for the <select> element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// The type of the result. /// A new containing the <select> element. @@ -156,7 +156,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// that have the same name. /// /// - /// An anonymous or that can contain additional + /// An anonymous or that can contain additional /// view data that will be merged into the instance created for the /// template. /// @@ -184,7 +184,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// An expression to be evaluated against the current model. /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// The type of the result. /// A new containing the <input> element. @@ -227,7 +227,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// The inner text of the element. /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// The type of the result. /// A new containing the <label> element. @@ -247,7 +247,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// /// An that contains the HTML attributes for the <select> element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// The type of the result. /// A new containing the <select> element. @@ -275,7 +275,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// An expression to be evaluated against the current model. /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// The type of the result. /// A new containing the <input> element. @@ -306,7 +306,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// Value to include in the element. Must not be null. /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// The type of the result. /// A new containing the <input> element. @@ -354,7 +354,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// Number of columns in the textarea. /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// The type of the result. /// A new containing the <textarea> element. @@ -391,7 +391,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// The type of the result. /// A new containing the <input> element. @@ -433,7 +433,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// /// An that contains the HTML attributes for the element. - /// Alternatively, an instance containing the HTML attributes. + /// Alternatively, an instance containing the HTML attributes. /// /// /// The tag to wrap the in the generated HTML. Its default value is diff --git a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/ViewComponentHelperExtensions.cs b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/ViewComponentHelperExtensions.cs index 635d7c6a9c..d973a8a5eb 100644 --- a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/ViewComponentHelperExtensions.cs +++ b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/ViewComponentHelperExtensions.cs @@ -15,6 +15,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// Invokes a view component with the specified . /// + /// The . /// The name of the view component. /// A that on completion returns the rendered . /// @@ -31,6 +32,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// /// Invokes a view component of type . /// + /// The . /// The view component . /// A that on completion returns the rendered . /// @@ -45,7 +47,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering } /// - /// Invokes a view component of type . + /// Invokes a view component of type . /// /// The . /// Arguments to be passed to the invoked view component method. @@ -63,7 +65,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering } /// - /// Invokes a view component of type . + /// Invokes a view component of type . /// /// The . /// The of the view component. diff --git a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/ViewContext.cs b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/ViewContext.cs index 8e7c0e49f3..d0bc2b56ca 100644 --- a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/ViewContext.cs +++ b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/Rendering/ViewContext.cs @@ -37,6 +37,7 @@ namespace Microsoft.AspNetCore.Mvc.Rendering /// The . /// The . /// The to render output to. + /// The to apply to this instance. public ViewContext( ActionContext actionContext, IView view, diff --git a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ViewComponents/DefaultViewComponentInvoker.cs b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ViewComponents/DefaultViewComponentInvoker.cs index 8df665be83..bde18ca400 100644 --- a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ViewComponents/DefaultViewComponentInvoker.cs +++ b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ViewComponents/DefaultViewComponentInvoker.cs @@ -26,7 +26,6 @@ namespace Microsoft.AspNetCore.Mvc.ViewComponents /// /// Initializes a new instance of . /// - /// Caches factories for instantiating view component instances. /// The . /// The . /// The . diff --git a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ViewComponents/IViewComponentActivator.cs b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ViewComponents/IViewComponentActivator.cs index 9f42143c48..92c3b4971b 100644 --- a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ViewComponents/IViewComponentActivator.cs +++ b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ViewComponents/IViewComponentActivator.cs @@ -20,7 +20,7 @@ namespace Microsoft.AspNetCore.Mvc.ViewComponents /// Releases a ViewComponent instance. /// /// - /// The associated with the . + /// The associated with the . /// /// The to release. void Release(ViewComponentContext context, object viewComponent); diff --git a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ViewComponents/ViewComponentContext.cs b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ViewComponents/ViewComponentContext.cs index 2c79723c20..e45ba82154 100644 --- a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ViewComponents/ViewComponentContext.cs +++ b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ViewComponents/ViewComponentContext.cs @@ -34,6 +34,7 @@ namespace Microsoft.AspNetCore.Mvc.ViewComponents /// The for the view component being invoked. /// /// The view component arguments. + /// The to use. /// The . /// The for writing output. public ViewComponentContext( diff --git a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ViewFeatures/DefaultHtmlGenerator.cs b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ViewFeatures/DefaultHtmlGenerator.cs index e055e8ebbd..c104384b09 100644 --- a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ViewFeatures/DefaultHtmlGenerator.cs +++ b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ViewFeatures/DefaultHtmlGenerator.cs @@ -45,8 +45,10 @@ namespace Microsoft.AspNetCore.Mvc.ViewFeatures /// tokens. /// The accessor for . /// The . - /// The . + /// The . /// The . + /// The that provides + /// a list of s. public DefaultHtmlGenerator( IAntiforgery antiforgery, IOptions optionsAccessor, @@ -1077,7 +1079,7 @@ namespace Microsoft.AspNetCore.Mvc.ViewFeatures /// The HTTP method for processing the form, either GET or POST. /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// /// A instance for the </form> element. diff --git a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ViewFeatures/HtmlHelper.cs b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ViewFeatures/HtmlHelper.cs index 1d86236cc5..5d3dcb19e1 100644 --- a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ViewFeatures/HtmlHelper.cs +++ b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ViewFeatures/HtmlHelper.cs @@ -163,7 +163,7 @@ namespace Microsoft.AspNetCore.Mvc.ViewFeatures /// value to the dictionary. It will expose public properties from derived types as well. This is typically /// used with objects of an anonymous type. /// - /// If the is already an instance, then it + /// If the is already an instance, then it /// is returned as-is. /// /// new { data_name="value" } will translate to the entry { "data_name", "value" } @@ -181,7 +181,7 @@ namespace Microsoft.AspNetCore.Mvc.ViewFeatures /// Creates a dictionary of HTML attributes from the input object, /// translating underscores to dashes in each public instance property. /// - /// If the object is already an instance, then it is + /// If the object is already an instance, then it is /// returned as-is. /// /// new { data_name="value" } will translate to the entry { "data-name", "value" } @@ -856,7 +856,7 @@ namespace Microsoft.AspNetCore.Mvc.ViewFeatures /// An that contains the parameters for a route. The parameters are retrieved through /// reflection by examining the properties of the . This is typically /// created using initializer syntax. Alternatively, an - /// instance containing the route parameters. + /// instance containing the route parameters. /// /// The HTTP method for processing the form, either GET or POST. /// @@ -867,7 +867,7 @@ namespace Microsoft.AspNetCore.Mvc.ViewFeatures /// /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// /// An instance which renders the </form> end tag when disposed. @@ -915,7 +915,7 @@ namespace Microsoft.AspNetCore.Mvc.ViewFeatures /// An that contains the parameters for a route. The parameters are retrieved through /// reflection by examining the properties of the . This is typically /// created using initializer syntax. Alternatively, an - /// instance containing the route parameters. + /// instance containing the route parameters. /// /// The HTTP method for processing the form, either GET or POST. /// @@ -926,7 +926,7 @@ namespace Microsoft.AspNetCore.Mvc.ViewFeatures /// /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// /// An instance which renders the </form> end tag when disposed. diff --git a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ViewFeatures/IHtmlGenerator.cs b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ViewFeatures/IHtmlGenerator.cs index c129e4638a..4a46799e74 100644 --- a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ViewFeatures/IHtmlGenerator.cs +++ b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ViewFeatures/IHtmlGenerator.cs @@ -35,11 +35,11 @@ namespace Microsoft.AspNetCore.Mvc.ViewFeatures /// An that contains the parameters for a route. The parameters are retrieved through /// reflection by examining the properties of the . This is typically /// created using initializer syntax. Alternatively, an - /// instance containing the route parameters. + /// instance containing the route parameters. /// /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// /// A instance for the <a> element. @@ -74,7 +74,7 @@ namespace Microsoft.AspNetCore.Mvc.ViewFeatures /// The initial state of the checkbox element. /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// /// A instance for the <input type="checkbox".../> element. @@ -107,12 +107,12 @@ namespace Microsoft.AspNetCore.Mvc.ViewFeatures /// An that contains the parameters for a route. The parameters are retrieved through /// reflection by examining the properties of the . This is typically /// created using initializer syntax. Alternatively, an - /// instance containing the route parameters. + /// instance containing the route parameters. /// /// The HTTP method for processing the form, either GET or POST. /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// /// A instance for the </form> element. @@ -135,12 +135,12 @@ namespace Microsoft.AspNetCore.Mvc.ViewFeatures /// An that contains the parameters for a route. The parameters are retrieved through /// reflection by examining the properties of the . This is typically /// created using initializer syntax. Alternatively, an - /// instance containing the route parameters. + /// instance containing the route parameters. /// /// The HTTP method for processing the form, either GET or POST. /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// /// A instance for the </form> element. @@ -189,17 +189,17 @@ namespace Microsoft.AspNetCore.Mvc.ViewFeatures /// The text to insert inside the element. /// The name of the route to use for link generation. /// The protocol (scheme) for the generated link. - /// The hostname for the generated link. + /// The hostname for the generated link. /// The fragment for the genrated link. /// /// An that contains the parameters for a route. The parameters are retrieved through /// reflection by examining the properties of the . This is typically /// created using initializer syntax. Alternatively, an - /// instance containing the route parameters. + /// instance containing the route parameters. /// /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// /// A instance for the <a> element. @@ -235,7 +235,7 @@ namespace Microsoft.AspNetCore.Mvc.ViewFeatures /// /// /// An that contains the HTML attributes for the <select> element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// A new describing the <select> element. /// @@ -273,7 +273,7 @@ namespace Microsoft.AspNetCore.Mvc.ViewFeatures /// ViewContext.ViewData[expression]. /// /// - /// An containing values for <option> elements to select. If + /// An containing values for <option> elements to select. If /// null, selects <option> elements based on values in /// . /// @@ -283,7 +283,7 @@ namespace Microsoft.AspNetCore.Mvc.ViewFeatures /// /// /// An that contains the HTML attributes for the <select> element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// A new describing the <select> element. /// @@ -354,7 +354,7 @@ namespace Microsoft.AspNetCore.Mvc.ViewFeatures /// /// /// An that contains the HTML attributes for the element. Alternatively, an - /// instance containing the HTML attributes. + /// instance containing the HTML attributes. /// /// /// A containing a element if the @@ -394,7 +394,7 @@ namespace Microsoft.AspNetCore.Mvc.ViewFeatures /// /// /// null if no result is found. Otherwise a - /// containing current values for the given + /// containing current values for the given /// . /// /// @@ -410,7 +410,7 @@ namespace Microsoft.AspNetCore.Mvc.ViewFeatures /// /// /// - /// See for information about how the return value may be used. + /// See for information about how the return value may be used. /// ICollection GetCurrentValues( ViewContext viewContext, diff --git a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ViewFeatures/ModelExplorer.cs b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ViewFeatures/ModelExplorer.cs index 74654dc956..0130bc30a0 100644 --- a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ViewFeatures/ModelExplorer.cs +++ b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/ViewFeatures/ModelExplorer.cs @@ -55,7 +55,7 @@ namespace Microsoft.AspNetCore.Mvc.ViewFeatures /// The . /// The container . /// The . - /// A model accessor function. May be null. + /// A model accessor function.. public ModelExplorer( IModelMetadataProvider metadataProvider, ModelExplorer container, @@ -351,7 +351,7 @@ namespace Microsoft.AspNetCore.Mvc.ViewFeatures /// /// Gets a for the provided model value and model . /// - /// The model . + /// The associated with the model. /// The model value. /// A . /// @@ -379,7 +379,7 @@ namespace Microsoft.AspNetCore.Mvc.ViewFeatures /// Gets a for the provided model value and model . /// /// The model . - /// The model value. + /// A model accessor function. /// A . /// /// @@ -406,8 +406,8 @@ namespace Microsoft.AspNetCore.Mvc.ViewFeatures /// /// Gets a for the provided model value and model . /// - /// The model . - /// The model value. + /// The associated with the model. + /// A model accessor function. /// A . /// /// diff --git a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/project.json b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/project.json index 6f0a6f6885..6f76f532c6 100644 --- a/src/Microsoft.AspNetCore.Mvc.ViewFeatures/project.json +++ b/src/Microsoft.AspNetCore.Mvc.ViewFeatures/project.json @@ -7,7 +7,9 @@ }, "compilationOptions": { "warningsAsErrors": true, - "keyFile": "../../tools/Key.snk" + "keyFile": "../../tools/Key.snk", + "nowarn": [ "CS1591" ], + "xmlDoc": true }, "dependencies": { "Microsoft.AspNetCore.Antiforgery": "1.0.0-*", diff --git a/src/Microsoft.AspNetCore.Mvc.WebApiCompatShim/HttpRequestMessage/HttpRequestMessageExtensions.cs b/src/Microsoft.AspNetCore.Mvc.WebApiCompatShim/HttpRequestMessage/HttpRequestMessageExtensions.cs index f14dd06a26..6877b88f74 100644 --- a/src/Microsoft.AspNetCore.Mvc.WebApiCompatShim/HttpRequestMessage/HttpRequestMessageExtensions.cs +++ b/src/Microsoft.AspNetCore.Mvc.WebApiCompatShim/HttpRequestMessage/HttpRequestMessageExtensions.cs @@ -296,8 +296,7 @@ namespace System.Net.Http /// found, this method returns a response with status 406 NotAcceptable. /// /// - /// This method will use the provided or it will get the - /// instance associated with . + /// This method will get the instance associated with . /// /// The type of the value. /// The request. diff --git a/src/Microsoft.AspNetCore.Mvc.WebApiCompatShim/project.json b/src/Microsoft.AspNetCore.Mvc.WebApiCompatShim/project.json index c60b8d275b..976df4e161 100644 --- a/src/Microsoft.AspNetCore.Mvc.WebApiCompatShim/project.json +++ b/src/Microsoft.AspNetCore.Mvc.WebApiCompatShim/project.json @@ -7,7 +7,9 @@ }, "compilationOptions": { "warningsAsErrors": true, - "keyFile": "../../tools/Key.snk" + "keyFile": "../../tools/Key.snk", + "nowarn": [ "CS1591" ], + "xmlDoc": true }, "dependencies": { "Microsoft.AspNetCore.Mvc.Core": "1.0.0-*", diff --git a/src/Microsoft.AspNetCore.Mvc/project.json b/src/Microsoft.AspNetCore.Mvc/project.json index fb7f01786a..8a3643264f 100644 --- a/src/Microsoft.AspNetCore.Mvc/project.json +++ b/src/Microsoft.AspNetCore.Mvc/project.json @@ -7,7 +7,9 @@ }, "compilationOptions": { "warningsAsErrors": true, - "keyFile": "../../tools/Key.snk" + "keyFile": "../../tools/Key.snk", + "nowarn": [ "CS1591" ], + "xmlDoc": true }, "dependencies": { "Microsoft.AspNetCore.Mvc.ApiExplorer": "1.0.0-*",