GridViewRow Classe

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Représente une ligne individuelle dans un GridView contrôle.

public ref class GridViewRow : System::Web::UI::WebControls::TableRow, System::Web::UI::IDataItemContainer

public class GridViewRow : System.Web.UI.WebControls.TableRow, System.Web.UI.IDataItemContainer

type GridViewRow = class
    inherit TableRow
    interface IDataItemContainer
    interface INamingContainer

Public Class GridViewRow
Inherits TableRow
Implements IDataItemContainer

Héritage: Object

Control

WebControl

TableRow
GridViewRow

Implémente: IDataItemContainer INamingContainer

Exemples

L’exemple suivant montre comment utiliser un GridViewRow objet pour récupérer une valeur de champ à partir d’une cellule du GridView contrôle, puis afficher la valeur sur la page.


<%@ 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>

L’exemple suivant montre comment utiliser un GridViewRow objet pour récupérer un TextBox contrôle déclaré dans le modèle d’élément de modification d’une TemplateField colonne de champ. La valeur de la zone de texte est ensuite passée à un SqlDataSource contrôle pour la mise à jour dans la source de données.

Important

Cet exemple contient une zone de texte qui accepte l’entrée utilisateur, qui est une menace de sécurité potentielle. Par défaut, ASP.NET pages web valident que l’entrée utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des exploits de script.

<%@ 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>

Remarques

La GridViewRow classe est utilisée pour représenter une ligne individuelle dans un GridView contrôle. Chaque ligne du GridView contrôle a un type de ligne désigné à l’aide de l’énumération DataControlRowType . Le tableau suivant répertorie les différents types de lignes.

Type de ligne	Description
`DataRow`	Ligne de données dans le GridView contrôle.
`EmptyDataRow`	Ligne vide dans le GridView contrôle. La ligne vide s’affiche lorsque le GridView contrôle n’a pas d’enregistrements à afficher et que le GridView.EmptyDataTemplate modèle n’est pas `null`.
`Footer`	Ligne du pied de page dans le GridView contrôle.
`Header`	Ligne d’en-tête dans le GridView contrôle.
`Pager`	Ligne de pagineur dans le GridView contrôle.
`Separator`	Ligne de séparation dans le GridView contrôle.

Pour déterminer le type de ligne d’un GridViewRow objet, utilisez la RowType propriété. Un GridViewRow objet a également un état associé à celui-ci. L’état peut être une combinaison au niveau du bit des valeurs dans le tableau suivant.

Valeur d’état	Description
`Alternate`	L’objet GridViewRow est une autre ligne dans le GridView contrôle.
`Edit`	L’objet GridViewRow est en mode édition.
`Normal`	L’objet GridViewRow est dans son état normal (par défaut).
`Selected`	L’objet GridViewRow est sélectionné.

Pour déterminer l’état d’un GridViewRow objet, utilisez la RowState propriété.

Le GridView contrôle stocke toutes ses lignes de données dans la Rows collection. Pour déterminer l’index d’un GridViewRow objet dans la Rows collection, utilisez la RowIndex propriété.

Vous pouvez accéder aux propriétés de l’objet de données sous-jacent lié à l’objet GridViewRow à l’aide de la DataItem propriété.

Note

La DataItem propriété est disponible uniquement pendant et après l’événement RowDataBound d’un GridView contrôle.

Pour déterminer l’index de l’objet de données dans la source de données sous-jacente, utilisez la DataItemIndex propriété.

Vous pouvez accéder aux cellules individuelles de l’objet GridViewRow à l’aide de la Cells propriété. Si une cellule contient d’autres contrôles, vous pouvez récupérer un contrôle à partir de la cellule à l’aide de la Controls collection de la cellule. Vous pouvez également utiliser la FindControl méthode de la cellule pour rechercher le contrôle, si le contrôle a une ID valeur spécifiée.

Pour récupérer une valeur de champ à partir d’une colonne de champ ou d’une BoundField colonne de champ générée automatiquement, utilisez la Text propriété de la cellule. Pour récupérer une valeur de champ à partir d’autres types de colonnes de champ où la valeur de champ est liée à un contrôle, commencez par récupérer le contrôle à partir de la cellule appropriée, puis accédez à la propriété appropriée du contrôle.

Note

Il est possible d’utiliser une expression de liaison de données directement dans une TemplateField colonne de champ sans lier la valeur à une propriété d’un contrôle. Dans ce cas, la valeur du champ est automatiquement placée dans un DataBoundLiteralControl contrôle. Pour récupérer la valeur du champ, vous devez d’abord récupérer le DataBoundLiteralControl contrôle à partir de la cellule appropriée, puis utiliser sa Text propriété.

