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 если указанный элемент управления не существует.