Control.FindControl Methode

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Durchsucht den aktuellen Benennungscontainer für das angegebene Serversteuerelement.

Überlädt

Name	Beschreibung
FindControl(String)	Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit dem angegebenen id Parameter.
FindControl(String, Int32)	Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit der angegebenen id und einer ganzzahligen Zahl, die pathOffset im Parameter angegeben ist, der die Suche unterstützt. Sie sollten diese Version der FindControl Methode nicht außer Kraft setzen.

FindControl(String)

Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit dem angegebenen id Parameter.

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

Parameter

id

String

Der Bezeichner für das zu findende Steuerelement.

Gibt zurück

Control

Das angegebene Steuerelement oder null wenn das angegebene Steuerelement nicht vorhanden ist.

Beispiele

Im folgenden Beispiel wird ein Button1_Click Ereignishandler definiert. Wenn dieser Handler aufgerufen wird, verwendet dieser Handler die FindControl Methode, um ein Steuerelement mit einer ID Eigenschaft TextBox2 auf der enthaltenden Seite zu suchen. Wenn das Steuerelement gefunden wird, wird das übergeordnete Element mithilfe der Parent Eigenschaft bestimmt, und das übergeordnete Steuerelement ID wird auf die Seite geschrieben. Wenn TextBox2 nicht gefunden wird, wird "Steuerelement nicht gefunden" auf die Seite geschrieben.

Von Bedeutung

In diesem Beispiel handelt es sich um ein Textfeld, das Benutzereingaben akzeptiert, bei denen es sich um eine potenzielle Sicherheitsrisiken handelt. Standardmäßig überprüfen ASP.NET Webseiten, dass die Benutzereingabe keine Skript- oder HTML-Elemente enthält. Weitere Informationen finden Sie unter Script Exploits Overview.

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

Hinweise

Wird verwendet FindControl , um von einer Funktion auf einer CodeBehind-Seite auf ein Steuerelement zuzugreifen, das sich in einem anderen Container befindet, oder unter anderen Umständen, in denen das Zielsteuerelement nicht direkt auf den Aufrufer zugreifen kann. Diese Methode findet nur dann ein Steuerelement, wenn das Steuerelement direkt im angegebenen Container enthalten ist; d. h., die Methode durchsucht nicht innerhalb einer Hierarchie von Steuerelementen innerhalb von Steuerelementen. Informationen zum Suchen eines Steuerelements, wenn Sie den unmittelbaren Container nicht kennen, finden Sie unter How to: Access Server Controls by ID.

Weitere Informationen

• Vorgehensweise: Zugreifen auf Serversteuerelemente nach ID

FindControl(String, Int32)

Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit der angegebenen id und einer ganzzahligen Zahl, die pathOffset im Parameter angegeben ist, der die Suche unterstützt. Sie sollten diese Version der FindControl Methode nicht außer Kraft setzen.

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

Parameter

id

String

Der Bezeichner für das zu findende Steuerelement.

pathOffset

Int32

Die Anzahl der Steuerelemente, die die Seitensteuerelementhierarchie nach oben richten müssen, um einen Benennungscontainer zu erreichen.

Gibt zurück

Control

Das angegebene Steuerelement oder null wenn das angegebene Steuerelement nicht vorhanden ist.