Summary: Method

The following table provides wording guidelines and boilerplate text for Summary sections in method pages. For guidelines about On<Event> methods, see the Event-related section. For guidelines about documenting overloaded methods, see Overloaded member.

Item	Wording	Examples
General method	<Begin with a present-tense third-person verb.>	Application.DoEvents method summary: Processes Windows messages that are currently in the message queue.
Task-returning or async method	Asynchronously <present-tense third-person verb> <XXX>.	HttpClient.GetStringAsync method summary: Asynchronously sends a GET request to the specified Uri.
Dispose method, general overload	Releases the resources used by the current instance of the <class> class.	ComponentDesigner.Dispose method summary: Releases the resources used by the current instance of the ComponentDesigner class.
Dispose() method	Releases the resources used by the current instance of the <class> class.	Timer.Dispose method summary: Releases the resources used by the current instance of the Timer class.
Dispose(Boolean) method	Called by the Dispose() and Finalize() methods to release the managed and unmanaged resources used by the current instance of the <class> class.	DocumentDesigner.Dispose method (Boolean): Called by the Dispose() and Finalize() methods to release the managed and unmanaged resources used by the current instance of the DocumentDesigner class.
ShouldSerialize <Property> method	Indicates whether the <Property> property should be persisted.	DataGrid.ShouldSerializeBackgroundColor method summary: Indicates whether the BackgroundColor property should be persisted.
Reset<Property> method	Resets the <Property> property to its default value.	Control.ResetText method summary: Resets the Text property to its default value.
Method that always throws an exception	Throws a/an <ExceptionType> exception in all cases. Note: In the Remarks section, explain why the member is not supported.	DataGridViewSelectedRowCollection.Clear method summary: Throws a NotSupportedException exception in all cases.
Explicit interface method implementation	<Copy from the interface member if appropriate>