Pour obtenir la liste des valeurs de propriété initiales d’une instance de GridViewRow, consultez le GridViewRow constructeur.

Constructeurs

Nom	Description
GridViewRow(Int32, Int32, DataControlRowType, DataControlRowState)	Initialise une nouvelle instance de la classe GridViewRow.

Propriétés

Nom	Description
AccessKey	Obtient ou définit la clé d’accès qui vous permet d’accéder rapidement au contrôle serveur Web. (Hérité de WebControl)
Adapter	Obtient l’adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control)
AppRelativeTemplateSourceDirectory	Obtient ou définit le répertoire virtuel relatif à l’application du ou UserControl de l’objet Page qui contient ce contrôle. (Hérité de Control)
Attributes	Obtient la collection d’attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas aux propriétés du contrôle. (Hérité de WebControl)
BackColor	Obtient ou définit la couleur d’arrière-plan du contrôle serveur Web. (Hérité de WebControl)
BindingContainer	Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control)
BorderColor	Obtient ou définit la couleur de bordure du contrôle Web. (Hérité de WebControl)
BorderStyle	Obtient ou définit le style de bordure du contrôle serveur Web. (Hérité de WebControl)
BorderWidth	Obtient ou définit la largeur de bordure du contrôle serveur Web. (Hérité de WebControl)
Cells	Obtient une collection d’objets TableCell qui représentent les cellules d’une ligne dans un Table contrôle. (Hérité de TableRow)
ChildControlsCreated	Obtient une valeur qui indique si les contrôles enfants du contrôle serveur ont été créés. (Hérité de Control)
ClientID	Obtient l’ID de contrôle pour le balisage HTML généré par ASP.NET. (Hérité de Control)
ClientIDMode	Obtient ou définit l’algorithme utilisé pour générer la valeur de la ClientID propriété. (Hérité de Control)
ClientIDSeparator	Obtient une valeur de caractère représentant le caractère séparateur utilisé dans la ClientID propriété. (Hérité de Control)
Context	Obtient l’objet HttpContext associé au contrôle serveur pour la requête Web actuelle. (Hérité de Control)
Controls	Obtient un ControlCollection objet qui représente les contrôles enfants d’un contrôle serveur spécifié dans la hiérarchie de l’interface utilisateur. (Hérité de Control)
ControlStyle	Obtient le style du contrôle serveur Web. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
ControlStyleCreated	Obtient une valeur indiquant si un Style objet a été créé pour la ControlStyle propriété. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
CssClass	Obtient ou définit la classe Feuille de style en cascade (CSS) rendue par le contrôle serveur Web sur le client. (Hérité de WebControl)
DataItem	Obtient l’objet de données sous-jacent auquel l’objet GridViewRow est lié.
DataItemContainer	Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataItemContainernoms implémente . (Hérité de Control)
DataItemIndex	Obtient l’index du DataItem sous-jacent DataSet.
DataKeysContainer	Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataKeysControlnoms implémente . (Hérité de Control)
DesignMode	Obtient une valeur indiquant si un contrôle est utilisé sur une surface de conception. (Hérité de Control)
Enabled	Obtient ou définit une valeur indiquant si le contrôle serveur Web est activé. (Hérité de WebControl)
EnableTheming	Obtient ou définit une valeur indiquant si les thèmes s’appliquent à ce contrôle. (Hérité de WebControl)
EnableViewState	Obtient ou définit une valeur indiquant si le contrôle serveur conserve son état d’affichage et l’état d’affichage des contrôles enfants qu’il contient, au client demandeur. (Hérité de Control)
Events	Obtient une liste de délégués de gestionnaire d’événements pour le contrôle. Cette propriété est en lecture seule. (Hérité de Control)
Font	Obtient les propriétés de police associées au contrôle serveur Web. (Hérité de WebControl)
ForeColor	Obtient ou définit la couleur de premier plan (généralement la couleur du texte) du contrôle serveur Web. (Hérité de WebControl)
HasAttributes	Obtient une valeur indiquant si le contrôle a des attributs définis. (Hérité de WebControl)
HasChildViewState	Obtient une valeur indiquant si les contrôles enfants du contrôle serveur actuel ont des paramètres d’état d’affichage enregistrés. (Hérité de Control)
Height	Obtient ou définit la hauteur du contrôle serveur Web. (Hérité de WebControl)
HorizontalAlign	Obtient ou définit l’alignement horizontal du contenu dans la ligne. (Hérité de TableRow)
ID	Obtient ou définit l’identificateur programmatique affecté au contrôle serveur. (Hérité de Control)
IdSeparator	Obtient le caractère utilisé pour séparer les identificateurs de contrôle. (Hérité de Control)
IsChildControlStateCleared	Obtient une valeur indiquant si les contrôles contenus dans ce contrôle ont un état de contrôle. (Hérité de Control)
IsEnabled	Obtient une valeur indiquant si le contrôle est activé. (Hérité de WebControl)
IsTrackingViewState	Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d’affichage. (Hérité de Control)
IsViewStateEnabled	Obtient une valeur indiquant si l’état d’affichage est activé pour ce contrôle. (Hérité de Control)
LoadViewStateByID	Obtient une valeur indiquant si le contrôle participe au chargement de son état d’affichage ID au lieu de l’index. (Hérité de Control)
NamingContainer	Obtient une référence au conteneur d’affectation de noms du contrôle serveur, qui crée un espace de noms unique pour la différenciation entre les contrôles serveur avec la même ID valeur de propriété. (Hérité de Control)
Page	Obtient une référence à l’instance Page qui contient le contrôle serveur. (Hérité de Control)
Parent	Obtient une référence au contrôle parent du contrôle serveur dans la hiérarchie des contrôles de page. (Hérité de Control)
RenderingCompatibility	Obtient une valeur qui spécifie la version ASP.NET avec laquelle le code HTML rendu est compatible. (Hérité de Control)
RowIndex	Obtient l’index de l’objet GridViewRow dans la Rows collection d’un GridView contrôle.
RowState	Obtient l’état de l’objet GridViewRow .
RowType	Obtient le type de ligne de l’objet GridViewRow .
Site	Obtient des informations sur le conteneur qui héberge le contrôle actuel lors du rendu sur une surface de conception. (Hérité de Control)
SkinID	Obtient ou définit la peau à appliquer au contrôle. (Hérité de WebControl)
Style	Obtient une collection d’attributs de texte qui seront rendus en tant qu’attribut de style sur la balise externe du contrôle serveur Web. (Hérité de WebControl)
SupportsDisabledAttribute	Obtient une valeur qui indique si le contrôle doit définir l’attribut `disabled` de l’élément HTML rendu sur « disabled » lorsque la propriété du IsEnabled contrôle est `false`. (Hérité de TableRow)
TabIndex	Obtient ou définit l’index de tabulation du contrôle serveur Web. (Hérité de WebControl)
TableSection	Obtient ou définit l’emplacement d’un TableRow objet dans un Table contrôle. (Hérité de TableRow)
TagKey	Obtient la HtmlTextWriterTag valeur qui correspond à ce contrôle de serveur Web. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
TagName	Obtient le nom de la balise de contrôle. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
TemplateControl	Obtient ou définit une référence au modèle qui contient ce contrôle. (Hérité de Control)
TemplateSourceDirectory	Obtient le répertoire virtuel du Page UserControl ou qui contient le contrôle serveur actuel. (Hérité de Control)
ToolTip	Obtient ou définit le texte affiché lorsque le pointeur de la souris pointe sur le contrôle serveur Web. (Hérité de WebControl)
UniqueID	Obtient l’identificateur unique qualifié hiérarchiquement pour le contrôle serveur. (Hérité de Control)
ValidateRequestMode	Obtient ou définit une valeur qui indique si le contrôle vérifie l’entrée du client à partir du navigateur pour obtenir des valeurs potentiellement dangereuses. (Hérité de Control)
VerticalAlign	Obtient ou définit l’alignement vertical du contenu dans la ligne. (Hérité de TableRow)
ViewState	Obtient un dictionnaire d’informations d’état qui vous permet d’enregistrer et de restaurer l’état d’affichage d’un contrôle serveur sur plusieurs requêtes pour la même page. (Hérité de Control)
ViewStateIgnoresCase	Obtient une valeur qui indique si l’objet ne respecte pas la StateBag casse. (Hérité de Control)
ViewStateMode	Obtient ou définit le mode d’état d’affichage de ce contrôle. (Hérité de Control)
Visible	Obtient ou définit une valeur qui indique si un contrôle serveur est rendu en tant qu’interface utilisateur sur la page. (Hérité de Control)
Width	Obtient ou définit la largeur du contrôle serveur Web. (Hérité de WebControl)

