Compartir vía

DetailsView.CaptionAlign Propiedad

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Obtiene o establece la posición horizontal o vertical del elemento de título HTML en un DetailsView control . Esta propiedad se proporciona para que el control sea más accesible para los usuarios de dispositivos de tecnología de asistencia.

public:
 virtual property System::Web::UI::WebControls::TableCaptionAlign CaptionAlign { System::Web::UI::WebControls::TableCaptionAlign get(); void set(System::Web::UI::WebControls::TableCaptionAlign value); };
public virtual System.Web.UI.WebControls.TableCaptionAlign CaptionAlign { get; set; }
member this.CaptionAlign : System.Web.UI.WebControls.TableCaptionAlign with get, set
Public Overridable Property CaptionAlign As TableCaptionAlign

Valor de propiedad

TableCaptionAlign

Uno de los TableCaptionAlign valores. El valor predeterminado es TableCaptionAlign.NotSet.

Excepciones

ArgumentOutOfRangeException

El valor especificado no es uno de los TableCaptionAlign valores de enumeración.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la CaptionAlign propiedad para especificar que el elemento de título HTML de un DetailsView control se debe representar en el lado izquierdo del control.


<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>DetailsView Caption and CaptionAlign Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView Caption and CaptionAlign Example</h3>
                
        <asp:detailsview id="CustomerDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogeneraterows="true"
          allowpaging="true"
          caption="Customer Details"
          captionalign="Left"  
          runat="server">
               
          <headerstyle backcolor="Navy"
            forecolor="White"/>
                    
        </asp:detailsview>
        
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the web.config file.                            -->
        <asp:SqlDataSource ID="DetailsViewSource" runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthWindConnectionString%>"
          InsertCommand="INSERT INTO [Customers]([CustomerID], 
            [CompanyName], [Address], [City], [PostalCode], [Country]) 
            VALUES (@CustomerID, @CompanyName, @Address, @City, 
            @PostalCode, @Country)"
          SelectCommand="Select [CustomerID], [CompanyName], 
            [Address], [City], [PostalCode], [Country] 
            From [Customers]">
        </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">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>DetailsView Caption and CaptionAlign Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView Caption and CaptionAlign Example</h3>
                
        <asp:detailsview id="CustomerDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogeneraterows="true"
          allowpaging="true"
          caption="Customer Details"
          captionalign="Left"  
          runat="server">
               
          <headerstyle backcolor="Navy"
            forecolor="White"/>
                    
        </asp:detailsview>
        
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the web.config file.                            -->
        <asp:SqlDataSource ID="DetailsViewSource" runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthWindConnectionString%>"
          InsertCommand="INSERT INTO [Customers]([CustomerID], 
            [CompanyName], [Address], [City], [PostalCode], [Country]) 
            VALUES (@CustomerID, @CompanyName, @Address, @City, 
            @PostalCode, @Country)"
          SelectCommand="Select [CustomerID], [CompanyName], 
            [Address], [City], [PostalCode], [Country] 
            From [Customers]">
        </asp:SqlDataSource>
    </form>
  </body>
</html>

Comentarios

Utilice la CaptionAlign propiedad para especificar la posición horizontal o vertical del elemento de título HTML en un DetailsView control . Esta propiedad se proporciona para que el control sea más accesible para los usuarios de dispositivos de tecnología de asistencia.

Esta propiedad se establece mediante uno de los TableCaptionAlign valores de enumeración. En la tabla siguiente se enumeran los valores posibles.

Importancia Descripción
TableCaptionAlign.Bottom El elemento caption se alinea con la parte inferior de la tabla.
TableCaptionAlign.Left El elemento caption se alinea con el lado izquierdo de la tabla.
TableCaptionAlign.NotSet No se ha establecido la alineación del elemento caption.
TableCaptionAlign.Right El elemento caption se alinea con el lado derecho de la tabla.
TableCaptionAlign.Top El elemento caption se alinea con la parte superior de la tabla.

La propiedad proporciona Caption compatibilidad adicional de accesibilidad para el DetailsView control. Utilice la Caption propiedad para especificar el texto que se va a representar en un elemento de título HTML en un DetailsView control .

El valor de CaptionAlign se almacena en estado de vista.

Se aplica a

Consulte también