Ағылшын тілінде оқу

Бөлісу құралы:


Control.FindControl Метод

Определение

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

Перегрузки

FindControl(String)

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

FindControl(String, Int32)

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

FindControl(String)

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

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

Параметры

id
String

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

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

Указанный элемент управления или 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");
      }
}

Комментарии

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

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

Применяется к

.NET Framework 4.8.1 және басқа нұсқалар
Өнім Нұсқалар
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

FindControl(String, Int32)

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

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

Параметры

id
String

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

pathOffset
Int32

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

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

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

Применяется к

.NET Framework 4.8.1 және басқа нұсқалар
Өнім Нұсқалар
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1