Méthodes

Nom	Description
AddAttributesToRender(HtmlTextWriter)	Ajoute des attributs et des styles HTML qui doivent être rendus dans le fichier spécifié HtmlTextWriterTag. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
AddedControl(Control, Int32)	Appelé après l’ajout d’un contrôle enfant à la Controls collection de l’objet Control . (Hérité de Control)
AddParsedSubObject(Object)	Avertit le contrôle serveur qu’un élément, XML ou HTML, a été analysé et ajoute l’élément à l’objet du ControlCollection contrôle serveur. (Hérité de Control)
ApplyStyle(Style)	Copie tous les éléments non vides du style spécifié dans le contrôle Web, en remplaçant les éléments de style existants du contrôle. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
ApplyStyleSheetSkin(Page)	Applique les propriétés de style définies dans la feuille de style de page au contrôle. (Hérité de Control)
BeginRenderTracing(TextWriter, Object)	Commence le suivi au moment du design des données de rendu. (Hérité de Control)
BuildProfileTree(String, Boolean)	Collecte des informations sur le contrôle serveur et le remet à la Trace propriété à afficher lorsque le suivi est activé pour la page. (Hérité de Control)
ClearCachedClientID()	Définit la valeur mise en ClientID cache sur `null`. (Hérité de Control)
ClearChildControlState()	Supprime les informations d’état du contrôle pour les contrôles enfants du contrôle serveur. (Hérité de Control)
ClearChildState()	Supprime les informations d’état d’affichage et d’état de contrôle pour tous les contrôles enfants du contrôle serveur. (Hérité de Control)
ClearChildViewState()	Supprime les informations d’état d’affichage de tous les contrôles enfants du contrôle serveur. (Hérité de Control)
ClearEffectiveClientIDMode()	Définit la ClientIDMode propriété de l’instance de contrôle actuelle et de tous les contrôles enfants sur Inherit. (Hérité de Control)
CopyBaseAttributes(WebControl)	Copie les propriétés non encapsulées par l’objet Style du contrôle serveur Web spécifié vers le contrôle serveur Web à partir duquel cette méthode est appelée. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
CreateChildControls()	Appelé par l’infrastructure de page ASP.NET pour notifier les contrôles serveur qui utilisent l’implémentation basée sur la composition pour créer les contrôles enfants qu’ils contiennent en préparation de la publication ou du rendu. (Hérité de Control)
CreateControlCollection()	Crée un ControlCollection objet pour le TableRow contrôle. (Hérité de TableRow)
CreateControlStyle()	Crée un TableItemStyle objet pour le TableRow contrôle. (Hérité de TableRow)
DataBind()	Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants. (Hérité de Control)
DataBind(Boolean)	Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants avec une option pour déclencher l’événement DataBinding . (Hérité de Control)
DataBindChildren()	Lie une source de données aux contrôles enfants du contrôle serveur. (Hérité de Control)
Dispose()	Permet à un contrôle de serveur d’effectuer le nettoyage final avant de libérer de la mémoire. (Hérité de Control)
EndRenderTracing(TextWriter, Object)	Met fin au suivi au moment du design des données de rendu. (Hérité de Control)
EnsureChildControls()	Détermine si le contrôle serveur contient des contrôles enfants. Si ce n’est pas le cas, il crée des contrôles enfants. (Hérité de Control)
EnsureID()	Crée un identificateur pour les contrôles qui n’ont pas d’identificateur affecté. (Hérité de Control)
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
FindControl(String, Int32)	Recherche dans le conteneur d’affectation de noms actuel un contrôle serveur avec l’entier spécifié `id` et spécifié dans le `pathOffset` paramètre, ce qui facilite la recherche. Vous ne devez pas remplacer cette version de la FindControl méthode. (Hérité de Control)
FindControl(String)	Recherche le conteneur d’affectation de noms actuel pour un contrôle serveur avec le paramètre spécifié `id` . (Hérité de Control)
Focus()	Définit le focus d’entrée sur un contrôle. (Hérité de Control)
GetDesignModeState()	Obtient les données au moment du design pour un contrôle. (Hérité de Control)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetRouteUrl(Object)	Obtient l’URL qui correspond à un ensemble de paramètres de routage. (Hérité de Control)
GetRouteUrl(RouteValueDictionary)	Obtient l’URL qui correspond à un ensemble de paramètres de routage. (Hérité de Control)
GetRouteUrl(String, Object)	Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et à un nom d’itinéraire. (Hérité de Control)
GetRouteUrl(String, RouteValueDictionary)	Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et à un nom d’itinéraire. (Hérité de Control)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
GetUniqueIDRelativeTo(Control)	Retourne la partie préfixée de la UniqueID propriété du contrôle spécifié. (Hérité de Control)
HasControls()	Détermine si le contrôle serveur contient des contrôles enfants. (Hérité de Control)
HasEvents()	Retourne une valeur indiquant si les événements sont inscrits pour le contrôle ou les contrôles enfants. (Hérité de Control)
IsLiteralContent()	Détermine si le contrôle serveur contient uniquement du contenu littéral. (Hérité de Control)
LoadControlState(Object)	Restaure les informations d’état du contrôle à partir d’une demande de page précédente qui a été enregistrée par la SaveControlState() méthode. (Hérité de Control)
LoadViewState(Object)	Restaure les informations d’état d’affichage à partir d’une requête précédente enregistrée avec la SaveViewState() méthode. (Hérité de WebControl)
MapPathSecure(String)	Récupère le chemin d’accès physique auquel un chemin virtuel, absolu ou relatif, est mappé. (Hérité de Control)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
MergeStyle(Style)	Copie tous les éléments non vides du style spécifié dans le contrôle Web, mais n’écrasera aucun élément de style existant du contrôle. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
OnBubbleEvent(Object, EventArgs)	Détermine s’il faut transmettre un événement à la hiérarchie de contrôle serveur ASP.NET de la page.
OnDataBinding(EventArgs)	Déclenche l’événement DataBinding. (Hérité de Control)
OnInit(EventArgs)	Déclenche l’événement Init. (Hérité de Control)
OnLoad(EventArgs)	Déclenche l’événement Load. (Hérité de Control)
OnPreRender(EventArgs)	Déclenche l’événement PreRender. (Hérité de Control)
OnUnload(EventArgs)	Déclenche l’événement Unload. (Hérité de Control)
OpenFile(String)	Obtient un Stream élément utilisé pour lire un fichier. (Hérité de Control)
RaiseBubbleEvent(Object, EventArgs)	Affecte toutes les sources de l’événement et ses informations au parent du contrôle. (Hérité de Control)
RemovedControl(Control)	Appelé après la suppression d’un contrôle enfant de la Controls collection de l’objet Control . (Hérité de Control)
Render(HtmlTextWriter)	Restitue le contrôle au writer HTML spécifié. (Hérité de WebControl)
RenderBeginTag(HtmlTextWriter)	Restitue la balise d’ouverture HTML du contrôle au writer spécifié. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
RenderChildren(HtmlTextWriter)	Génère le contenu des enfants d’un contrôle serveur dans un objet fourni HtmlTextWriter , qui écrit le contenu à restituer sur le client. (Hérité de Control)
RenderContents(HtmlTextWriter)	Restitue le contenu du contrôle au writer spécifié. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
RenderControl(HtmlTextWriter, ControlAdapter)	Génère le contenu du contrôle serveur sur un objet fourni HtmlTextWriter à l’aide d’un objet fourni ControlAdapter . (Hérité de Control)
RenderControl(HtmlTextWriter)	Génère le contenu du contrôle serveur dans un objet fourni HtmlTextWriter et stocke les informations de suivi sur le contrôle si le suivi est activé. (Hérité de Control)
RenderEndTag(HtmlTextWriter)	Affiche la balise de fermeture HTML du contrôle dans l’enregistreur spécifié. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
ResolveAdapter()	Obtient l’adaptateur de contrôle responsable du rendu du contrôle spécifié. (Hérité de Control)
ResolveClientUrl(String)	Obtient une URL qui peut être utilisée par le navigateur. (Hérité de Control)
ResolveUrl(String)	Convertit une URL en une URL utilisable sur le client demandeur. (Hérité de Control)
SaveControlState()	Enregistre les modifications d’état de contrôle du serveur qui se sont produites depuis la publication de la page sur le serveur. (Hérité de Control)
SaveViewState()	Enregistre tout état modifié après l’appel de la TrackViewState() méthode. (Hérité de WebControl)
SetDesignModeState(IDictionary)	Définit les données au moment du design pour un contrôle. (Hérité de Control)
SetRenderMethodDelegate(RenderMethod)	Affecte un délégué de gestionnaire d’événements pour restituer le contrôle serveur et son contenu dans son contrôle parent. (Hérité de Control)
SetTraceData(Object, Object, Object)	Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de l’objet suivi, de la clé de données de trace et de la valeur des données de trace. (Hérité de Control)
SetTraceData(Object, Object)	Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de la clé de données de trace et de la valeur des données de trace. (Hérité de Control)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)
TrackViewState()	Provoque le suivi des modifications apportées à son état d’affichage afin qu’ils puissent être stockés dans la propriété de l’objet ViewState . (Hérité de WebControl)

