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 метод для поиска элемента управления со свойством IDTextBox2 на содержащей странице. Если элемент управления найден, его родительский определяется с помощью 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, если указанный элемент управления не существует.