GridView Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Exibe os valores de uma fonte de dados em uma tabela, em que cada coluna representa um campo e cada linha representa um registro. O controle GridView permite selecionar, classificar e editar esses itens.
public ref class GridView : System::Web::UI::WebControls::CompositeDataBoundControl, System::Web::UI::ICallbackEventHandler, System::Web::UI::IPostBackEventHandler, System::Web::UI::WebControls::ICallbackContainer, System::Web::UI::WebControls::IPersistedSelector, System::Web::UI::WebControls::IPostBackContainer
public ref class GridView : System::Web::UI::WebControls::CompositeDataBoundControl, System::Web::UI::ICallbackEventHandler, System::Web::UI::IDataKeysControl, System::Web::UI::IPostBackEventHandler, System::Web::UI::WebControls::ICallbackContainer, System::Web::UI::WebControls::IDataBoundListControl, System::Web::UI::WebControls::IFieldControl, System::Web::UI::WebControls::IPersistedSelector, System::Web::UI::WebControls::IPostBackContainer
[System.Web.UI.ControlValueProperty("SelectedValue")]
public class GridView : System.Web.UI.WebControls.CompositeDataBoundControl, System.Web.UI.ICallbackEventHandler, System.Web.UI.IPostBackEventHandler, System.Web.UI.WebControls.ICallbackContainer, System.Web.UI.WebControls.IPersistedSelector, System.Web.UI.WebControls.IPostBackContainer
[System.Web.UI.ControlValueProperty("SelectedValue")]
public class GridView : System.Web.UI.WebControls.CompositeDataBoundControl, System.Web.UI.ICallbackEventHandler, System.Web.UI.IDataKeysControl, System.Web.UI.IPostBackEventHandler, System.Web.UI.WebControls.ICallbackContainer, System.Web.UI.WebControls.IDataBoundListControl, System.Web.UI.WebControls.IFieldControl, System.Web.UI.WebControls.IPersistedSelector, System.Web.UI.WebControls.IPostBackContainer
[<System.Web.UI.ControlValueProperty("SelectedValue")>]
type GridView = class
inherit CompositeDataBoundControl
interface IPostBackContainer
interface IPostBackEventHandler
interface ICallbackContainer
interface ICallbackEventHandler
interface IPersistedSelector
[<System.Web.UI.ControlValueProperty("SelectedValue")>]
type GridView = class
inherit CompositeDataBoundControl
interface IPostBackContainer
interface IPostBackEventHandler
interface ICallbackContainer
interface ICallbackEventHandler
interface IPersistedSelector
interface IDataKeysControl
interface IDataBoundListControl
interface IDataBoundControl
interface IFieldControl
Public Class GridView
Inherits CompositeDataBoundControl
Implements ICallbackContainer, ICallbackEventHandler, IPersistedSelector, IPostBackContainer, IPostBackEventHandler
Public Class GridView
Inherits CompositeDataBoundControl
Implements ICallbackContainer, ICallbackEventHandler, IDataBoundListControl, IDataKeysControl, IFieldControl, IPersistedSelector, IPostBackContainer, IPostBackEventHandler
- Herança
- Atributos
- Implementações
Exemplos
Um projeto de site do Visual Studio com código-fonte está disponível para acompanhar este tópico: Download.
O exemplo a seguir demonstra como usar o GridView controle para exibir os valores da tabela Customers do banco de dados de exemplo AdventureWorksLT no Microsoft SQL Server. Os valores são recuperados usando um SqlDataSource controle .
<asp:sqldatasource id="CustomersSource"
selectcommand="SELECT CustomerID, CompanyName, FirstName, LastName FROM SalesLT.Customer"
connectionstring="<%$ ConnectionStrings:AWLTConnectionString %>"
runat="server"/>
<asp:gridview id="CustomersGridView"
datasourceid="CustomersSource"
autogeneratecolumns="False"
emptydatatext="No data available."
allowpaging="True"
runat="server" DataKeyNames="CustomerID">
<Columns>
<asp:BoundField DataField="CustomerID" HeaderText="CustomerID"
InsertVisible="False" ReadOnly="True" SortExpression="CustomerID" />
<asp:BoundField DataField="CompanyName" HeaderText="CompanyName"
SortExpression="CompanyName" />
<asp:BoundField DataField="FirstName" HeaderText="FirstName"
SortExpression="FirstName" />
<asp:BoundField DataField="LastName" HeaderText="LastName"
SortExpression="LastName" />
</Columns>
</asp:gridview>
<asp:sqldatasource id="CustomersSource"
selectcommand="SELECT CustomerID, CompanyName, FirstName, LastName FROM SalesLT.Customer"
connectionstring="<%$ ConnectionStrings:AWLTConnectionString %>"
runat="server"/>
<asp:gridview id="CustomersGridView"
datasourceid="CustomersSource"
autogeneratecolumns="False"
emptydatatext="No data available."
allowpaging="True"
runat="server" DataKeyNames="CustomerID">
<Columns>
<asp:BoundField DataField="CustomerID" HeaderText="CustomerID"
InsertVisible="False" ReadOnly="True" SortExpression="CustomerID" />
<asp:BoundField DataField="CompanyName" HeaderText="CompanyName"
SortExpression="CompanyName" />
<asp:BoundField DataField="FirstName" HeaderText="FirstName"
SortExpression="FirstName" />
<asp:BoundField DataField="LastName" HeaderText="LastName"
SortExpression="LastName" />
</Columns>
</asp:gridview>
O exemplo a seguir demonstra como usar o GridView controle e um LinqDataSource controle para que você possa editar registros.
<asp:LinqDataSource ID="LinqDataSource1" runat="server"
ContextTypeName="AdventureWorksLTDataClassesDataContext"
EnableDelete="True" EnableInsert="True" EnableUpdate="True"
TableName="SalesOrderDetails">
</asp:LinqDataSource>
<asp:GridView ID="GridView1" runat="server"
AutoGenerateColumns="False"
DataKeyNames="SalesOrderID,SalesOrderDetailID"
DataSourceID="LinqDataSource1">
<Columns>
<asp:CommandField ShowDeleteButton="True"
ShowEditButton="True" />
<asp:BoundField DataField="SalesOrderID"
HeaderText="SalesOrderID" ReadOnly="True"
SortExpression="SalesOrderID" />
<asp:BoundField DataField="SalesOrderDetailID"
HeaderText="SalesOrderDetailID" InsertVisible="False"
ReadOnly="True" SortExpression="SalesOrderDetailID" />
<asp:BoundField DataField="OrderQty"
HeaderText="OrderQty" SortExpression="OrderQty" />
<asp:BoundField DataField="ProductID"
HeaderText="ProductID" SortExpression="ProductID" />
<asp:BoundField DataField="UnitPrice"
HeaderText="UnitPrice" SortExpression="UnitPrice" />
<asp:BoundField DataField="ModifiedDate"
HeaderText="ModifiedDate" SortExpression="ModifiedDate" />
</Columns>
</asp:GridView>
<asp:LinqDataSource ID="LinqDataSource1" runat="server"
ContextTypeName="AdventureWorksLTDataClassesDataContext"
EnableDelete="True" EnableInsert="True" EnableUpdate="True"
TableName="SalesOrderDetails">
</asp:LinqDataSource>
<asp:GridView ID="GridView1" runat="server"
AutoGenerateColumns="False"
DataKeyNames="SalesOrderID,SalesOrderDetailID"
DataSourceID="LinqDataSource1">
<Columns>
<asp:CommandField ShowDeleteButton="True"
ShowEditButton="True" />
<asp:BoundField DataField="SalesOrderID"
HeaderText="SalesOrderID" ReadOnly="True"
SortExpression="SalesOrderID" />
<asp:BoundField DataField="SalesOrderDetailID"
HeaderText="SalesOrderDetailID" InsertVisible="False"
ReadOnly="True" SortExpression="SalesOrderDetailID" />
<asp:BoundField DataField="OrderQty"
HeaderText="OrderQty" SortExpression="OrderQty" />
<asp:BoundField DataField="ProductID"
HeaderText="ProductID" SortExpression="ProductID" />
<asp:BoundField DataField="UnitPrice"
HeaderText="UnitPrice" SortExpression="UnitPrice" />
<asp:BoundField DataField="ModifiedDate"
HeaderText="ModifiedDate" SortExpression="ModifiedDate" />
</Columns>
</asp:GridView>
Para obter um exemplo que demonstra como acessar valores em células, consulte GridViewRow.
Comentários
Neste tópico:
Introdução
O GridView controle é usado para exibir os valores de uma fonte de dados em uma tabela. Cada coluna representa um campo, enquanto cada linha representa um registro. O GridView controle dá suporte aos seguintes recursos:
Associação a controles de fonte de dados, como SqlDataSource.
Recursos de classificação internos.
Funcionalidades internas de atualização e exclusão.
Recursos de paginação internos.
Recursos internos de seleção de linha.
Acesso programático ao GridView modelo de objeto para definir dinamicamente propriedades, manipular eventos e assim por diante.
Vários campos de chave.
Vários campos de dados para as colunas de hiperlink.
Aparência personalizável por meio de temas e estilos.
Para saber mais sobre os outros controles associados a dados que estão disponíveis no ASP.NET, consulte Controles de servidor Web associados a dados.
Observação
Se você estiver familiarizado com o DataGrid controle do .NET Framework versão 1.0, o GridView controle será o sucessor do DataGrid controle.
Campos de coluna
Cada coluna no GridView controle é representada por um DataControlField objeto . Por padrão, a AutoGenerateColumns propriedade é definida como true
, que cria um AutoGeneratedField objeto para cada campo na fonte de dados. Cada campo é renderizado como uma coluna no GridView controle na ordem em que cada campo aparece na fonte de dados.
Você também pode controlar manualmente quais campos de coluna aparecem no GridView controle definindo a AutoGenerateColumns propriedade como false
e definindo sua própria coleção de campos de coluna. Diferentes tipos de campo de coluna determinam o comportamento das colunas no controle . A tabela a seguir lista os diferentes tipos de campo de coluna que podem ser usados.
Tipo de campo de coluna | Descrição |
---|---|
BoundField | Exibe o valor de um campo em uma fonte de dados. Esse é o tipo de coluna padrão do GridView controle. |
ButtonField | Exibe um botão de comando para cada item no GridView controle . Isso permite que você crie uma coluna de controles de botão personalizados, como o botão Adicionar ou Remover. |
CheckBoxField | Exibe uma caixa de seleção para cada item no GridView controle. Esse tipo de campo de coluna é comumente usado para exibir campos com um valor booliano. |
CommandField | Exibe botões de comando predefinidos para executar operações de seleção, edição ou exclusão. |
HyperLinkField | Exibe o valor de um campo em uma fonte de dados como um hiperlink. Esse tipo de campo de coluna permite que você associe um segundo campo à URL do hiperlink. |
ImageField | Exibe uma imagem para cada item no GridView controle . |
TemplateField | Exibe o conteúdo definido pelo usuário para cada item no GridView controle de acordo com um modelo especificado. Esse tipo de campo de coluna permite que você crie um campo de coluna personalizado. |
Para definir uma coleção de campos de coluna declarativamente, primeiro adicione marcas de abertura e fechamento <Columns>
entre as marcas de abertura e fechamento do GridView controle. Em seguida, liste os campos de coluna que você deseja incluir entre as marcas de abertura e fechamento <Columns>
. As colunas especificadas são adicionadas à Columns coleção na ordem listada. A Columns coleção armazena todos os campos de coluna no controle e permite que você gerencie programaticamente os campos de coluna no GridView controle .
Campos de coluna declarados explicitamente podem ser exibidos em combinação com campos de coluna gerados automaticamente. Quando ambos são usados, os campos de coluna declarados explicitamente são renderizados primeiro, seguidos pelos campos de coluna gerados automaticamente.
Observação
Os campos de coluna gerados automaticamente não são adicionados à Columns coleção.
Associação a dados
O GridView controle pode ser associado a um controle de fonte de dados (como o SqlDataSource controle ou ObjectDataSource controle) ou a qualquer coleção de fonte de dados que implemente a System.Collections.IEnumerable interface, como System.Data.DataView, System.Collections.ArrayList, System.Collections.Generic.List<T>ou outros tipos de coleção. Use um dos seguintes métodos para associar o GridView controle ao tipo de fonte de dados apropriado:
Para associar a um controle de fonte de dados, defina a DataSourceID propriedade do GridView controle como o ID valor do controle da fonte de dados. O GridView controle é associado automaticamente ao controle da fonte de dados especificado e pode aproveitar os recursos do controle da fonte de dados para executar classificação, atualização, exclusão e paginação. Esse é o método preferencial para associar a dados.
Para associar a uma fonte de dados que implementa a System.Collections.IEnumerable interface , defina programaticamente a DataSource propriedade do GridView controle como a fonte de dados e, em seguida, chame o DataBind método . Ao usar esse método, o GridView controle não fornece funcionalidades internas de classificação, atualização, exclusão e paginação. Você precisa fornecer essa funcionalidade usando o evento apropriado.
Para obter mais informações sobre a associação de dados, consulte ASP.NET Mapa de Conteúdo de Acesso a Dados.
Observação
Esse controle pode ser usado para exibir a entrada do usuário, que pode incluir script de cliente mal-intencionado. Verifique as informações enviadas de um cliente para script executável, instruções SQL ou outro código antes de exibi-lo em seu aplicativo. Sempre que possível, é altamente recomendável que os valores sejam codificados em HTML antes de serem exibidos nesse controle (a BoundField classe codifica valores HTML por padrão). ASP.NET fornece um recurso de validação de solicitação de entrada para bloquear script e HTML na entrada do usuário. Controles de servidor de validação também são fornecidos para avaliar a entrada do usuário. Para obter mais informações, consulte Introdução aos controles de validação.
Operações de dados
O GridView controle fornece muitos recursos internos que permitem ao usuário classificar, atualizar, excluir, selecionar e paginar itens no controle. Quando o GridView controle está associado a um controle de fonte de dados, o GridView controle pode aproveitar os recursos do controle da fonte de dados e fornecer funcionalidades automáticas de classificação, atualização e exclusão.
Observação
O GridView controle pode fornecer suporte para classificação, atualização e exclusão com outros tipos de fontes de dados. No entanto, você precisará fornecer um manipulador de eventos apropriado com a implementação para essas operações.
A classificação permite que o usuário classifique os itens no controle em GridView relação a uma coluna específica clicando no cabeçalho da coluna. Para habilitar a classificação, defina a AllowSorting propriedade como true
.
As funcionalidades automáticas de atualização, exclusão e seleção são habilitadas quando um botão em um ButtonField campo de coluna ou TemplateField , com um nome de comando "Editar", "Excluir" e "Selecionar", respectivamente, é clicado. O GridView controle pode adicionar automaticamente um CommandField campo de coluna com um botão Editar, Excluir ou Selecionar se a AutoGenerateEditButtonpropriedade , AutoGenerateDeleteButtonou AutoGenerateSelectButton estiver definida true
como , respectivamente.
Observação
Não há suporte direto para a inserção de registros na fonte de dados no GridView controle . No entanto, é possível inserir registros usando o GridView controle em conjunto com o DetailsView
controle ou FormView
. Para obter mais informações, consulte DetailsView ou FormView, respectivamente.
Em vez de exibir todos os registros na fonte de dados ao mesmo tempo, o GridView controle pode dividir automaticamente os registros em páginas. Para habilitar a paginação, defina a AllowPaging propriedade como true
.
Observação
O GridView controle é recriado no postback com base nas informações armazenadas em ViewState. Se o GridView controle incluir um TemplateField ou um CommandField com a CausesValidation propriedade definida true
como , a EnableViewState propriedade também deverá ser definida como true
para garantir que operações de dados simultâneas, como atualizações e exclusões, se apliquem à linha apropriada.
Personalizando a interface do usuário
Você pode personalizar a aparência do GridView controle definindo as propriedades de estilo para as diferentes partes do controle. A tabela a seguir lista as diferentes propriedades de estilo.
Propriedade Style | Descrição |
---|---|
AlternatingRowStyle | As configurações de estilo para as linhas de dados alternadas no GridView controle . Quando essa propriedade é definida, as linhas de dados são exibidas alternando entre as RowStyle configurações e as AlternatingRowStyle configurações. |
EditRowStyle | As configurações de estilo da linha que está sendo editada no GridView controle. |
EmptyDataRowStyle | As configurações de estilo da linha de dados vazia exibidas GridView no controle quando a fonte de dados não contém nenhum registro. |
FooterStyle | As configurações de estilo para a linha de rodapé do GridView controle. |
HeaderStyle | As configurações de estilo para a linha de cabeçalho do GridView controle. |
PagerStyle | As configurações de estilo para a linha pager do GridView controle. |
RowStyle | As configurações de estilo para as linhas de dados no GridView controle . Quando a AlternatingRowStyle propriedade também é definida, as linhas de dados são exibidas alternando entre as RowStyle configurações e as AlternatingRowStyle configurações. |
SelectedRowStyle | As configurações de estilo para a linha selecionada no GridView controle . |
SortedAscendingCellStyle | A configuração de estilo para a coluna de dados pela qual os dados são classificados no GridView controle . Quando esse estilo é definido, o estilo (por exemplo, coluna realçada) é aplicado às células quando os dados são classificados em ordem crescente. |
SortedAscendingHeaderStyle | A configuração de estilo para a coluna de dados pela qual os dados são classificados no GridView controle . Quando esse estilo é definido, uma seta indicando que os dados são classificados em ordem crescente é colocada no cabeçalho do GridView controle quando os dados são classificados em ordem crescente. |
SortedDescendingCellStyle | A configuração de estilo para a coluna de dados pela qual os dados são classificados no GridView controle . Quando esse estilo é definido, o estilo (por exemplo, coluna realçada) é aplicado às células quando os dados são classificados em ordem decrescente. |
SortedDescendingHeaderStyle | A configuração de estilo para a coluna de dados pela qual os dados são classificados no GridView controle . Quando esse estilo é definido, uma seta apontando para baixo é colocada no cabeçalho do GridView quando os dados são classificados em ordem decrescente. |
Você também pode mostrar ou ocultar diferentes partes do controle. A tabela a seguir lista as propriedades que controlam quais partes são mostradas ou ocultas.
Propriedade | Descrição |
---|---|
ShowFooter | Mostra ou oculta a seção de rodapé do GridView controle. |
ShowHeader | Mostra ou oculta a seção de cabeçalho do GridView controle. |
Eventos
O GridView controle fornece vários eventos nos quais você pode programar. Isso permite que você execute uma rotina personalizada sempre que ocorrer um evento. A tabela a seguir lista os eventos compatíveis com o GridView controle .
Evento | Descrição |
---|---|
PageIndexChanged | Ocorre quando um dos botões de paginação é acionado, mas após o controle GridView manipular a operação de paginação. Esse evento geralmente é usado quando você precisa executar uma tarefa depois que o usuário navega para uma página diferente no controle. |
PageIndexChanging | Ocorre quando um dos botões de paginação é acionado, mas antes de o controle GridView manipular a operação de paginação. Esse evento geralmente é usado para cancelar a operação de paginação. |
RowCancelingEdit | Ocorre quando o botão Cancelar de uma linha é clicado, mas antes que o controle saia do GridView modo de edição. Esse evento geralmente é usado para interromper a operação de cancelamento. |
RowCommand | Ocorre quando um usuário clica em um botão no controle GridView. Esse evento geralmente é usado para executar uma tarefa quando um botão é clicado no controle . |
RowCreated | Ocorre quando uma nova linha é criada no GridView controle . Esse evento geralmente é usado para modificar o conteúdo de uma linha quando a linha é criada. |
RowDataBound | Ocorre quando uma linha de dados é associada a dados no GridView controle . Esse evento geralmente é usado para modificar o conteúdo de uma linha quando a linha está associada aos dados. |
RowDeleted | Ocorre quando o botão Excluir de uma linha é clicado, mas depois que o GridView controle exclui o registro da fonte de dados. Esse evento geralmente é usado para verificar os resultados da operação de exclusão. |
RowDeleting | Ocorre quando o botão Excluir de uma linha é clicado, mas antes que o GridView controle exclua o registro da fonte de dados. Esse evento geralmente é usado para cancelar a operação de exclusão. |
RowEditing | Ocorre quando o botão Editar de uma linha é clicado, mas antes de o controle GridView entrar em modo de edição. Esse evento geralmente é usado para cancelar a operação de edição. |
RowUpdated | Ocorre quando o botão Atualizar de uma linha é acionado, mas depois de o controle GridView atualizar a linha. Esse evento geralmente é usado para verificar os resultados da operação de atualização. |
RowUpdating | Ocorre quando o botão Atualizar de uma linha é acionado, mas antes do controle GridView atualizar a linha. Esse evento geralmente é usado para cancelar a operação de atualização. |
SelectedIndexChanged | Ocorre quando o botão de seleção de uma linha é clicado, mas após o controle GridView manipular a operação de seleção. Esse evento geralmente é usado para executar uma tarefa depois que uma linha é selecionada no controle . |
SelectedIndexChanging | Ocorre quando o botão de seleção de uma linha é clicado, mas antes do controle GridView manipular a operação de seleção. Esse evento geralmente é usado para cancelar a operação de seleção. |
Sorted | Ocorre quando se clica no hiperlink para classificar uma coluna, mas depois de o controle GridView manipular a operação de classificação. Esse evento é comumente usado para executar uma tarefa depois que o usuário clica em um hiperlink para classificar uma coluna. |
Sorting | Ocorre quando o hiperlink para classificar uma coluna é clicado, mas antes de o controle GridView manipular a operação de classificação. Esse evento geralmente é usado para cancelar a operação de classificação ou para executar uma rotina de classificação personalizada. |
Acessibilidade
Para obter informações sobre como configurar esse controle para que ele gere marcação em conformidade com os padrões de acessibilidade, consulte Acessibilidade no Visual Studio e ASP.NET e controles de ASP.NET e acessibilidade.
Sintaxe declarativa
<asp:GridView
AccessKey="string"
AllowPaging="True|False"
AllowSorting="True|False"
AutoGenerateColumns="True|False"
AutoGenerateDeleteButton="True|False"
AutoGenerateEditButton="True|False"
AutoGenerateSelectButton="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"
EditIndex="integer"
EmptyDataText="string"
Enabled="True|False"
EnableSortingAndPagingCallbacks="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"
ForeColor="color name|#dddddd"
GridLines="None|Horizontal|Vertical|Both"
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"
OnLoad="Load event handler"
OnPageIndexChanged="PageIndexChanged event handler"
OnPageIndexChanging="PageIndexChanging event handler"
OnPreRender="PreRender event handler"
OnRowCancelingEdit="RowCancelingEdit event handler"
OnRowCommand="RowCommand event handler"
OnRowCreated="RowCreated event handler"
OnRowDataBound="RowDataBound event handler"
OnRowDeleted="RowDeleted event handler"
OnRowDeleting="RowDeleting event handler"
OnRowEditing="RowEditing event handler"
OnRowUpdated="RowUpdated event handler"
OnRowUpdating="RowUpdating event handler"
OnSelectedIndexChanged="SelectedIndexChanged event handler"
OnSelectedIndexChanging="SelectedIndexChanging event handler"
OnSorted="Sorted event handler"
OnSorting="Sorting 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"
PageSize="integer"
RowHeaderColumn="string"
runat="server"
SelectedIndex="integer"
ShowFooter="True|False"
ShowHeader="True|False"
SkinID="string"
Style="string"
TabIndex="integer"
ToolTip="string"
UseAccessibleHeader="True|False"
Visible="True|False"
Width="size"
>
<AlternatingRowStyle />
<Columns>
<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:DynamicField
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"
ShowHeader="True|False"
UIHint="string"
Visible="True|False"
>
<ControlStyle />
<FooterStyle />
<HeaderStyle />
<ItemStyle />
</asp:DynamicField>
<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>
</Columns>
<EditRowStyle />
<EmptyDataRowStyle />
<EmptyDataTemplate>
<!-- child controls -->
</EmptyDataTemplate>
<FooterStyle />
<HeaderStyle />
<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 />
<SelectedRowStyle />
</asp:GridView>
Construtores
GridView() |
Inicializa uma nova instância da classe GridView. |
Propriedades
AccessKey |
Obtém ou define a tecla de acesso que permite navegar rapidamente para o controle do servidor Web. (Herdado de WebControl) |
Adapter |
Obtém o adaptador específico de navegador para o controle. (Herdado de Control) |
AllowCustomPaging |
Obtém ou define um valor que indica se a paginação personalizada está habilitada. |
AllowPaging |
Obtém ou define um valor que indica se o recurso de paginação está habilitado. |
AllowSorting |
Obtém ou define um valor que indica se o recurso de classificação está habilitado. |
AlternatingRowStyle |
Obtém uma referência para o objeto TableItemStyle que permite que você defina a aparência de linhas de dados alternadas em um controle GridView. |
AppRelativeTemplateSourceDirectory |
Obtém ou define o diretório virtual relativo de aplicativo do objeto Page ou UserControl que contém este controle. (Herdado de Control) |
Attributes |
Obtém a coleção de atributos arbitrários (somente para renderização) que não correspondem às propriedades do controle. (Herdado de WebControl) |
AutoGenerateColumns |
Obtém ou define um valor que indica se os campos associados são criados automaticamente para cada campo na fonte de dados. |
AutoGenerateDeleteButton |
Obtém ou define um valor que indica se uma coluna do campo CommandField com um botão Excluir para cada linha de dados é adicionada automaticamente a um controle GridView. |
AutoGenerateEditButton |
Obtém ou define um valor que indica se uma coluna do campo CommandField com um botão Editar para cada linha de dados é adicionada automaticamente a um controle GridView. |
AutoGenerateSelectButton |
Obtém ou define um valor que indica se uma coluna de campo CommandField com um botão Selecionar para cada linha de dados é adicionada automaticamente a um controle GridView. |
BackColor |
Obtém ou define a cor da tela de fundo do controle do servidor Web. (Herdado de WebControl) |
BackImageUrl |
Obtém ou define a URL para uma imagem a ser exibida na tela de fundo de um controle GridView. |
BindingContainer |
Obtém o controle que contém a vinculação de dados desse controle. (Herdado de Control) |
BorderColor |
Obtém ou define a cor da borda do controle Web. (Herdado de WebControl) |
BorderStyle |
Obtém ou define o estilo de borda do controle de servidor Web. (Herdado de WebControl) |
BorderWidth |
Obtém ou define a largura da borda do controle de servidor Web. (Herdado de WebControl) |
BottomPagerRow |
Obtém um objeto GridViewRow que representa a linha de paginação inferior em um controle GridView. |
Caption |
Obtém ou define o texto a ser renderizado em um elemento de legenda HTML em um controle GridView. Esta propriedade é fornecida para tornar o controle mais acessível para usuários de dispositivos de tecnologia adaptativa. |
CaptionAlign |
Obtém ou define a posição horizontal ou vertical de um elemento de legenda HTML em um controle GridView. Esta propriedade é fornecida para tornar o controle mais acessível para usuários de dispositivos de tecnologia adaptativa. |
CellPadding |
Obtém ou define a quantidade de espaço entre o conteúdo e a borda de uma célula. |
CellSpacing |
Obtém ou define a quantidade de espaço entre células. |
ChildControlsCreated |
Obtém um valor que indica se os controles filho do controle de servidor foram criados. (Herdado de Control) |
ClientID |
Obtém a ID de controle de marcação HTML gerada pelo ASP.NET. (Herdado de Control) |
ClientIDMode |
Obtém ou define o algoritmo usado para gerar o valor da propriedade ClientID. (Herdado de Control) |
ClientIDRowSuffix |
Obtém ou define os nomes dos campos de dados cujos valores são acrescentados ao valor da propriedade ClientID para identificar exclusivamente cada instância de um controle com limite de dados. |
ClientIDRowSuffixDataKeys |
Obtém os valores de dados que são usados para identificar exclusivamente cada instância de um controle associado a dados quando o ASP.NET gera o valor ClientID. |
ClientIDSeparator |
Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID. (Herdado de Control) |
Columns |
Obtém uma coleção de objetos DataControlField que representam os campos de coluna em um controle GridView. |
ColumnsGenerator |
Obtém ou define o controle que gera automaticamente as colunas para um controle GridView que usa recursos de Dados Dinâmicos do ASP.NET. |
Context |
Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual. (Herdado de Control) |
Controls |
Obtém uma coleção dos controles filho no controle com limite de dados de composição. (Herdado de CompositeDataBoundControl) |
ControlStyle |
Obtém o estilo de um controle de servidor Web. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl) |
ControlStyleCreated |
Obtém um valor que indica se um objeto Style foi criado para a propriedade ControlStyle. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl) |
CssClass |
Obtém ou define a classe CSS (Folha de Estilos em Cascata) renderizada pelo controle do servidor Web no cliente. (Herdado de WebControl) |
DataItemContainer |
Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataItemContainer. (Herdado de Control) |
DataKeyNames |
Obtém ou define uma matriz que contém os nomes dos campos de chave primária para os itens exibidos em um controle GridView. |
DataKeys |
Obtém uma coleção de objetos DataKey que representam o valor da chave de dados de cada linha em um controle GridView. |
DataKeysContainer |
Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataKeysControl. (Herdado de Control) |
DataMember |
Obtém ou define o nome da lista de dados ao qual o controle com limite de dados está associado, nos casos em que a fonte de dados contém mais de uma lista distinta de itens de dados. (Herdado de DataBoundControl) |
DataSource |
Obtém ou define o objeto do qual o controle com limite de dados recupera sua lista de itens de dados. (Herdado de BaseDataBoundControl) |
DataSourceID |
Obtém ou define a ID do controle do qual o controle associado a dados recupera sua lista de itens de dados. (Herdado de DataBoundControl) |
DataSourceObject |
Obtém um objeto que implementa a interface IDataSource, que fornece acesso ao conteúdo de dados do objeto. (Herdado de DataBoundControl) |
DeleteMethod |
Obtém ou define o nome do método a ser chamado para excluir dados. |
DeleteMethod |
Obtém ou define o nome do método a ser chamado para excluir dados. (Herdado de CompositeDataBoundControl) |
DesignMode |
Obtém um valor que indica se um controle está sendo usado em uma superfície de design. (Herdado de Control) |
EditIndex |
Obtém ou define o índice da linha para edição. |
EditRowStyle |
Obtém uma referência ao objeto TableItemStyle que permite definir a aparência da linha selecionada para edição em um controle GridView. |
EmptyDataRowStyle |
Obtém uma referência para o objeto TableItemStyle que permite que você defina a aparência da linha de dados vazia renderizada quando um controle GridView é associado a uma fonte de dados que não contém nenhum registro. |
EmptyDataTemplate |
Obtém ou define o conteúdo definido pelo usuário para a linha de dados vazia renderizada quando um controle GridView é associado a uma fonte de dados que não contém registros. |
EmptyDataText |
Obtém ou define o texto a ser exibido na linha de dados vazia renderizada quando um controle GridView é associado a uma fonte de dados que não contém registros. |
Enabled |
Obtém ou define um valor que indica se o controle do servidor Web está habilitado. (Herdado de WebControl) |
EnableModelValidation |
Obtém ou define um valor que indica se um controle de validador vai manipular exceções que ocorrem durante as operações de inserção ou atualização. |
EnablePersistedSelection |
Obtém ou define um valor que indica se a seleção de uma linha é baseada em valores de chave de dados ou no índice. |
EnableSortingAndPagingCallbacks |
Obtém ou define um valor que indica se os retornos de chamada do lado do cliente são usados para as operações de classificação e paginação. |
EnableTheming |
Obtém ou define um valor que indica se os temas se aplicam a esse controle. (Herdado de WebControl) |
EnableViewState |
Obtém ou define um valor que indica se o controle de servidor persiste seu estado de exibição e o estado de exibição de quaisquer controles filho que ele contém, para o cliente solicitante. (Herdado de Control) |
Events |
Obtém uma lista de delegados de manipulador de eventos para o controle. Esta propriedade é somente para leitura. (Herdado de Control) |
Font |
Obtém as propriedades de fonte associadas ao controle do servidor Web. (Herdado de WebControl) |
FooterRow |
Obtém um objeto GridViewRow que representa a linha de rodapé em um controle GridView. |
FooterStyle |
Obtém uma referência ao objeto TableItemStyle que permite definir a aparência da linha do rodapé em um controle GridView. |
ForeColor |
Obtém ou define a cor de primeiro plano (normalmente a cor do texto) do controle de servidor Web. (Herdado de WebControl) |
GridLines |
Obtém ou define o estilo das linhas de grade para um controle GridView. |
HasAttributes |
Obtém um valor que indica se o controle tem atributos definidos. (Herdado de WebControl) |
HasChildViewState |
Obtém um valor que indica se os controles filho do controle de servidor atual têm alguma configuração de estado de exibição salva. (Herdado de Control) |
HeaderRow |
Obtém um objeto GridViewRow que representa a linha de cabeçalho em um controle GridView. |
HeaderStyle |
Obtém uma referência ao objeto TableItemStyle que permite definir a aparência da linhas do cabeçalho em um controle GridView. |
Height |
Obtém ou define a altura do controle do servidor Web. (Herdado de WebControl) |
HorizontalAlign |
Obtém ou define o alinhamento horizontal de um controle GridView na página. |
ID |
Obtém ou define o identificador programático atribuído ao controle de servidor. (Herdado de Control) |
IdSeparator |
Obtém o caractere usado para separar identificadores de controle. (Herdado de Control) |
Initialized |
Obtém um valor que indica se o controle associado a dados foi inicializado. (Herdado de BaseDataBoundControl) |
InsertMethod |
Obtém ou define o nome do método a ser chamado para inserir dados. (Herdado de CompositeDataBoundControl) |
IsBoundUsingDataSourceID |
Obtém um valor que indica se a propriedade DataSourceID foi definida. (Herdado de BaseDataBoundControl) |
IsChildControlStateCleared |
Obtém um valor que indica se os controles contidos dentro deste controle têm estado de controle. (Herdado de Control) |
IsDataBindingAutomatic |
Obtém um valor que indica se a associação de dados é automática. (Herdado de BaseDataBoundControl) |
IsEnabled |
Obtém um valor que indica se o controle está habilitado. (Herdado de WebControl) |
IsTrackingViewState |
Obtém um valor que indica se o controle de servidor está salvando alterações no estado de exibição. (Herdado de Control) |
IsUsingModelBinders |
Obtém um valor que indica se o model binding está em uso. (Herdado de CompositeDataBoundControl) |
IsViewStateEnabled |
Obtém um valor que indica se o estado de exibição está habilitado para esse controle. (Herdado de Control) |
ItemType |
Obtém ou define o nome do tipo de item de dados para vinculação de dados com rigidez de tipos. (Herdado de DataBoundControl) |
LoadViewStateByID |
Obtém um valor que indica se o controle participa do carregamento do estado de exibição por ID em vez do índice. (Herdado de Control) |
NamingContainer |
Obtém uma referência ao contêiner de nomenclatura do controle do servidor, que cria um namespace exclusivo para diferenciar entre os controles de servidor com o mesmo valor da propriedade ID. (Herdado de Control) |
Page |
Obtém uma referência para a instância Page que contém o controle de servidor. (Herdado de Control) |
PageCount |
Obtém o número de páginas necessárias para exibir os registros da fonte de dados em um controle GridView. |
PageIndex |
Obtém ou define o índice da página exibida no momento. |
PagerSettings |
Obtém uma referência ao objeto PagerSettings que permite definir as propriedades dos botões pager em um controle GridView. |
PagerStyle |
Obtém uma referência ao objeto TableItemStyle que permite definir a aparência da linha do pager em um controle GridView. |
PagerTemplate |
Obtém ou define o conteúdo personalizado para a linha do pager em um controle GridView. |
PageSize |
Obtém ou define o número de registros a serem exibidos em uma página em um controle GridView. |
Parent |
Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página. (Herdado de Control) |
RenderingCompatibility |
Obtém um valor que especifica a versão do ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control) |
RequiresDataBinding |
Obtém ou define um valor que indica se o método DataBind() deve ser cancelado. (Herdado de BaseDataBoundControl) |
RowHeaderColumn |
Obtém ou define o nome da coluna a ser usado como o cabeçalho de coluna para o controle GridView. Esta propriedade é fornecida para tornar o controle mais acessível para usuários de dispositivos de tecnologia adaptativa. |
Rows |
Obtém uma coleção de objetos GridViewRow que representam as linhas de dados em um controle GridView. |
RowStyle |
Obtém uma referência ao objeto TableItemStyle que permite definir a aparência das linhas de dados em um controle GridView. |
SelectArguments |
Obtém um objeto DataSourceSelectArguments que o controle associado a dados usa ao recuperar dados de um controle de fonte de dados. (Herdado de DataBoundControl) |
SelectedDataKey |
Obtém o objeto de DataKey que contém o valor de chave de dados para a linha selecionada em um controle do GridView. |
SelectedIndex |
Obtém ou define o índice da linha selecionada em um controle GridView. |
SelectedPersistedDataKey |
Obtém ou define o valor de chave de dados para o item selecionado persistente em um controle GridView. |
SelectedRow |
Obtém uma referência a um objeto GridViewRow que representa a linha selecionada no controle. |
SelectedRowStyle |
Obtém uma referência ao objeto TableItemStyle que permite definir a aparência da linha selecionada em um controle GridView. |
SelectedValue |
Obtém o valor da chave de dados da linha selecionada em um controle GridView. |
SelectMethod |
O nome do método a ser chamado para ler os dados. (Herdado de DataBoundControl) |
ShowFooter |
Obtém ou define um valor que indica se a linha de rodapé é exibida em um controle GridView. |
ShowHeader |
Obtém ou define um valor que indica se a linha de cabeçalho é exibida em um controle GridView. |
ShowHeaderWhenEmpty |
Obtém ou define um valor que indica se o cabeçalho de uma coluna no controle GridView fica visível quando a coluna não tiver dados. |
Site |
Obtém informações sobre o contêiner que hospeda o controle atual quando renderizados em uma superfície de design. (Herdado de Control) |
SkinID |
Obtém ou define a capa a ser aplicada ao controle. (Herdado de WebControl) |
SortDirection |
Obtém a direção de classificação da coluna sendo classificada. |
SortedAscendingCellStyle |
Obtém ou define o estilo CSS para uma coluna GridView quando a coluna é classificada em ordem crescente. |
SortedAscendingHeaderStyle |
Obtém ou define o estilo CSS para aplicar a um título de coluna GridView quando a coluna é classificada em ordem crescente. |
SortedDescendingCellStyle |
Obtém ou define o estilo de uma coluna GridView quando a coluna é classificada em ordem decrescente. |
SortedDescendingHeaderStyle |
Obtém ou define o estilo a ser aplicado a um título de coluna GridView quando a coluna é classificada em ordem descendente. |
SortExpression |
Obtém a expressão de classificação associada à coluna ou colunas sendo classificadas. |
Style |
Obtém uma coleção de atributos de texto que serão renderizados como um atributo de estilo na marca externa do controle de servidor Web. (Herdado de WebControl) |
SupportsDisabledAttribute |
Obtém um valor que indica se o controle deve definir o atributo |
TabIndex |
Obtém ou define o índice de tabulação do controle do servidor Web. (Herdado de WebControl) |
TagKey |
Obtém o valor HtmlTextWriterTag para o controle GridView. |
TagName |
Obtém o nome da marca de controle. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl) |
TemplateControl |
Obtém ou define uma referência ao modelo que contém este controle. (Herdado de Control) |
TemplateSourceDirectory |
Obtém o diretório virtual do Page ou UserControl que contém o controle do servidor atual. (Herdado de Control) |
ToolTip |
Obtém ou define o texto exibido quando o ponteiro do mouse passa sobre o controle de servidor Web. (Herdado de WebControl) |
TopPagerRow |
Obtém um objeto GridViewRow que representa a linha superior do pager em um controle GridView. |
UniqueID |
Obtém o identificador exclusivo, qualificado segundo a hierarquia, para o controle de servidor. (Herdado de Control) |
UpdateMethod |
Obtém ou define o nome do método a ser chamado para atualizar dados. |
UpdateMethod |
Obtém ou define o nome do método a ser chamado para atualizar dados. (Herdado de CompositeDataBoundControl) |
UseAccessibleHeader |
Obtém ou define um valor que indica se um controle de GridView renderiza seu cabeçalho em um formato acessível. Esta propriedade é fornecida para tornar o controle mais acessível para usuários de dispositivos de tecnologia adaptativa. |
ValidateRequestMode |
Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador para valores potencialmente perigosos. (Herdado de Control) |
ViewState |
Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um controle de servidor em várias solicitações para a mesma página. (Herdado de Control) |
ViewStateIgnoresCase |
Obtém um valor que indica se o objeto StateBag não diferencia maiúsculas de minúsculas. (Herdado de Control) |
ViewStateMode |
Obtém ou define o modo de estado de exibição deste controle. (Herdado de Control) |
VirtualItemCount |
Obtém ou define o número virtual de itens na fonte de dados a que o controle GridView está associado quando a paginação personalizada é usada. |
Visible |
Obtém ou define um valor que indica se um controle de servidor é renderizado como uma interface do usuário na página. (Herdado de Control) |
Width |
Obtém ou define a largura do controle de servidor Web. (Herdado de WebControl) |
Métodos
AddAttributesToRender(HtmlTextWriter) |
Adiciona atributos HTML e estilos que precisam ser renderizadas ao HtmlTextWriterTag especificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
AddedControl(Control, Int32) |
Chamado após um controle filho ser adicionado à coleção Controls do objeto Control. (Herdado de Control) |
AddParsedSubObject(Object) |
Notifica o controle de servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto ControlCollection do controle de servidor. (Herdado de Control) |
ApplyStyle(Style) |
Copia os elementos não vazios do estilo especificado para o controle da Web, substituindo os elementos de estilo existentes no controle. Esse método é usado principalmente por desenvolvedores de controles. (Herdado de WebControl) |
ApplyStyleSheetSkin(Page) |
Aplica as propriedades de estilo definidas na folha de estilos da página ao controle. (Herdado de Control) |
BeginRenderTracing(TextWriter, Object) |
Inicia o rastreamento de tempo de design de dados de renderização. (Herdado de Control) |
BuildProfileTree(String, Boolean) |
Reúne informações sobre o controle de servidor e as envia para a propriedade Trace para serem exibidas quando o rastreamento está habilitado para a página. (Herdado de Control) |
ClearCachedClientID() |
Define o valor ClientID armazenado em cache como |
ClearChildControlState() |
Exclui as informações de estado de controle para os controles filho do controle de servidor. (Herdado de Control) |
ClearChildState() |
Exclui as informações de estado de exibição e de estado de controle para todos os controles filho do controle de servidor. (Herdado de Control) |
ClearChildViewState() |
Exclui as informações de estado de exibição para todos os controles filho do controle de servidor. (Herdado de Control) |
ClearEffectiveClientIDMode() |
Define a propriedade ClientIDMode da instância de controle atual e de quaisquer controles filho para Inherit. (Herdado de Control) |
ConfirmInitState() |
Define o estado inicializado do controle associado a dados. (Herdado de BaseDataBoundControl) |
CopyBaseAttributes(WebControl) |
Copia as propriedades que não são encapsuladas pelo objeto Style de controle do servidor Web especificado ao controle de servidor Web do qual este método é chamado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
CreateAutoGeneratedColumn(AutoGeneratedFieldProperties) |
Obsoleto.
Cria um campo de coluna gerado automaticamente. |
CreateChildControls() |
Cria uma hierarquia de controle usada para renderizar um controle de composição associado a dados com base nos valores armazenados no estado de exibição. (Herdado de CompositeDataBoundControl) |
CreateChildControls(IEnumerable, Boolean) |
Cria a hierarquia de controles usada para renderizar o controle GridView usando a fonte de dados especificada. |
CreateChildTable() |
Cria uma nova tabela filho. |
CreateColumns(PagedDataSource, Boolean) |
Cria o conjunto de campos de coluna usados para criar a hierarquia de controles. |
CreateControlCollection() |
Cria um novo objeto ControlCollection para manter os controles filho (literal e servidor) do controle do servidor. (Herdado de Control) |
CreateControlStyle() |
Cria o estilo padrão do controle. |
CreateDataSourceSelectArguments() |
Cria o objeto DataSourceSelectArguments que contém os argumentos passados para a fonte de dados para processamento. |
CreateRow(Int32, Int32, DataControlRowType, DataControlRowState) |
Cria uma linha no controle GridView. |
DataBind() |
Associa a fonte de dados ao controle GridView. Esse método não pode ser herdado. |
DataBind(Boolean) |
Associa uma fonte de dados ao controle de servidor invocado e todos os seus controles filho com uma opção para gerar o evento DataBinding. (Herdado de Control) |
DataBindChildren() |
Associa uma fonte de dados aos controles filho do controle do servidor. (Herdado de Control) |
DeleteRow(Int32) |
Exclui o registro no índice especificado da fonte de dados. |
Dispose() |
Permite que um controle de servidor execute a limpeza final antes do lançamento da memória. (Herdado de Control) |
EndRenderTracing(TextWriter, Object) |
Encerra o rastreamento de tempo de design de dados de renderização. (Herdado de Control) |
EnsureChildControls() |
Determinará se o controle de servidor contiver controles filho. Se ele não contiver, ele criará controles filho. (Herdado de Control) |
EnsureDataBound() |
Chamará o método DataBind() se a propriedade DataSourceID estiver definida e o controle associado a dados estiver marcado para exigir a associação. (Herdado de BaseDataBoundControl) |
EnsureID() |
Cria um identificador para controles que não têm um identificador atribuído. (Herdado de Control) |
Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
ExtractRowValues(IOrderedDictionary, GridViewRow, Boolean, Boolean) |
Recupera os valores de cada campo declarados dentro da linha especificada e armazena-os no objeto IOrderedDictionary especificado. |
FindControl(String) |
Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro |
FindControl(String, Int32) |
Procura o contêiner de nomenclatura atual para um controle de servidor com o |
Focus() |
Define o foco de entrada para um controle. (Herdado de Control) |
GetCallbackResult() |
Retorna o resultado de um evento de retorno de chamada direcionado a um controle. |
GetCallbackScript(IButtonControl, String) |
Cria o script de retorno de chamada para um botão que executa uma operação de classificação. |
GetData() |
Recupera um objeto DataSourceView que o controle com associação de dados usa para executar operações de dados. (Herdado de DataBoundControl) |
GetDataSource() |
Recupera a interface IDataSource à qual o controle associado a dados está associado, se houver. (Herdado de DataBoundControl) |
GetDesignModeState() |
Obtém os dados de tempo de design para um controle. (Herdado de Control) |
GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
GetRouteUrl(Object) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control) |
GetRouteUrl(RouteValueDictionary) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control) |
GetRouteUrl(String, Object) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control) |
GetRouteUrl(String, RouteValueDictionary) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control) |
GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
GetUniqueIDRelativeTo(Control) |
Retorna a parte prefixada da propriedade UniqueID do controle especificado. (Herdado de Control) |
HasControls() |
Determina se o controle de servidor contém algum controle filho. (Herdado de Control) |
HasEvents() |
Retorna um valor que indica se os eventos são registrados para o controle ou qualquer controle filho. (Herdado de Control) |
InitializePager(GridViewRow, Int32, PagedDataSource) |
Inicializa a linha de pager exibida quando o recurso de paginação está habilitado. |
InitializeRow(GridViewRow, DataControlField[]) |
Cria uma linha no controle GridView. |
IsBindableType(Type) |
Determina se o tipo de dados especificado pode estar associado a uma coluna em um controle GridView. |
IsLiteralContent() |
Determina se o controle de servidor contém apenas o conteúdo literal. (Herdado de Control) |
LoadControlState(Object) |
Carrega as informações de estado das propriedades no controle GridView que devem ser persistentes, mesmo quando a propriedade EnableViewState é definida como |
LoadViewState(Object) |
Carrega o estado de exibição salvo anteriormente do controle GridView. |
MapPathSecure(String) |
Recupera o caminho físico para o qual um caminho virtual é mapeado, relativo ou virtual. (Herdado de Control) |
MarkAsDataBound() |
Define o estado do controle em estado de exibição como associado com êxito aos dados. (Herdado de DataBoundControl) |
MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
MergeStyle(Style) |
Copia os elementos não vazios do estilo especificado para o controle da Web, mas não substituirá os elementos de estilo existentes do controle. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
OnBubbleEvent(Object, EventArgs) |
Determina se o evento do controle de servidor Web é passado um nível acima da hierarquia de controle de servidor da interface do usuário da página. |
OnCreatingModelDataSource(CreatingModelDataSourceEventArgs) |
Aciona o evento CreatingModelDataSource. (Herdado de DataBoundControl) |
OnDataBinding(EventArgs) |
Aciona o evento DataBinding. (Herdado de Control) |
OnDataBound(EventArgs) |
Aciona o evento DataBound. (Herdado de BaseDataBoundControl) |
OnDataPropertyChanged() |
Reassocia o controle GridView aos respectivos dados após a propriedade DataMember, DataSource ou DataSourceID ser alterada. |
OnDataSourceViewChanged(Object, EventArgs) |
Aciona o evento DataSourceViewChanged. |
OnInit(EventArgs) |
Aciona o evento Init. |
OnLoad(EventArgs) |
Manipula o evento Load. (Herdado de DataBoundControl) |
OnPageIndexChanged(EventArgs) |
Aciona o evento PageIndexChanged. |
OnPageIndexChanging(GridViewPageEventArgs) |
Aciona o evento PageIndexChanging. |
OnPagePreLoad(Object, EventArgs) |
Define o estado inicializado do controle associado a dados antes do carregamento do controle. |
OnPreRender(EventArgs) |
Aciona o evento PreRender. |
OnRowCancelingEdit(GridViewCancelEditEventArgs) |
Aciona o evento RowCancelingEdit. |
OnRowCommand(GridViewCommandEventArgs) |
Aciona o evento RowCommand. |
OnRowCreated(GridViewRowEventArgs) |
Aciona o evento RowCreated. |
OnRowDataBound(GridViewRowEventArgs) |
Aciona o evento RowDataBound. |
OnRowDeleted(GridViewDeletedEventArgs) |
Aciona o evento RowDeleted. |
OnRowDeleting(GridViewDeleteEventArgs) |
Aciona o evento RowDeleting. |
OnRowEditing(GridViewEditEventArgs) |
Aciona o evento RowEditing. |
OnRowUpdated(GridViewUpdatedEventArgs) |
Aciona o evento RowUpdated. |
OnRowUpdating(GridViewUpdateEventArgs) |
Aciona o evento RowUpdating. |
OnSelectedIndexChanged(EventArgs) |
Aciona o evento SelectedIndexChanged. |
OnSelectedIndexChanging(GridViewSelectEventArgs) |
Aciona o evento SelectedIndexChanging. |
OnSorted(EventArgs) |
Aciona o evento Sorted. |
OnSorting(GridViewSortEventArgs) |
Aciona o evento Sorting. |
OnUnload(EventArgs) |
Aciona o evento Unload. (Herdado de Control) |
OpenFile(String) |
Obtém um Stream usado para ler um arquivo. (Herdado de Control) |
PerformDataBinding(IEnumerable) |
Associa a fonte de dados especificada ao controle GridView. |
PerformSelect() |
Recupera dados da fonte de dados associada. (Herdado de DataBoundControl) |
PrepareControlHierarchy() |
Estabelece a hierarquia de controles. |
RaiseBubbleEvent(Object, EventArgs) |
Atribui quaisquer fontes de evento e suas informações para o pai do controle. (Herdado de Control) |
RaiseCallbackEvent(String) |
Cria os argumentos para o manipulador de retorno de chamada no método GetCallbackEventReference(Control, String, String, String, Boolean). |
RaisePostBackEvent(String) |
Gera os eventos apropriados para o controle GridView quando ele executa um postback para o servidor. |
RemovedControl(Control) |
Chamado após um controle filho ser removido da coleção Controls do objeto Control. (Herdado de Control) |
Render(HtmlTextWriter) |
Renderiza o conteúdo do controle de servidor Web no navegador do cliente usando o objeto HtmlTextWriter especificado. |
RenderBeginTag(HtmlTextWriter) |
Renderiza a marca de abertura HTML do controle para o gravador especificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
RenderChildren(HtmlTextWriter) |
Gera o conteúdo dos filhos de um controle de servidor para um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente. (Herdado de Control) |
RenderContents(HtmlTextWriter) |
Renderiza o conteúdo do controle no gravador especificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
RenderControl(HtmlTextWriter) |
Gera o conteúdo do controle de servidor para um objeto HtmlTextWriter fornecido e armazena informações de rastreamento sobre o controle caso o rastreamento esteja habilitado. (Herdado de Control) |
RenderControl(HtmlTextWriter, ControlAdapter) |
Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido. (Herdado de Control) |
RenderEndTag(HtmlTextWriter) |
Renderiza a marca de fechamento HTML do controle para o gravador especificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
ResolveAdapter() |
Obtém o adaptador de controle responsável por renderizar o controle especificado. (Herdado de Control) |
ResolveClientUrl(String) |
Obtém uma URL que pode ser usada pelo navegador. (Herdado de Control) |
ResolveUrl(String) |
Converte uma URL em uma que possa ser usada no cliente solicitante. (Herdado de Control) |
SaveControlState() |
Salva as informações de estado das propriedades no controle GridView que devem ser persistentes, mesmo quando a propriedade EnableViewState é definida como |
SaveViewState() |
Carrega o estado de exibição salvo anteriormente do controle GridView. |
SelectRow(Int32) |
Seleciona a linha a ser editada em um controle de GridView. |
SetDesignModeState(IDictionary) |
Define os dados de tempo de design para um controle. (Herdado de Control) |
SetEditRow(Int32) |
Coloca uma linha no modo de edição em um controle GridView usando o índice de linha especificado. |
SetPageIndex(Int32) |
Define o índice da página do controle GridView usando o índice da linha. |
SetRenderMethodDelegate(RenderMethod) |
Atribui um delegado do manipulador de eventos para renderizar o controle de servidor e seu conteúdo em seu controle pai. (Herdado de Control) |
SetTraceData(Object, Object) |
Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando a chave e o valor de dados de rastreamento. (Herdado de Control) |
SetTraceData(Object, Object, Object) |
Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando o objeto rastreado, a chave e o valor de dados de rastreamento. (Herdado de Control) |
Sort(String, SortDirection) |
Classifica o controle GridView baseado na expressão e direção de classificação especificadas. |
ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
TrackViewState() |
Rastreia alterações de estado de exibição no controle GridView de modo que elas podem ser armazenadas no objeto StateBag do controle. Esse objeto é acessível por meio da propriedade ViewState. |
UpdateRow(Int32, Boolean) |
Atualiza o registro no índice especificado de linha usando os valores de campo da linha. |
ValidateDataSource(Object) |
Verifica se o objeto ao qual um controle associado a dados está associado é um objeto com o qual ele pode trabalhar. (Herdado de DataBoundControl) |
Eventos
CallingDataMethods |
Ocorre quando os métodos de dados estão sendo chamados. (Herdado de DataBoundControl) |
CreatingModelDataSource |
Ocorre quando o objeto ModelDataSource está sendo criado. (Herdado de DataBoundControl) |
DataBinding |
Ocorre quando o controle de servidor é associado a uma fonte de dados. (Herdado de Control) |
DataBound |
Ocorre após o controle de servidor ser associado a uma fonte de dados. (Herdado de BaseDataBoundControl) |
Disposed |
Ocorre quando um controle de servidor é liberado da memória, que é o último estágio do ciclo de vida de controle de servidor quando uma página ASP.NET é solicitada. (Herdado de Control) |
Init |
Ocorre quando o controle de servidor é inicializado, que é a primeira etapa do ciclo de vida. (Herdado de Control) |
Load |
Ocorre quando o controle de servidor é carregado no objeto Page. (Herdado de Control) |
PageIndexChanged |
Ocorre quando um dos botões de paginação é acionado, mas após o controle GridView manipular a operação de paginação. |
PageIndexChanging |
Ocorre quando um dos botões de paginação é acionado, mas antes de o controle GridView manipular a operação de paginação. |
PreRender |
Ocorre depois que o objeto Control é carregado, mas antes da renderização. (Herdado de Control) |
RowCancelingEdit |
Ocorre quando um usuário clica no botão Cancelar de uma linha no modo de edição, mas antes que a linha saia do modo de edição. |
RowCommand |
Ocorre quando se clica em um botão em um controle GridView. |
RowCreated |
Ocorre quando uma linha é criada em um controle GridView. |
RowDataBound |
Ocorre quando uma linha de dados é associada a dados em um controle GridView. |
RowDeleted |
Ocorre quando se clica no botão Excluir de uma linha, mas depois de o controle GridView excluir a linha. |
RowDeleting |
Ocorre quando o botão Excluir de uma linha é acionado, mas antes do controle GridView excluir a linha. |
RowEditing |
Ocorre quando o botão Editar de uma linha é clicado, mas antes de o controle GridView entrar em modo de edição. |
RowUpdated |
Ocorre quando o botão Atualizar de uma linha é acionado, mas depois de o controle GridView atualizar a linha. |
RowUpdating |
Ocorre quando o botão Atualizar de uma linha é acionado, mas antes do controle GridView atualizar a linha. |
SelectedIndexChanged |
Ocorre quando o botão de seleção de uma linha é clicado, mas após o controle GridView manipular a operação de seleção. |
SelectedIndexChanging |
Ocorre quando o botão de seleção de uma linha é clicado, mas antes do controle GridView manipular a operação de seleção. |
Sorted |
Ocorre quando se clica no hiperlink para classificar uma coluna, mas depois de o controle GridView manipular a operação de classificação. |
Sorting |
Ocorre quando o hiperlink para classificar uma coluna é clicado, mas antes de o controle GridView manipular a operação de classificação. |
Unload |
Ocorre quando o controle de servidor é descarregado da memória. (Herdado de Control) |
Implantações explícitas de interface
IAttributeAccessor.GetAttribute(String) |
Obtém um atributo do controle da Web com o nome especificado. (Herdado de WebControl) |
IAttributeAccessor.SetAttribute(String, String) |
Define um atributo do controle da Web para o nome e o valor especificados. (Herdado de WebControl) |
ICallbackContainer.GetCallbackScript(IButtonControl, String) |
Cria o script de retorno de chamada para um botão que executa uma operação de classificação. |
ICallbackEventHandler.GetCallbackResult() |
Retorna o resultado de um evento de retorno de chamada direcionado a um controle. |
ICallbackEventHandler.RaiseCallbackEvent(String) |
Cria os argumentos para o manipulador de retorno de chamada no método GetCallbackEventReference(Control, String, String, String, Boolean). |
IControlBuilderAccessor.ControlBuilder |
Para obter uma descrição desse membro, confira ControlBuilder. (Herdado de Control) |
IControlDesignerAccessor.GetDesignModeState() |
Para obter uma descrição desse membro, confira GetDesignModeState(). (Herdado de Control) |
IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Para obter uma descrição desse membro, confira SetDesignModeState(IDictionary). (Herdado de Control) |
IControlDesignerAccessor.SetOwnerControl(Control) |
Para obter uma descrição desse membro, confira SetOwnerControl(Control). (Herdado de Control) |
IControlDesignerAccessor.UserData |
Para obter uma descrição desse membro, confira UserData. (Herdado de Control) |
IDataBindingsAccessor.DataBindings |
Para obter uma descrição desse membro, confira DataBindings. (Herdado de Control) |
IDataBindingsAccessor.HasDataBindings |
Para obter uma descrição desse membro, confira HasDataBindings. (Herdado de Control) |
IDataBoundControl.DataKeyNames |
Obtém ou define os nomes dos campos de chave primária para os itens exibidos em um controle associado a dados. |
IDataBoundControl.DataMember |
Obtém ou define a tabela que é exposta pelo controle de fonte de dados para associar ao controle associado a dados. |
IDataBoundControl.DataSource |
Obtém ou define o objeto de fonte de dados do qual o controle com limite de dados recupera a lista de itens de dados. |
IDataBoundControl.DataSourceID |
Obtém ou define a ID da fonte de dados da qual o controle com limite de dados recupera a lista de itens de dados. |
IDataBoundControl.DataSourceObject |
Obtém ou define o objeto de fonte de dados do qual o controle com limite de dados recupera a lista de itens de dados. |
IDataBoundListControl.ClientIDRowSuffix |
Obtém ou define os nomes dos campos de dados cujos valores são acrescentados ao valor da propriedade ClientID para identificar exclusivamente cada instância de um controle com limite de dados. |
IDataBoundListControl.DataKeys |
Obtém uma coleção de objetos que representam o valor DataKeys em um controle associado a dados. |
IDataBoundListControl.EnablePersistedSelection |
Obtém ou define um valor que indica se a seleção de uma linha é baseada em valores de chave de dados ou no índice. |
IDataBoundListControl.SelectedDataKey |
Obtém o objeto que contém o valor de chave de dados para a linha selecionada em um controle associado a dados. |
IDataBoundListControl.SelectedIndex |
Obtém ou define o índice da linha selecionada em um controle associado a dados. |
IDataKeysControl.ClientIDRowSuffixDataKeys |
Obtém os valores de dados que são usados para identificar exclusivamente cada instância de um controle associado a dados quando o ASP.NET gera o valor ClientID. |
IExpressionsAccessor.Expressions |
Para obter uma descrição desse membro, confira Expressions. (Herdado de Control) |
IExpressionsAccessor.HasExpressions |
Para obter uma descrição desse membro, confira HasExpressions. (Herdado de Control) |
IFieldControl.FieldsGenerator |
Obtém ou define o controle que gera automaticamente as colunas para um controle associado a dados para uso pelos Dados Dinâmicos do ASP.NET. |
IParserAccessor.AddParsedSubObject(Object) |
Para obter uma descrição desse membro, confira AddParsedSubObject(Object). (Herdado de Control) |
IPersistedSelector.DataKey |
Para obter uma descrição desse membro, confira DataKey. |
IPostBackContainer.GetPostBackOptions(IButtonControl) |
Cria um objeto PostBackOptions que representa o comportamento de postback do controle de botão especificado. |
IPostBackEventHandler.RaisePostBackEvent(String) |
Gera os eventos apropriados para o controle GridView quando ele executa um postback para o servidor. |
Métodos de Extensão
EnablePersistedSelection(BaseDataBoundControl) |
Obsoleto.
Permite que a seleção seja persistida nos controles de dados que dão suporte à seleção e à paginação. |
FindDataSourceControl(Control) |
Retorna a fonte de dados associada ao controle de dados do controle especificado. |
FindFieldTemplate(Control, String) |
Retorna o modelo do campo para a coluna especificada no contêiner de nomenclatura do controle especificado. |
FindMetaTable(Control) |
Retorna o objeto metatable para o controle que contém dados. |
GetDefaultValues(INamingContainer) |
Obtém a coleção de valores padrão para o controle de dados especificado. |
GetMetaTable(INamingContainer) |
Obtém os metadados de tabela para o controle de dados especificado. |
SetMetaTable(INamingContainer, MetaTable) |
Define os metadados de tabela para o controle de dados especificado. |
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Define os metadados de tabela e o mapeamento de valores padrão para o controle de dados especificado. |
SetMetaTable(INamingContainer, MetaTable, Object) |
Define os metadados de tabela e o mapeamento de valores padrão para o controle de dados especificado. |
TryGetMetaTable(INamingContainer, MetaTable) |
Determina se os metadados da tabela estão disponíveis. |
EnableDynamicData(INamingContainer, Type) |
Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado. |
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado. |
EnableDynamicData(INamingContainer, Type, Object) |
Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado. |