GridViewRow Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt eine einzelne Zeile in einem GridView Steuerelement dar.
public ref class GridViewRow : System::Web::UI::WebControls::TableRow, System::Web::UI::IDataItemContainerpublic class GridViewRow : System.Web.UI.WebControls.TableRow, System.Web.UI.IDataItemContainertype GridViewRow = class
inherit TableRow
interface IDataItemContainer
interface INamingContainerPublic Class GridViewRow
Inherits TableRow
Implements IDataItemContainer- Vererbung
- Implementiert
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie ein GridViewRow Objekt verwendet wird, um einen Feldwert aus einer Zelle im GridView Steuerelement abzurufen und dann den Wert auf der Seite anzuzeigen.
<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void AuthorsGridView_SelectedIndexChanged(Object sender, EventArgs e)
{
// Get the selected row from the GridView control.
GridViewRow selectRow = AuthorsGridView.SelectedRow;
// Get the author's first and last name from the appropriate
// cells in the selected row. For BoundField field columns
// and automatically generated field columns, the Text property
// of a cell is used to access a field value.
String lastName = selectRow.Cells[1].Text;
// In a TemplateField column where a data-binding expression
// is used directly in the ItemTemplate, the field value
// is automatically placed in DataBoundLiteral control.
// Retrieve the DataBoundLiteral control from the cell. The
// DataBoundLiteral control is the first control in the
// Controls collection.
DataBoundLiteralControl firstNameLiteral = (DataBoundLiteralControl)selectRow.Cells[2].Controls[0];
String firstName = firstNameLiteral.Text;
// Display the name of the selected author.
Message.Text = "You selected " + firstName + " " + lastName + ".";
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>GridViewRow Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>GridViewRow Example</h3>
<asp:label id="Message"
forecolor="Red"
runat="server"/>
<br/>
<asp:gridview id="AuthorsGridView"
datasourceid="AuthorsSqlDataSource"
autogeneratecolumns="false"
autogenerateselectbutton="true"
onselectedindexchanged="AuthorsGridView_SelectedIndexChanged"
runat="server">
<columns>
<asp:boundfield datafield="au_lname"
headertext="Last Name"/>
<asp:templatefield headertext="FirstName">
<itemtemplate>
<%#Eval("au_fname")%>
</itemtemplate>
</asp:templatefield>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Pubs sample database. -->
<asp:sqldatasource id="AuthorsSqlDataSource"
selectcommand="SELECT [au_lname], [au_fname], [address], [city], [state], [zip], [contract] FROM [authors]"
connectionstring="server=localhost;database=pubs;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
<%@ Page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub AuthorsGridView_SelectedIndexChanged(ByVal sender As Object, ByVal e As EventArgs)
' Get the selected row from the GridView control.
Dim selectRow As GridViewRow = AuthorsGridView.SelectedRow
' Get the author's first and last name from the appropriate
' cells in the selected row. For BoundField field columns
' and automatically generated field columns, the Text property
' of a cell is used to access a field value.
Dim lastName As String = selectRow.Cells(1).Text
' In a TemplateField column where a data-binding expression
' is used directly in the ItemTemplate, the field value
' is automatically placed in DataBoundLiteral control.
' Retrieve the DataBoundLiteral control from the cell. The
' DataBoundLiteral control is the first control in the
' Controls collection.
Dim firstNameLiteral As DataBoundLiteralControl = CType(selectRow.Cells(2).Controls(0), DataBoundLiteralControl)
Dim firstName As String = firstNameLiteral.Text
' Display the name of the selected author.
Message.Text = "You selected " & firstName & " " & lastName & "."
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>GridViewRow Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>GridViewRow Example</h3>
<asp:label id="Message"
forecolor="Red"
runat="server"/>
<br/>
<asp:gridview id="AuthorsGridView"
datasourceid="AuthorsSqlDataSource"
autogeneratecolumns="false"
autogenerateselectbutton="true"
onselectedindexchanged="AuthorsGridView_SelectedIndexChanged"
runat="server">
<columns>
<asp:boundfield datafield="au_lname"
headertext="Last Name"/>
<asp:templatefield headertext="FirstName">
<itemtemplate>
<%#Eval("au_fname")%>
</itemtemplate>
</asp:templatefield>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Pubs sample database. -->
<asp:sqldatasource id="AuthorsSqlDataSource"
selectcommand="SELECT [au_lname], [au_fname], [address], [city], [state], [zip], [contract] FROM [authors]"
connectionstring="server=localhost;database=pubs;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
Das folgende Beispiel veranschaulicht, wie ein GridViewRow Objekt verwendet wird, um ein TextBox Steuerelement abzurufen, das in der Bearbeitungselementvorlage einer TemplateField Feldspalte deklariert ist. Der Wert des Textfelds wird dann an ein SqlDataSource Steuerelement zum Aktualisieren in der Datenquelle übergeben.
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.
<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void AuthorsGridView_RowUpdating (Object sender, GridViewUpdateEventArgs e)
{
// In this example, the GridView control will not automatically extract
// updated values from TemplateField column fields because they are not
// using a two-way binding expression. So, the updated
// values must be added manually to the NewValues dictionary.
// Get the GridViewRow object that represents the row being edited
// from the Rows collection of the GridView control.
int index = AuthorsGridView.EditIndex;
GridViewRow row = AuthorsGridView.Rows[index];
// Get the controls that contain the updated values. In this
// example, the updated values are contained in the TextBox
// controls declared in the EditItemTemplates of the TemplateField
// column fields in the GridView control.
TextBox lastName = (TextBox)row.FindControl("LastNameTextBox");
TextBox firstName = (TextBox)row.FindControl("FirstNameTextBox");
// Add the updated values to the NewValues dictionary. Use the
// parameter names declared in the parameterized update query
// string for the key names.
e.NewValues["au_lname"] = lastName.Text;
e.NewValues["au_fname"] = firstName.Text;
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>GridViewRow Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>GridViewRow Example</h3>
<!-- The GridView control automatically sets the columns -->
<!-- specified in the datakeynames attribute as read-only -->
<!-- No input controls are rendered for these columns in -->
<!-- edit mode. -->
<asp:gridview id="AuthorsGridView"
datasourceid="AuthorsSqlDataSource"
autogeneratecolumns="false"
autogenerateeditbutton="true"
datakeynames="au_id"
cellpadding="10"
onrowupdating="AuthorsGridView_RowUpdating"
runat="server">
<columns>
<asp:boundfield datafield="au_id"
headertext="Author ID"
readonly="true"/>
<asp:templatefield headertext="Last Name"
itemstyle-verticalalign="Top">
<itemtemplate>
<%#Eval("au_lname")%>
</itemtemplate>
<edititemtemplate>
<asp:textbox id="LastNameTextBox"
text='<%#Eval("au_lname")%>'
width="90"
runat="server"/>
<br/>
<asp:requiredfieldvalidator id="LastNameRequiredValidator"
controltovalidate="LastNameTextBox"
display="Dynamic"
text="Please enter a last name."
runat="server" />
</edititemtemplate>
</asp:templatefield>
<asp:templatefield headertext="First Name"
itemstyle-verticalalign="Top">
<itemtemplate>
<%#Eval("au_fname")%>
</itemtemplate>
<edititemtemplate>
<asp:textbox id="FirstNameTextBox"
text='<%#Eval("au_fname")%>'
width="90"
runat="server"/>
<br/>
<asp:requiredfieldvalidator id="FirstNameRequiredValidator"
controltovalidate="FirstNameTextBox"
display="Dynamic"
text="Please enter a first name."
runat="server" />
</edititemtemplate>
</asp:templatefield>
<asp:checkboxfield datafield="contract"
headertext="Contract"
readonly="true"/>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Pubs sample database. -->
<asp:sqldatasource id="AuthorsSqlDataSource"
selectcommand="SELECT [au_id], [au_lname], [au_fname], [contract] FROM [authors]"
updatecommand="UPDATE authors SET au_lname=@au_lname, au_fname=@au_fname WHERE (authors.au_id = @au_id)"
connectionstring="server=localhost;database=pubs;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
<%@ Page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub AuthorsGridView_RowUpdating(ByVal sender As Object, ByVal e As GridViewUpdateEventArgs)
' In this example, the GridView control will not automatically extract
' updated values from TemplateField column fields because they are not
' using a two-way binding expression. So, the updated
' values must be added manually to the NewValues dictionary.
' Get the GridViewRow object that represents the row being edited
' from the Rows collection of the GridView control.
Dim index As Integer = AuthorsGridView.EditIndex
Dim row As GridViewRow = AuthorsGridView.Rows(index)
' Get the controls that contain the updated values. In this
' example, the updated values are contained in the TextBox
' controls declared in the EditItemTemplates of the TemplateField
' column fields in the GridView control.
Dim lastName As TextBox = CType(row.FindControl("LastNameTextBox"), TextBox)
Dim firstName As TextBox = CType(row.FindControl("FirstNameTextBox"), TextBox)
' Add the updated values to the NewValues dictionary. Use the
' parameter names declared in the parameterized update query
' string for the key names.
e.NewValues("au_lname") = lastName.Text
e.NewValues("au_fname") = firstName.Text
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>GridViewRow Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>GridViewRow Example</h3>
<!-- The GridView control automatically sets the columns -->
<!-- specified in the datakeynames attribute as read-only -->
<!-- No input controls are rendered for these columns in -->
<!-- edit mode. -->
<asp:gridview id="AuthorsGridView"
datasourceid="AuthorsSqlDataSource"
autogeneratecolumns="false"
autogenerateeditbutton="true"
datakeynames="au_id"
cellpadding="10"
onrowupdating="AuthorsGridView_RowUpdating"
runat="server">
<columns>
<asp:boundfield datafield="au_id"
headertext="Author ID"
readonly="true"/>
<asp:templatefield headertext="Last Name"
itemstyle-verticalalign="Top">
<itemtemplate>
<%#Eval("au_lname")%>
</itemtemplate>
<edititemtemplate>
<asp:textbox id="LastNameTextBox"
text='<%#Eval("au_lname")%>'
width="90"
runat="server"/>
<br/>
<asp:requiredfieldvalidator id="LastNameRequiredValidator"
controltovalidate="LastNameTextBox"
display="Dynamic"
text="Please enter a last name."
runat="server" />
</edititemtemplate>
</asp:templatefield>
<asp:templatefield headertext="First Name"
itemstyle-verticalalign="Top">
<itemtemplate>
<%#Eval("au_fname")%>
</itemtemplate>
<edititemtemplate>
<asp:textbox id="FirstNameTextBox"
text='<%#Eval("au_fname")%>'
width="90"
runat="server"/>
<br/>
<asp:requiredfieldvalidator id="FirstNameRequiredValidator"
controltovalidate="FirstNameTextBox"
display="Dynamic"
text="Please enter a first name."
runat="server" />
</edititemtemplate>
</asp:templatefield>
<asp:checkboxfield datafield="contract"
headertext="Contract"
readonly="true"/>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Pubs sample database. -->
<asp:sqldatasource id="AuthorsSqlDataSource"
selectcommand="SELECT [au_id], [au_lname], [au_fname], [contract] FROM [authors]"
updatecommand="UPDATE authors SET au_lname=@au_lname, au_fname=@au_fname WHERE (authors.au_id = @au_id)"
connectionstring="server=localhost;database=pubs;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
Hinweise
Die GridViewRow Klasse wird verwendet, um eine einzelne Zeile in einem GridView Steuerelement darzustellen. Jede Zeile im GridView Steuerelement verfügt über einen bestimmten Zeilentyp mithilfe der DataControlRowType Enumeration. In der folgenden Tabelle sind die verschiedenen Zeilentypen aufgeführt.
| Zeilenart | Beschreibung |
|---|---|
DataRow |
Eine Datenzeile im GridView Steuerelement. |
EmptyDataRow |
Die leere Zeile im GridView Steuerelement. Die leere Zeile wird angezeigt, wenn das GridView Steuerelement keine Anzuzeigenden Datensätze enthält und die GridView.EmptyDataTemplate Vorlage nicht nullvorhanden ist. |
Footer |
Die Fußzeile im GridView Steuerelement. |
Header |
Die Kopfzeile im GridView Steuerelement. |
Pager |
Eine Pagerzeile im GridView Steuerelement. |
Separator |
Eine Trennzeile im GridView Steuerelement. |
Verwenden Sie die RowType Eigenschaft, um den Zeilentyp eines GridViewRow Objekts zu bestimmen. Ein GridViewRow Objekt weist auch einen zugehörigen Zustand auf. Der Zustand kann eine bitweise Kombination der Werte in der folgenden Tabelle sein.
| Zustandswert | Beschreibung |
|---|---|
Alternate |
Das GridViewRow Objekt ist eine alternative Zeile im GridView Steuerelement. |
Edit |
Das GridViewRow Objekt befindet sich im Bearbeitungsmodus. |
Normal |
Das GridViewRow Objekt befindet sich im normalen Zustand (Standardeinstellung). |
Selected |
Das GridViewRow Objekt ist ausgewählt. |
Verwenden Sie die RowState Eigenschaft, um den Status eines GridViewRow Objekts zu bestimmen.
Das GridView Steuerelement speichert alle Datenzeilen in der Rows Auflistung. Verwenden Sie die RowIndex Eigenschaft, um den Index eines GridViewRow Objekts in der Rows Auflistung zu bestimmen.
Sie können mithilfe der Eigenschaft auf die Eigenschaften des zugrunde liegenden Datenobjekts zugreifen, das an das GridViewRow Objekt DataItem gebunden ist.
Hinweis
Die DataItem Eigenschaft ist nur während und nach dem RowDataBound Ereignis eines GridView Steuerelements verfügbar.
Verwenden Sie die DataItemIndex Eigenschaft, um den Index des Datenobjekts in der zugrunde liegenden Datenquelle zu bestimmen.
Sie können mithilfe der Cells Eigenschaft auf die einzelnen Zellen des GridViewRow Objekts zugreifen. Wenn eine Zelle andere Steuerelemente enthält, können Sie mithilfe der Auflistung der Zelle ein Steuerelement aus der Zelle Controls abrufen. Sie können auch die FindControl Methode der Zelle verwenden, um das Steuerelement zu finden, wenn das Steuerelement angegeben ID ist.
Verwenden Sie die Text Eigenschaft der Zelle, um einen Feldwert aus einer BoundField Feldspalte oder einer automatisch generierten Feldspalte abzurufen. Um einen Feldwert aus anderen Feldspaltentypen abzurufen, in denen der Feldwert an ein Steuerelement gebunden ist, rufen Sie zuerst das Steuerelement aus der entsprechenden Zelle ab und greifen dann auf die entsprechende Eigenschaft des Steuerelements zu.
Hinweis
Es ist möglich, einen Datenbindungsausdruck direkt in einer TemplateField Feldspalte zu verwenden, ohne den Wert an eine Eigenschaft eines Steuerelements zu binden. In diesem Fall wird der Feldwert automatisch in ein DataBoundLiteralControl Steuerelement eingefügt. Um den Feldwert abzurufen, müssen Sie zuerst das DataBoundLiteralControl Steuerelement aus der entsprechenden Zelle abrufen und dann dessen Eigenschaft verwenden Text .
Eine Liste der anfänglichen Eigenschaftswerte für eine Instanz von GridViewRow, finden Sie im GridViewRow Konstruktor.
Konstruktoren
| Name | Beschreibung |
|---|---|
| GridViewRow(Int32, Int32, DataControlRowType, DataControlRowState) |
Initialisiert eine neue Instanz der GridViewRow-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| AccessKey |
Dient zum Abrufen oder Festlegen der Zugriffstaste, mit der Sie schnell zum Webserversteuerelement navigieren können. (Geerbt von WebControl) |
| Adapter |
Ruft den browserspezifischen Adapter für das Steuerelement ab. (Geerbt von Control) |
| AppRelativeTemplateSourceDirectory |
Dient zum Abrufen oder Festlegen des anwendungsrelativen virtuellen Verzeichnisses des Page Objekts UserControl , das dieses Steuerelement enthält. (Geerbt von Control) |
| Attributes |
Ruft die Auflistung beliebiger Attribute (nur für das Rendern) ab, die nicht den Eigenschaften des Steuerelements entsprechen. (Geerbt von WebControl) |
| BackColor |
Dient zum Abrufen oder Festlegen der Hintergrundfarbe des Webserversteuerelements. (Geerbt von WebControl) |
| BindingContainer |
Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält. (Geerbt von Control) |
| BorderColor |
Ruft die Rahmenfarbe des Websteuerelements ab oder legt diese fest. (Geerbt von WebControl) |
| BorderStyle |
Dient zum Abrufen oder Festlegen des Rahmenstils des Webserversteuerelements. (Geerbt von WebControl) |
| BorderWidth |
Ruft die Rahmenbreite des Webserversteuerelements ab oder legt diese fest. (Geerbt von WebControl) |
| Cells |
Ruft eine Auflistung von TableCell Objekten ab, die die Zellen einer Zeile in einem Table Steuerelement darstellen. (Geerbt von TableRow) |
| ChildControlsCreated |
Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden. (Geerbt von Control) |
| ClientID |
Ruft die Steuerelement-ID für HTML-Markup ab, das von ASP.NET generiert wird. (Geerbt von Control) |
| ClientIDMode |
Dient zum Abrufen oder Festlegen des Algorithmus, der zum Generieren des Werts der ClientID Eigenschaft verwendet wird. (Geerbt von Control) |
| ClientIDSeparator |
Ruft einen Zeichenwert ab, der das Trennzeichen darstellt, das in der ClientID Eigenschaft verwendet wird. (Geerbt von Control) |
| Context |
Ruft das Objekt ab, das HttpContext dem Serversteuerelement für die aktuelle Webanforderung zugeordnet ist. (Geerbt von Control) |
| Controls |
Ruft ein ControlCollection Objekt ab, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Ui-Hierarchie darstellt. (Geerbt von Control) |
| ControlStyle |
Ruft den Stil des Webserversteuerelements ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| ControlStyleCreated |
Ruft einen Wert ab, der angibt, ob ein Style Objekt für die ControlStyle Eigenschaft erstellt wurde. Diese Eigenschaft wird in erster Linie von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| CssClass |
Dient zum Abrufen oder Festlegen der Cascading StyleSheet (CSS)-Klasse, die vom Webserversteuerelement auf dem Client gerendert wird. (Geerbt von WebControl) |
| DataItem |
Ruft das zugrunde liegende Datenobjekt ab, an das das GridViewRow Objekt gebunden ist. |
| DataItemContainer |
Ruft einen Verweis auf den Benennungscontainer ab, wenn der Benennungscontainer IDataItemContainerimplementiert wird. (Geerbt von Control) |
| DataItemIndex | |
| DataKeysContainer |
Ruft einen Verweis auf den Benennungscontainer ab, wenn der Benennungscontainer IDataKeysControlimplementiert wird. (Geerbt von Control) |
| DesignMode |
Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird. (Geerbt von Control) |
| Enabled |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Webserversteuerelement aktiviert ist. (Geerbt von WebControl) |
| EnableTheming |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Designs für dieses Steuerelement gelten. (Geerbt von WebControl) |
| EnableViewState |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Serversteuerelement den Ansichtszustand und den Ansichtszustand aller enthaltenen untergeordneten Steuerelemente für den anfordernden Client behält. (Geerbt von Control) |
| Events |
Ruft eine Liste von Ereignishandlerdelegatten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt. (Geerbt von Control) |
| Font |
Ruft die Schriftarteigenschaften ab, die dem Webserversteuerelement zugeordnet sind. (Geerbt von WebControl) |
| ForeColor |
Ruft die Vordergrundfarbe (in der Regel die Farbe des Texts) des Webserversteuerelements ab oder legt sie fest. (Geerbt von WebControl) |
| HasAttributes |
Ruft einen Wert ab, der angibt, ob das Steuerelement Attribute festgelegt hat. (Geerbt von WebControl) |
| HasChildViewState |
Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des aktuellen Serversteuerelements über gespeicherte Ansichtszustandseinstellungen verfügen. (Geerbt von Control) |
| Height |
Ruft die Höhe des Webserversteuerelements ab oder legt sie fest. (Geerbt von WebControl) |
| HorizontalAlign |
Ruft die horizontale Ausrichtung des Inhalts in der Zeile ab oder legt sie fest. (Geerbt von TableRow) |
| ID |
Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest. (Geerbt von Control) |
| IdSeparator |
Ruft das Zeichen ab, das zum Trennen von Steuerelementbezeichnern verwendet wird. (Geerbt von Control) |
| IsChildControlStateCleared |
Ruft einen Wert ab, der angibt, ob In diesem Steuerelement enthaltene Steuerelemente den Steuerelementstatus aufweisen. (Geerbt von Control) |
| IsEnabled |
Ruft einen Wert ab, der angibt, ob das Steuerelement aktiviert ist. (Geerbt von WebControl) |
| IsTrackingViewState |
Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen am Ansichtszustand speichert. (Geerbt von Control) |
| IsViewStateEnabled |
Ruft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist. (Geerbt von Control) |
| LoadViewStateByID |
Ruft einen Wert ab, der angibt, ob das Steuerelement am Laden des Ansichtszustands anstelle ID von Index teilnimmt. (Geerbt von Control) |
| NamingContainer |
Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace für die Unterscheidung zwischen Serversteuerelementen mit demselben ID Eigenschaftswert erstellt. (Geerbt von Control) |
| Page |
Ruft einen Verweis auf die Page Instanz ab, die das Serversteuerelement enthält. (Geerbt von Control) |
| Parent |
Ruft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Seitensteuerelementhierarchie ab. (Geerbt von Control) |
| RenderingCompatibility |
Ruft einen Wert ab, der die ASP.NET Version angibt, mit der html gerendert wird, kompatibel ist. (Geerbt von Control) |
| RowIndex |
Ruft den Index des GridViewRow Objekts in der Rows Auflistung eines GridView Steuerelements ab. |
| RowState |
Ruft den Status des GridViewRow Objekts ab. |
| RowType |
Ruft den Zeilentyp des GridViewRow Objekts ab. |
| Site |
Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostt, wenn es auf einer Entwurfsoberfläche gerendert wird. (Geerbt von Control) |
| SkinID |
Ruft die Haut ab, die auf das Steuerelement angewendet werden soll, oder legt sie fest. (Geerbt von WebControl) |
| Style |
Ruft eine Auflistung von Textattributen ab, die als Formatvorlagenattribute auf dem äußeren Tag des Webserversteuerelements gerendert werden. (Geerbt von WebControl) |
| SupportsDisabledAttribute |
Ruft einen Wert ab, der angibt, ob das Steuerelement das |
| TabIndex |
Dient zum Abrufen oder Festlegen des Registerkartenindex des Webserversteuerelements. (Geerbt von WebControl) |
| TableSection |
Dient zum Abrufen oder Festlegen der Position für ein TableRow Objekt in einem Table Steuerelement. (Geerbt von TableRow) |
| TagKey |
Ruft den Wert ab, der HtmlTextWriterTag diesem Webserversteuerelement entspricht. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| TagName |
Ruft den Namen des Steuerelementtags ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| TemplateControl |
Dient zum Abrufen oder Festlegen eines Verweises auf die Vorlage, die dieses Steuerelement enthält. (Geerbt von Control) |
| TemplateSourceDirectory |
Ruft das virtuelle Verzeichnis des Page oder UserControl das aktuelle Serversteuerelement ab. (Geerbt von Control) |
| ToolTip |
Ruft den Text ab, der angezeigt wird, wenn der Mauszeiger auf das Webserversteuerelement zeigt, oder legt diesen fest. (Geerbt von WebControl) |
| UniqueID |
Ruft den eindeutigen hierarchisch qualifizierten Bezeichner für das Serversteuerelement ab. (Geerbt von Control) |
| ValidateRequestMode |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Steuerelement Clienteingaben aus dem Browser auf potenziell gefährliche Werte überprüft. (Geerbt von Control) |
| VerticalAlign |
Dient zum Abrufen oder Festlegen der vertikalen Ausrichtung des Inhalts in der Zeile. (Geerbt von TableRow) |
| ViewState |
Ruft ein Wörterbuch mit Statusinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements für mehrere Anforderungen für dieselbe Seite speichern und wiederherstellen können. (Geerbt von Control) |
| ViewStateIgnoresCase |
Ruft einen Wert ab, der angibt, ob die Groß-/Kleinschreibung des StateBag Objekts nicht beachtet wird. (Geerbt von Control) |
| ViewStateMode |
Ruft den Ansichtszustandsmodus dieses Steuerelements ab oder legt diesen fest. (Geerbt von Control) |
| Visible |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Serversteuerelement als Benutzeroberfläche auf der Seite gerendert wird. (Geerbt von Control) |
| Width |
Dient zum Abrufen oder Festlegen der Breite des Webserversteuerelements. (Geerbt von WebControl) |
Methoden
| Name | Beschreibung |
|---|---|
| AddAttributesToRender(HtmlTextWriter) |
Fügt HTML-Attribute und -Formatvorlagen hinzu, die dem angegebenen Element HtmlTextWriterTaggerendert werden müssen. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| AddedControl(Control, Int32) |
Wird aufgerufen, nachdem der Auflistung des Objekts ein untergeordnetes Control Steuerelement hinzugefügt Controls wurde. (Geerbt von Control) |
| AddParsedSubObject(Object) |
Benachrichtigt das Serversteuerelement, dass ein Element, entweder XML oder HTML, analysiert wurde, und fügt das Element dem Objekt des Serversteuerelements ControlCollection hinzu. (Geerbt von Control) |
| ApplyStyle(Style) |
Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement, wobei alle vorhandenen Formatvorlagenelemente des Steuerelements überschrieben werden. Diese Methode wird in erster Linie von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| ApplyStyleSheetSkin(Page) |
Wendet die im Seitenstylesheet definierten Formatvorlageneigenschaften auf das Steuerelement an. (Geerbt von Control) |
| BeginRenderTracing(TextWriter, Object) |
Beginnt mit der Entwurfszeitablaufverfolgung von Renderingdaten. (Geerbt von Control) |
| BuildProfileTree(String, Boolean) |
Sammelt Informationen über das Serversteuerelement und liefert sie an die Eigenschaft, die Trace angezeigt werden soll, wenn die Ablaufverfolgung für die Seite aktiviert ist. (Geerbt von Control) |
| ClearCachedClientID() |
Legt den zwischengespeicherten ClientID Wert auf |
| ClearChildControlState() |
Löscht die Steuerelementstatusinformationen für die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearChildState() |
Löscht die Ansichts- und Steuerelementstatusinformationen für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearChildViewState() |
Löscht die Ansichtsstatusinformationen für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearEffectiveClientIDMode() |
Legt die ClientIDMode Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit. (Geerbt von Control) |
| CopyBaseAttributes(WebControl) |
Kopiert die Eigenschaften, die nicht vom Objekt aus dem Style angegebenen Webserversteuerelement in das Webserversteuerelement gekapselt werden, von dem diese Methode aufgerufen wird. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| CreateChildControls() |
Wird vom ASP.NET Seitenframework aufgerufen, um Serversteuerelemente zu benachrichtigen, die kompositionsbasierte Implementierung verwenden, um alle untergeordneten Steuerelemente zu erstellen, die sie in Vorbereitung auf das Veröffentlichen von Zurück- oder Rendering enthalten. (Geerbt von Control) |
| CreateControlCollection() |
Erstellt ein neues ControlCollection Objekt für das TableRow Steuerelement. (Geerbt von TableRow) |
| CreateControlStyle() |
Erstellt ein TableItemStyle Objekt für das TableRow Steuerelement. (Geerbt von TableRow) |
| DataBind() |
Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente. (Geerbt von Control) |
| DataBind(Boolean) |
Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit einer Option zum Auslösen des DataBinding Ereignisses. (Geerbt von Control) |
| DataBindChildren() |
Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| Dispose() |
Ermöglicht es einem Serversteuerelement, die endgültige Bereinigung durchzuführen, bevor es aus dem Arbeitsspeicher freigegeben wird. (Geerbt von Control) |
| EndRenderTracing(TextWriter, Object) |
Beendet die Entwurfszeitablaufverfolgung von Renderingdaten. (Geerbt von Control) |
| EnsureChildControls() |
Bestimmt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn dies nicht der Fall ist, werden untergeordnete Steuerelemente erstellt. (Geerbt von Control) |
| EnsureID() |
Erstellt einen Bezeichner für Steuerelemente, denen kein Bezeichner zugewiesen ist. (Geerbt von Control) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| FindControl(String, Int32) |
Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit der angegebenen |
| FindControl(String) |
Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit dem angegebenen |
| Focus() |
Legt den Eingabefokus auf ein Steuerelement fest. (Geerbt von Control) |
| GetDesignModeState() |
Ruft Entwurfszeitdaten für ein Steuerelement ab. (Geerbt von Control) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetRouteUrl(Object) |
Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Geerbt von Control) |
| GetRouteUrl(RouteValueDictionary) |
Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Geerbt von Control) |
| GetRouteUrl(String, Object) |
Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Geerbt von Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Geerbt von Control) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| GetUniqueIDRelativeTo(Control) |
Gibt den präfixierten Teil der UniqueID Eigenschaft des angegebenen Steuerelements zurück. (Geerbt von Control) |
| HasControls() |
Bestimmt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. (Geerbt von Control) |
| HasEvents() |
Gibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder untergeordnete Steuerelemente registriert sind. (Geerbt von Control) |
| IsLiteralContent() |
Bestimmt, ob das Serversteuerelement nur Literalinhalte enthält. (Geerbt von Control) |
| LoadControlState(Object) |
Stellt Steuerstatusinformationen aus einer vorherigen Seitenanforderung wieder her, die von der SaveControlState() Methode gespeichert wurde. (Geerbt von Control) |
| LoadViewState(Object) |
Stellt Ansichtsstatusinformationen aus einer vorherigen Anforderung wieder her, die mit der SaveViewState() Methode gespeichert wurde. (Geerbt von WebControl) |
| MapPathSecure(String) |
Ruft den physischen Pfad ab, dem ein virtueller Pfad, entweder absolut oder relativ, zugeordnet ist. (Geerbt von Control) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| MergeStyle(Style) |
Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement, überschreibt jedoch keine vorhandenen Formatvorlagenelemente des Steuerelements. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Bestimmt, ob ein Ereignis an die ASP.NET Serversteuerelementhierarchie der Seite übergeben werden soll. |
| OnDataBinding(EventArgs) |
Löst das DataBinding-Ereignis aus. (Geerbt von Control) |
| OnInit(EventArgs) |
Löst das Init-Ereignis aus. (Geerbt von Control) |
| OnLoad(EventArgs) |
Löst das Load-Ereignis aus. (Geerbt von Control) |
| OnPreRender(EventArgs) |
Löst das PreRender-Ereignis aus. (Geerbt von Control) |
| OnUnload(EventArgs) |
Löst das Unload-Ereignis aus. (Geerbt von Control) |
| OpenFile(String) |
Ruft einen Stream Verwendeten zum Lesen einer Datei ab. (Geerbt von Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Weist alle Quellen des Ereignisses und dessen Informationen dem übergeordneten Element des Steuerelements zu. (Geerbt von Control) |
| RemovedControl(Control) |
Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls Auflistung des Control Objekts entfernt wurde. (Geerbt von Control) |
| Render(HtmlTextWriter) |
Rendert das Steuerelement an den angegebenen HTML-Writer. (Geerbt von WebControl) |
| RenderBeginTag(HtmlTextWriter) |
Rendert das HTML-Öffnungstag des Steuerelements an den angegebenen Writer. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| RenderChildren(HtmlTextWriter) |
Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements in ein bereitgestelltes HtmlTextWriter Objekt aus, das den inhalt schreibt, der auf dem Client gerendert werden soll. (Geerbt von Control) |
| RenderContents(HtmlTextWriter) |
Rendert den Inhalt des Steuerelements an den angegebenen Writer. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Gibt den Inhalt des Serversteuerelements mithilfe eines bereitgestellten Objekts an ein bereitgestelltes HtmlTextWriterControlAdapter Objekt aus. (Geerbt von Control) |
| RenderControl(HtmlTextWriter) |
Gibt Den Inhalt des Serversteuerelements an ein bereitgestelltes HtmlTextWriter Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, wenn die Ablaufverfolgung aktiviert ist. (Geerbt von Control) |
| RenderEndTag(HtmlTextWriter) |
Rendert das HTML-Schließen-Tag des Steuerelements in den angegebenen Writer. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| ResolveAdapter() |
Ruft den Steuerelementadapter ab, der für das Rendern des angegebenen Steuerelements verantwortlich ist. (Geerbt von Control) |
| ResolveClientUrl(String) |
Ruft eine URL ab, die vom Browser verwendet werden kann. (Geerbt von Control) |
| ResolveUrl(String) |
Wandelt eine URL in eine URL um, die auf dem anfordernden Client verwendet werden kann. (Geerbt von Control) |
| SaveControlState() |
Speichert alle Änderungen des Serversteuerelementstatus, die seit dem Zeitpunkt der Zurückpostung der Seite auf dem Server aufgetreten sind. (Geerbt von Control) |
| SaveViewState() |
Speichert jeden Zustand, der geändert wurde, nachdem die TrackViewState() Methode aufgerufen wurde. (Geerbt von WebControl) |
| SetDesignModeState(IDictionary) |
Legt Entwurfszeitdaten für ein Steuerelement fest. (Geerbt von Control) |
| SetRenderMethodDelegate(RenderMethod) |
Weist einen Ereignishandlerdelegat zu, um das Serversteuerelement und dessen Inhalt in seinem übergeordneten Steuerelement zu rendern. (Geerbt von Control) |
| SetTraceData(Object, Object, Object) |
Legt Ablaufverfolgungsdaten für die Entwurfszeitablaufverfolgung von Renderingdaten mithilfe des ablaufverfolgungsobjekts, des Ablaufverfolgungsdatenschlüssels und des Ablaufverfolgungsdatenwerts fest. (Geerbt von Control) |
| SetTraceData(Object, Object) |
Legt Ablaufverfolgungsdaten für die Entwurfszeitablaufverfolgung von Renderingdaten mithilfe des Ablaufverfolgungsdatenschlüssels und des Ablaufverfolgungsdatenwerts fest. (Geerbt von Control) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| TrackViewState() |
Bewirkt, dass das Steuerelement Änderungen am Ansichtszustand nachverfolgt, sodass sie in der Eigenschaft des ViewState Objekts gespeichert werden können. (Geerbt von WebControl) |
Ereignisse
| Name | Beschreibung |
|---|---|
| DataBinding |
Tritt auf, wenn das Serversteuerelement eine Bindung an eine Datenquelle ausführt. (Geerbt von Control) |
| Disposed |
Tritt auf, wenn ein Serversteuerelement aus dem Arbeitsspeicher freigegeben wird. Dies ist die letzte Phase des Lebenszyklus des Serversteuerelements, wenn eine ASP.NET Seite angefordert wird. (Geerbt von Control) |
| Init |
Tritt auf, wenn das Serversteuerelement initialisiert wird, was der erste Schritt im Lebenszyklus ist. (Geerbt von Control) |
| Load |
Tritt auf, wenn das Serversteuerelement in das Page Objekt geladen wird. (Geerbt von Control) |
| PreRender |
Tritt ein, nachdem das Control Objekt geladen wurde, aber vor dem Rendern. (Geerbt von Control) |
| Unload |
Tritt auf, wenn das Serversteuerelement aus dem Arbeitsspeicher entladen wird. (Geerbt von Control) |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| IAttributeAccessor.GetAttribute(String) |
Ruft ein Attribut des Websteuerelements mit dem angegebenen Namen ab. (Geerbt von WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Legt ein Attribut des Websteuerelements auf den angegebenen Namen und Wert fest. (Geerbt von WebControl) |
| IControlBuilderAccessor.ControlBuilder |
Eine Beschreibung dieses Mitglieds finden Sie unter ControlBuilder. (Geerbt von Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Eine Beschreibung dieses Mitglieds finden Sie unter GetDesignModeState(). (Geerbt von Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Eine Beschreibung dieses Mitglieds finden Sie unter SetDesignModeState(IDictionary). (Geerbt von Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Eine Beschreibung dieses Mitglieds finden Sie unter SetOwnerControl(Control). (Geerbt von Control) |
| IControlDesignerAccessor.UserData |
Eine Beschreibung dieses Mitglieds finden Sie unter UserData. (Geerbt von Control) |
| IDataBindingsAccessor.DataBindings |
Eine Beschreibung dieses Mitglieds finden Sie unter DataBindings. (Geerbt von Control) |
| IDataBindingsAccessor.HasDataBindings |
Eine Beschreibung dieses Mitglieds finden Sie unter HasDataBindings. (Geerbt von Control) |
| IDataItemContainer.DataItem |
Eine Beschreibung dieses Mitglieds finden Sie unter DataItem. |
| IDataItemContainer.DataItemIndex |
Eine Beschreibung dieses Mitglieds finden Sie unter DataItemIndex. |
| IDataItemContainer.DisplayIndex |
Eine Beschreibung dieses Mitglieds finden Sie unter DisplayIndex. |
| IExpressionsAccessor.Expressions |
Eine Beschreibung dieses Mitglieds finden Sie unter Expressions. (Geerbt von Control) |
| IExpressionsAccessor.HasExpressions |
Eine Beschreibung dieses Mitglieds finden Sie unter HasExpressions. (Geerbt von Control) |
| IParserAccessor.AddParsedSubObject(Object) |
Eine Beschreibung dieses Mitglieds finden Sie unter AddParsedSubObject(Object). (Geerbt von Control) |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Aktiviert das Dynamische Datenverhalten für das angegebene Datensteuerelement. |
| EnableDynamicData(INamingContainer, Type, Object) |
Aktiviert das Dynamische Datenverhalten für das angegebene Datensteuerelement. |
| EnableDynamicData(INamingContainer, Type) |
Aktiviert das Dynamische Datenverhalten für das angegebene Datensteuerelement. |
| FindDataSourceControl(Control) |
Gibt die Datenquelle zurück, die dem Datensteuerelement für das angegebene Steuerelement zugeordnet ist. |
| FindFieldTemplate(Control, String) |
Gibt die Feldvorlage für die angegebene Spalte im Benennungscontainer des angegebenen Steuerelements zurück. |
| FindMetaTable(Control) |
Gibt das metatable -Objekt für das enthaltende Datensteuerelement zurück. |
| GetDefaultValues(INamingContainer) |
Ruft die Auflistung der Standardwerte für das angegebene Datensteuerelement ab. |
| GetMetaTable(INamingContainer) |
Ruft die Tabellenmetadaten für das angegebene Datensteuerelement ab. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Legt die Tabellenmetadaten und die Standardwertzuordnung für das angegebene Datensteuerelement fest. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Legt die Tabellenmetadaten und die Standardwertzuordnung für das angegebene Datensteuerelement fest. |
| SetMetaTable(INamingContainer, MetaTable) |
Legt die Tabellenmetadaten für das angegebene Datensteuerelement fest. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Bestimmt, ob Tabellenmetadaten verfügbar sind. |
