diff --git a/src/Microsoft.AspNet.Mvc.Abstractions/ModelBinding/IModelBinder.cs b/src/Microsoft.AspNet.Mvc.Abstractions/ModelBinding/IModelBinder.cs index 18cd0b8db8..a3b7605fdf 100644 --- a/src/Microsoft.AspNet.Mvc.Abstractions/ModelBinding/IModelBinder.cs +++ b/src/Microsoft.AspNet.Mvc.Abstractions/ModelBinding/IModelBinder.cs @@ -6,22 +6,27 @@ using System.Threading.Tasks; namespace Microsoft.AspNet.Mvc.ModelBinding { /// - /// Interface for model binding. + /// Defines an interface for model binders. /// public interface IModelBinder { /// - /// Async function to bind to a particular model. + /// Attempts to bind a model. /// - /// The binding context which has the object to be bound. - /// A Task which on completion returns a which represents the result - /// of the model binding process. + /// The . + /// + /// + /// A which on completion returns a which + /// represents the result of the model binding process. + /// + /// + /// If model binding was successful, the should be a value created + /// with . If model binding failed, the + /// should be a value created with . + /// If there was no data, or this model binder cannot handle the operation, the + /// should be . + /// /// - /// - /// A null return value means that this model binder was not able to handle the request. - /// Returning null ensures that subsequent model binders are run. If a non null value indicates - /// that the model binder was able to handle the request. - /// Task BindModelAsync(ModelBindingContext bindingContext); } }