Control.FindControl Control.FindControl Control.FindControl Control.FindControl Method

Definition

Durchsucht den aktuellen Benennungscontainer nach dem angegebenen Serversteuerelement.Searches the current naming container for the specified server control.

Überlädt

FindControl(String) FindControl(String) FindControl(String) FindControl(String)

Durchsucht den aktuellen Benennungscontainer nach dem angegebenen Serversteuerelement mit dem angegebenen id-Parameter.Searches the current naming container for a server control with the specified id parameter.

FindControl(String, Int32) FindControl(String, Int32) FindControl(String, Int32) FindControl(String, Int32)

Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen id und einer ganzen Zahl, die im pathOffset-Parameter angegeben ist, der die Suche unterstützt.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Sie sollten diese Version der FindControl-Methode nicht überschreiben.You should not override this version of the FindControl method.

FindControl(String) FindControl(String) FindControl(String) FindControl(String)

Durchsucht den aktuellen Benennungscontainer nach dem angegebenen Serversteuerelement mit dem angegebenen id-Parameter.Searches the current naming container for a server control with the specified 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 String String String

Der Bezeichner für das zu suchende Steuerelement.The identifier for the control to be found.

Gibt zurück

Das angegebene Steuerelement oder null, wenn das angegebene Steuerelement nicht vorhanden ist.The specified control, or null if the specified control does not exist.

Beispiele

Das folgende Beispiel definiert eine Button1_Click -Ereignishandler.The following example defines a Button1_Click event handler. Dieser Handler wird verwendet, wenn aufgerufen, die FindControl Methode zum Suchen eines Steuerelements mit einem ID Eigenschaft TextBox2 auf die enthaltende Seite.When invoked, this handler uses the FindControl method to locate a control with an ID property of TextBox2 on the containing page. Wenn das Steuerelement gefunden wird, die das übergeordnete Element wird anhand der Parent Eigenschaft und des übergeordneten Steuerelements ID wird auf der Seite geschrieben.If the control is found, its parent is determined using the Parent property and the parent control's ID is written to the page. Wenn TextBox2 nicht gefunden wird, wird "-Steuerelement nicht gefunden" auf die Seite geschrieben wird.If TextBox2 is not found, "Control Not Found" is written to the page.

Wichtig

Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen.This example has a text box that accepts user input, which is a potential security threat. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.For more information, see 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

Verwendung FindControl auf ein Steuerelement aus einer Funktion in einer Code-Behind-Seite, auf ein Steuerelement zuzugreifen, die in einem anderen Container oder in anderen Fällen, in dem das Zielsteuerelement kein direkt an den Aufrufer zugegriffen werden kann.Use FindControl to access a control from a function in a code-behind page, to access a control that is inside another container, or in other circumstances where the target control is not directly accessible to the caller. Suchen Sie diese Methode wird ein Steuerelement nur dann, wenn das Steuerelement direkt im angegebenen Container; enthalten ist die Methode sucht, also nicht in der gesamten Hierarchie der Steuerelemente in Steuerelementen.This method will find a control only if the control is directly contained by the specified container; that is, the method does not search throughout a hierarchy of controls within controls. Weitere Informationen zum Suchen eines Steuerelements, wenn Sie nicht, dass die sofortige Container wissen, finden Sie unter Vorgehensweise: Zugreifen auf Steuerelemente nach ID.For information about how to find a control when you do not know its immediate container, see How to: Access Server Controls by ID.

Siehe auch

FindControl(String, Int32) FindControl(String, Int32) FindControl(String, Int32) FindControl(String, Int32)

Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen id und einer ganzen Zahl, die im pathOffset-Parameter angegeben ist, der die Suche unterstützt.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Sie sollten diese Version der FindControl-Methode nicht überschreiben.You should not override this version of the FindControl method.

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 String String String

Der Bezeichner für das zu suchende Steuerelement.The identifier for the control to be found.

pathOffset
Int32 Int32 Int32 Int32

Die Anzahl von Steuerelementen bis zu einem Benennungscontainer (aufsteigend in der Seitensteuerelementhierarchie).The number of controls up the page control hierarchy needed to reach a naming container.

Gibt zurück

Das angegebene Steuerelement oder null, wenn das angegebene Steuerelement nicht vorhanden ist.The specified control, or null if the specified control does not exist.

Gilt für: