ASP.NET Syntax   ASP.NET Syntax for Web Controls

---

Displays the values of a single record from a data source in a table, where each data row represents a field of the record. The DetailsView control allows you to edit, delete, and insert records.

Declarative Syntax

<asp:DetailsView
   AccessKey = "string"
   AllowPaging = "True | False"
   AutoGenerateDeleteButton = "True | False"
   AutoGenerateEditButton = "True | False"
   AutoGenerateInsertButton = "True | False"
   AutoGenerateRows = "True | False"
   BackColor = "color name | #dddddd"
   BackImageUrl = "uri"
   BorderColor = "color name | #dddddd"
   BorderStyle = "NotSet | None | Dotted | Dashed | Solid | Double | Groove |
      Ridge | Inset | Outset"
   BorderWidth = size
   Caption = "string"
   CaptionAlign = "NotSet | Top | Bottom | Left | Right"
   CellPadding = integer
   CellSpacing = integer
   CssClass = "string"
   DataKeyNames = "string"
   DataMember = "string"
   DataSource = "string"
   DataSourceID = "string"
   DefaultMode = "ReadOnly | Edit | Insert"
   EmptyDataText = "string"
   Enabled = "True | False"
   EnablePagingCallbacks = "True | False"
   EnableTheming = "True | False"
   EnableViewState = "True | False"
   Font-Bold = "True | False"
   Font-Italic = "True | False"
   Font-Names = "string"
   Font-Overline = "True | False"
   Font-Size = "string | Smaller | Larger | XX-Small | X-Small | Small |
      Medium | Large | X-Large | XX-Large"
   Font-Strikeout = "True | False"
   Font-Underline = "True | False"
   FooterText = "string"
   ForeColor = "color name | #dddddd"
   GridLines = "None | Horizontal | Vertical | Both"
   HeaderText = "string"
   Height = size
   HorizontalAlign = "NotSet | Left | Center | Right | Justify"
   ID = "string"
   OnDataBinding = "DataBinding event handler"
   OnDataBound = "DataBound event handler"
   OnDisposed = "Disposed event handler"
   OnInit = "Init event handler"
   OnItemCommand = "ItemCommand event handler"
   OnItemCreated = "ItemCreated event handler"
   OnItemDeleted = "ItemDeleted event handler"
   OnItemDeleting = "ItemDeleting event handler"
   OnItemInserted = "ItemInserted event handler"
   OnItemInserting = "ItemInserting event handler"
   OnItemUpdated = "ItemUpdated event handler"
   OnItemUpdating = "ItemUpdating event handler"
   OnLoad = "Load event handler"
   OnModeChanged = "ModeChanged event handler"
   OnModeChanging = "ModeChanging event handler"
   OnPageIndexChanged = "PageIndexChanged event handler"
   OnPageIndexChanging = "PageIndexChanging event handler"
   OnPreRender = "PreRender event handler"
   OnUnload = "Unload event handler"
   PageIndex = integer
   PagerSettings-FirstPageImageUrl = "uri"
   PagerSettings-FirstPageText = "string"
   PagerSettings-LastPageImageUrl = "uri"
   PagerSettings-LastPageText = "string"
   PagerSettings-Mode = "NextPrevious | Numeric | NextPreviousFirstLast |
      NumericFirstLast"
   PagerSettings-NextPageImageUrl = "uri"
   PagerSettings-NextPageText = "string"
   PagerSettings-PageButtonCount = integer
   PagerSettings-Position = "Bottom | Top | TopAndBottom"
   PagerSettings-PreviousPageImageUrl = "uri"
   PagerSettings-PreviousPageText = "string"
   PagerSettings-Visible = "True | False"
   runat = "server"
   SkinID = "string"
   Style = "string"
   TabIndex = integer
   ToolTip = "string"
   Visible = "True | False"
   Width = size
>
   <AlternatingRowStyle />
   <CommandRowStyle />
   <EditRowStyle />
   <EmptyDataRowStyle />
   <EmptyDataTemplate>
      <!-- child controls -->
   </EmptyDataTemplate>
   <FieldHeaderStyle />
   <Fields>
      <asp:BoundField
         AccessibleHeaderText = "string"
         ApplyFormatInEditMode = "True | False"
         ConvertEmptyStringToNull = "True | False"
         DataField = "string"
         DataFormatString = "string"
         FooterText = "string"
         HeaderImageUrl = "uri"
         HeaderText = "string"
         HtmlEncode = "True | False"
         InsertVisible = "True | False"
         NullDisplayText = "string"
         ReadOnly = "True | False"
         ShowHeader = "True | False"
         SortExpression = "string"
         Visible = "True | False"
      >
            <ControlStyle />
            <FooterStyle />
            <HeaderStyle />
            <ItemStyle />
      </asp:BoundField>
      <asp:ButtonField
         AccessibleHeaderText = "string"
         ButtonType = "Button | Image | Link"
         CausesValidation = "True | False"
         CommandName = "string"
         DataTextField = "string"
         DataTextFormatString = "string"
         FooterText = "string"
         HeaderImageUrl = "uri"
         HeaderText = "string"
         ImageUrl = "uri"
         InsertVisible = "True | False"
         ShowHeader = "True | False"
         SortExpression = "string"
         Text = "string"
         ValidationGroup = "string"
         Visible = "True | False"
      >
            <ControlStyle />
            <FooterStyle />
            <HeaderStyle />
            <ItemStyle />
      </asp:ButtonField>
      <asp:CheckBoxField
         AccessibleHeaderText = "string"
         DataField = "string"
         FooterText = "string"
         HeaderImageUrl = "uri"
         HeaderText = "string"
         InsertVisible = "True | False"
         ReadOnly = "True | False"
         ShowHeader = "True | False"
         SortExpression = "string"
         Text = "string"
         Visible = "True | False"
      >
            <ControlStyle />
            <FooterStyle />
            <HeaderStyle />
            <ItemStyle />
      </asp:CheckBoxField>
      <asp:CommandField
         AccessibleHeaderText = "string"
         ButtonType = "Button | Image | Link"
         CancelImageUrl = "uri"
         CancelText = "string"
         CausesValidation = "True | False"
         DeleteImageUrl = "uri"
         DeleteText = "string"
         EditImageUrl = "uri"
         EditText = "string"
         FooterText = "string"
         HeaderImageUrl = "uri"
         HeaderText = "string"
         InsertImageUrl = "uri"
         InsertText = "string"
         InsertVisible = "True | False"
         NewImageUrl = "uri"
         NewText = "string"
         SelectImageUrl = "uri"
         SelectText = "string"
         ShowCancelButton = "True | False"
         ShowDeleteButton = "True | False"
         ShowEditButton = "True | False"
         ShowHeader = "True | False"
         ShowInsertButton = "True | False"
         ShowSelectButton = "True | False"
         SortExpression = "string"
         UpdateImageUrl = "uri"
         UpdateText = "string"
         ValidationGroup = "string"
         Visible = "True | False"
      >
            <ControlStyle />
            <FooterStyle />
            <HeaderStyle />
            <ItemStyle />
      </asp:CommandField>
      <asp:HyperLinkField
         AccessibleHeaderText = "string"
         DataNavigateUrlFields = "string"
         DataNavigateUrlFormatString = "string"
         DataTextField = "string"
         DataTextFormatString = "string"
         FooterText = "string"
         HeaderImageUrl = "uri"
         HeaderText = "string"
         InsertVisible = "True | False"
         NavigateUrl = "uri"
         ShowHeader = "True | False"
         SortExpression = "string"
         Target = "string | _blank | _parent | _search | _self | _top"
         Text = "string"
         Visible = "True | False"
      >
            <ControlStyle />
            <FooterStyle />
            <HeaderStyle />
            <ItemStyle />
      </asp:HyperLinkField>
      <asp:ImageField
         AccessibleHeaderText = "string"
         AlternateText = "string"
         ConvertEmptyStringToNull = "True | False"
         DataAlternateTextField = "string"
         DataAlternateTextFormatString = "string"
         DataImageUrlField = "string"
         DataImageUrlFormatString = "string"
         FooterText = "string"
         HeaderImageUrl = "uri"
         HeaderText = "string"
         InsertVisible = "True | False"
         NullDisplayText = "string"
         NullImageUrl = "uri"
         ReadOnly = "True | False"
         ShowHeader = "True | False"
         SortExpression = "string"
         Visible = "True | False"
      >
            <ControlStyle />
            <FooterStyle />
            <HeaderStyle />
            <ItemStyle />
      </asp:ImageField>
      <asp:TemplateField
         AccessibleHeaderText = "string"
         ConvertEmptyStringToNull = "True | False"
         FooterText = "string"
         HeaderImageUrl = "uri"
         HeaderText = "string"
         InsertVisible = "True | False"
         ShowHeader = "True | False"
         SortExpression = "string"
         Visible = "True | False"
      >
            <ControlStyle />
            <FooterStyle />
            <HeaderStyle />
            <ItemStyle />

         <AlternatingItemTemplate>
            <!-- child controls -->
         </AlternatingItemTemplate>
         <EditItemTemplate>
            <!-- child controls -->
         </EditItemTemplate>
         <FooterTemplate>
            <!-- child controls -->
         </FooterTemplate>
         <HeaderTemplate>
            <!-- child controls -->
         </HeaderTemplate>
         <InsertItemTemplate>
            <!-- child controls -->
         </InsertItemTemplate>
         <ItemTemplate>
            <!-- child controls -->
         </ItemTemplate>
      </asp:TemplateField>
   </Fields>
   <FooterStyle />
   <FooterTemplate>
      <!-- child controls -->
   </FooterTemplate>
   <HeaderStyle />
   <HeaderTemplate>
      <!-- child controls -->
   </HeaderTemplate>
   <InsertRowStyle />
   <PagerSettings
      FirstPageImageUrl = "uri"
      FirstPageText = "string"
      LastPageImageUrl = "uri"
      LastPageText = "string"
      Mode = "NextPrevious | Numeric | NextPreviousFirstLast | 
         NumericFirstLast"
      NextPageImageUrl = "uri"
      NextPageText = "string"
      OnPropertyChanged = "PropertyChanged event handler"
      PageButtonCount = integer
      Position = "Bottom | Top | TopAndBottom"
      PreviousPageImageUrl = "uri"
      PreviousPageText = "string"
      Visible = "True | False"
   />

   <PagerStyle />
   <PagerTemplate>
      <!-- child controls -->
   </PagerTemplate>
   <RowStyle />

</asp:DetailsView>

For information on the individual members of this class, see DetailsView in the class library.

The DetailsView control renders the contents of a single record from a data source into a table, where each field of the record is displayed in a row of the table. It can be used in combination with a GridView control for master-detail scenarios.

The following example demonstrates how to use a DetailsView control in combination with a GridView control for a simple master-detail scenario. It displays the details of an item that is selected in the GridView control.

For more information on using the DetailsView control, see DetailsView Web Server Control.

<table cellpadding=5>
<tr>
   <td>
   <asp:gridview id="customersGrid" runat="server"
      cellpadding=3
      datasourceid="customers"
      datakeynames = "CustomerID"
      autogeneratecolumns=false>
      <columns>
         <asp:commandfield showselectbutton />

         <asp:boundfield datafield = "ContactName" headertext = "ContactName" />

         <asp:boundfield datafield = "CompanyName" headertext = "CompanyName" />
      </columns>
   </asp:gridview>
   </td>

   <td valign = "top">
   <asp:detailsview id="customerDetails" runat="server"
      width=300 cellpadding=3
      datasourceid="details"
      datakeynames = "CustomerID">
   </asp:detailsview>
   </td>
</tr>
</table>

<asp:sqldatasource id="details" runat="server"
   connectionstring = "<%$ ConnectionStrings:aspnet %>"
   SelectCommand = "SELECT * FROM Customers WHERE CustomerID = @CustomerID">

   <selectparameters>
      <asp:controlparameter controlid="customersGrid" name = "CustomerID"
         propertyname = "SelectedValue"
         type = "String" />
   </selectparameters>
</asp:sqldatasource>

<asp:sqldatasource id="customers" runat="server"
   connectionstring = "<%$ ConnectionStrings:aspnet %>"
   SelectCommand = "SELECT CompanyName, ContactName, CustomerID FROM Customers" />

 Show me 

DetailsView Class   DetailsView Web Server Control