Control.ControlCollection.Find(String, Boolean) Method

Reference

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Searches for controls by their Name property and builds an array of all the controls that match.

public:
 cli::array <System::Windows::Forms::Control ^> ^ Find(System::String ^ key, bool searchAllChildren);

public System.Windows.Forms.Control[] Find (string key, bool searchAllChildren);

member this.Find : string * bool -> System.Windows.Forms.Control[]

Public Function Find (key As String, searchAllChildren As Boolean) As Control()

Parameters

key: String

The key to locate in the Control.ControlCollection.

searchAllChildren: Boolean

true to search all child controls; otherwise, false.

Returns

Control[]

An array of type Control containing the matching controls.

Exceptions

ArgumentException

key is null or the empty string ("").

Applies to