Événements

Nom	Description
DataBinding	Se produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control)
Disposed	Se produit lorsqu’un contrôle serveur est libéré de la mémoire, qui est la dernière étape du cycle de vie du contrôle de serveur lorsqu’une page ASP.NET est demandée. (Hérité de Control)
Init	Se produit lorsque le contrôle serveur est initialisé, qui est la première étape de son cycle de vie. (Hérité de Control)
Load	Se produit lorsque le contrôle serveur est chargé dans l’objet Page . (Hérité de Control)
PreRender	Se produit après le chargement de l’objet Control , mais avant le rendu. (Hérité de Control)
Unload	Se produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control)

Implémentations d’interfaces explicites

Nom	Description
IAttributeAccessor.GetAttribute(String)	Obtient un attribut du contrôle Web avec le nom spécifié. (Hérité de WebControl)
IAttributeAccessor.SetAttribute(String, String)	Définit un attribut du contrôle Web sur le nom et la valeur spécifiés. (Hérité de WebControl)
IControlBuilderAccessor.ControlBuilder	Pour obtenir une description de ce membre, consultez ControlBuilder. (Hérité de Control)
IControlDesignerAccessor.GetDesignModeState()	Pour obtenir une description de ce membre, consultez GetDesignModeState(). (Hérité de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Pour obtenir une description de ce membre, consultez SetDesignModeState(IDictionary). (Hérité de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Pour obtenir une description de ce membre, consultez SetOwnerControl(Control). (Hérité de Control)
IControlDesignerAccessor.UserData	Pour obtenir une description de ce membre, consultez UserData. (Hérité de Control)
IDataBindingsAccessor.DataBindings	Pour obtenir une description de ce membre, consultez DataBindings. (Hérité de Control)
IDataBindingsAccessor.HasDataBindings	Pour obtenir une description de ce membre, consultez HasDataBindings. (Hérité de Control)
IDataItemContainer.DataItem	Pour obtenir une description de ce membre, consultez DataItem.
IDataItemContainer.DataItemIndex	Pour obtenir une description de ce membre, consultez DataItemIndex.
IDataItemContainer.DisplayIndex	Pour obtenir une description de ce membre, consultez DisplayIndex.
IExpressionsAccessor.Expressions	Pour obtenir une description de ce membre, consultez Expressions. (Hérité de Control)
IExpressionsAccessor.HasExpressions	Pour obtenir une description de ce membre, consultez HasExpressions. (Hérité de Control)
IParserAccessor.AddParsedSubObject(Object)	Pour obtenir une description de ce membre, consultez AddParsedSubObject(Object). (Hérité de Control)

Méthodes d’extension

Nom	Description
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Active le comportement des données dynamiques pour le contrôle de données spécifié.
EnableDynamicData(INamingContainer, Type, Object)	Active le comportement des données dynamiques pour le contrôle de données spécifié.
EnableDynamicData(INamingContainer, Type)	Active le comportement des données dynamiques pour le contrôle de données spécifié.
FindDataSourceControl(Control)	Retourne la source de données associée au contrôle de données pour le contrôle spécifié.
FindFieldTemplate(Control, String)	Retourne le modèle de champ de la colonne spécifiée dans le conteneur d’affectation de noms du contrôle spécifié.
FindMetaTable(Control)	Retourne l’objet métatable pour le contrôle de données contenant.
GetDefaultValues(INamingContainer)	Obtient la collection des valeurs par défaut pour le contrôle de données spécifié.
GetMetaTable(INamingContainer)	Obtient les métadonnées de table pour le contrôle de données spécifié.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Définit les métadonnées de table et le mappage de valeurs par défaut pour le contrôle de données spécifié.
SetMetaTable(INamingContainer, MetaTable, Object)	Définit les métadonnées de table et le mappage de valeurs par défaut pour le contrôle de données spécifié.
SetMetaTable(INamingContainer, MetaTable)	Définit les métadonnées de table pour le contrôle de données spécifié.
TryGetMetaTable(INamingContainer, MetaTable)	Détermine si les métadonnées de table sont disponibles.

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?