Control.FindControl Metoda

Definicja

Przestrzeń nazw:

System.Web.UI

Zestaw:

System.Web.dll

Wyszukuje bieżący kontener nazewnictwa dla określonej kontrolki serwera.

Przeciążenia

FindControl(String)	Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera przy użyciu określonego id parametru.
FindControl(String, Int32)	Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera z określoną liczbą id całkowitą określoną w parametrze pathOffset , co ułatwia wyszukiwanie. Nie należy zastąpić tej wersji FindControl metody.

FindControl(String)

Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera przy użyciu określonego id parametru.

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

Parametry

id

String

Identyfikator kontrolki, która ma zostać znaleziona.

Zwraca

Control

Określona kontrolka lub null jeśli określona kontrolka nie istnieje.

Przykłady

W poniższym przykładzie zdefiniowano procedurę obsługi zdarzeń Button1_Click . Po wywołaniu ta procedura obsługi używa FindControl metody do zlokalizowania kontrolki z właściwością ID TextBox2 na zawierającej stronie. Jeśli kontrolka zostanie znaleziona, jej element nadrzędny jest określany przy użyciu Parent właściwości, a kontrolka nadrzędna ID jest zapisywana na stronie. Jeśli TextBox2 nie zostanie znaleziony, na stronie zostanie zapisany komunikat "Nie znaleziono kontrolki".

Ważne

W tym przykładzie znajduje się pole tekstowe, które akceptuje dane wejściowe użytkownika, co jest potencjalnym zagrożeniem bezpieczeństwa. Domyślnie ASP.NET strony sieci Web weryfikują, czy dane wejściowe użytkownika nie zawierają skryptów ani elementów HTML. Aby uzyskać więcej informacji, zobacz Omówienie luk w zabezpieczeniach skryptów.

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

Uwagi

Służy FindControl do uzyskiwania dostępu do kontroli z funkcji na stronie kodu, aby uzyskać dostęp do kontroli wewnątrz innego kontenera lub w innych okolicznościach, gdy kontrolka docelowa nie jest bezpośrednio dostępna dla obiektu wywołującego. Ta metoda znajdzie kontrolkę tylko wtedy, gdy kontrolka jest bezpośrednio zawarta w określonym kontenerze; oznacza to, że metoda nie wyszukuje w całej hierarchii kontrolek w ramach kontrolek. Aby uzyskać informacje na temat znajdowania kontrolki, gdy nie znasz bezpośredniego kontenera, zobacz Instrukcje: uzyskiwanie dostępu do kontrolek serwera według identyfikatora.

Zobacz też

• Instrukcje: uzyskiwanie dostępu do kontrolek serwera według identyfikatora

FindControl(String, Int32)

Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera z określoną liczbą id całkowitą określoną w parametrze pathOffset , co ułatwia wyszukiwanie. Nie należy zastąpić tej wersji FindControl metody.

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

Parametry

id

String

Identyfikator kontrolki, która ma zostać znaleziona.

pathOffset

Int32

Liczba kontrolek w górę hierarchii kontrolek strony potrzebnej do osiągnięcia kontenera nazewnictwa.

Zwraca

Control

Określona kontrolka lub null jeśli określona kontrolka nie istnieje.