Control.FindControl Метод

Определение

Пространство имен:

System.Web.UI

Сборка:

System.Web.dll

Выполняет поиск в текущем контейнере именования указанного серверного элемента управления.

Перегрузки

FindControl(String)	Выполняет поиск серверного элемента управления с заданным параметром id в текущем контейнере именования.
FindControl(String, Int32)	Выполняет поиск в текущем контейнере именования серверного элемента управления с указанным id и целым числом, указанным в параметре pathOffset, который содействует поиску. Эту версию метода FindControl не следует переопределять.

FindControl(String)

Выполняет поиск серверного элемента управления с заданным параметром id в текущем контейнере именования.

public:
 virtual System::Web::UI::Control ^ FindControl(System::String ^ id);

public virtual System.Web.UI.Control FindControl (string id);

abstract member FindControl : string -> System.Web.UI.Control
override this.FindControl : string -> System.Web.UI.Control

Public Overridable Function FindControl (id As String) As Control

Параметры

id

String

Идентификатор искомого элемента управления.

Возвращаемое значение

Control

Указанный элемент управления или null, если указанный элемент управления не существует.

Примеры

В следующем примере определяется Button1_Click обработчик событий. При вызове этот обработчик использует FindControl метод для поиска элемента управления со свойством ID TextBox2 на содержащей странице. Если элемент управления найден, его родительский элемент определяется с помощью Parent свойства, а родительский элемент управления ID записывается на страницу. Если TextBox2 элемент управления не найден, на страницу записывается сообщение "Элемент управления не найден".

Важно!

В этом примере имеется текстовое поле, принимающее вводимые пользователем данные, что является потенциальной угрозой безопасности. По умолчанию данные, вводимые пользователем на веб-страницах ASP.NET, проверяются на наличие скриптов и HTML-элементов. Дополнительные сведения см. в разделе Общие сведения об использовании сценариев.

private void Button1_Click(object sender, EventArgs MyEventArgs)
{
      // Find control on page.
      Control myControl1 = FindControl("TextBox2");
      if(myControl1!=null)
      {
         // Get control's parent.
         Control myControl2 = myControl1.Parent;
         Response.Write("Parent of the text box is : " + myControl2.ID);
      }
      else
      {
         Response.Write("Control not found");
      }
}

Private Sub Button1_Click(sender As Object, MyEventArgs As EventArgs)
' Find control on page.
Dim myControl1 As Control = FindControl("TextBox2")
If (Not myControl1 Is Nothing)
   ' Get control's parent.
   Dim myControl2 As Control = myControl1.Parent
   Response.Write("Parent of the text box is : " & myControl2.ID)
Else
   Response.Write("Control not found.....")
End If
End Sub

Комментарии

Используется FindControl для доступа к элементу управления из функции на странице кода программной части, для доступа к элементу управления, который находится внутри другого контейнера, или в других случаях, когда целевой элемент управления недоступен непосредственно вызывающей объекту. Этот метод находит элемент управления только в том случае, если элемент управления содержится непосредственно указанным контейнером; то есть метод не выполняет поиск по иерархии элементов управления в элементах управления. Сведения о том, как найти элемент управления, если его непосредственный контейнер не известен, см. в разделе "Практическое руководство. Доступ к элементам управления сервером по идентификатору".

См. также раздел

• Практическое руководство. Доступ к элементам управления серверами по идентификатору

FindControl(String, Int32)

Выполняет поиск в текущем контейнере именования серверного элемента управления с указанным id и целым числом, указанным в параметре pathOffset, который содействует поиску. Эту версию метода FindControl не следует переопределять.

protected:
 virtual System::Web::UI::Control ^ FindControl(System::String ^ id, int pathOffset);

protected virtual System.Web.UI.Control FindControl (string id, int pathOffset);

abstract member FindControl : string * int -> System.Web.UI.Control
override this.FindControl : string * int -> System.Web.UI.Control

Protected Overridable Function FindControl (id As String, pathOffset As Integer) As Control

Параметры

id

String

Идентификатор искомого элемента управления.

pathOffset

Int32

Количество элементов управления, передаваемых вверх в иерархии элементов управления страницы, необходимое для достижения контейнера именования.

Возвращаемое значение

Control

Указанный элемент управления или null, если указанный элемент управления не существует.