FormView Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Exibe os valores de um único registo de uma fonte de dados usando modelos definidos pelo utilizador. O FormView controlo permite-lhe editar, eliminar e inserir registos.
public ref class FormView : System::Web::UI::WebControls::CompositeDataBoundControl, System::Web::UI::IDataItemContainer, System::Web::UI::IPostBackEventHandler, System::Web::UI::WebControls::IPostBackContainerpublic ref class FormView : System::Web::UI::WebControls::CompositeDataBoundControl, System::Web::UI::IDataItemContainer, System::Web::UI::IPostBackEventHandler, System::Web::UI::WebControls::IDataBoundItemControl, System::Web::UI::WebControls::IPostBackContainer[System.Web.UI.ControlValueProperty("SelectedValue")]
public class FormView : System.Web.UI.WebControls.CompositeDataBoundControl, System.Web.UI.IDataItemContainer, System.Web.UI.IPostBackEventHandler, System.Web.UI.WebControls.IPostBackContainer[System.Web.UI.ControlValueProperty("SelectedValue")]
public class FormView : System.Web.UI.WebControls.CompositeDataBoundControl, System.Web.UI.IDataItemContainer, System.Web.UI.IPostBackEventHandler, System.Web.UI.WebControls.IDataBoundItemControl, System.Web.UI.WebControls.IPostBackContainer[<System.Web.UI.ControlValueProperty("SelectedValue")>]
type FormView = class
inherit CompositeDataBoundControl
interface IDataItemContainer
interface INamingContainer
interface IPostBackEventHandler
interface IPostBackContainer[<System.Web.UI.ControlValueProperty("SelectedValue")>]
type FormView = class
inherit CompositeDataBoundControl
interface IDataItemContainer
interface INamingContainer
interface IPostBackEventHandler
interface IPostBackContainer
interface IDataBoundItemControl
interface IDataBoundControlPublic Class FormView
Inherits CompositeDataBoundControl
Implements IDataItemContainer, IPostBackContainer, IPostBackEventHandlerPublic Class FormView
Inherits CompositeDataBoundControl
Implements IDataBoundItemControl, IDataItemContainer, IPostBackContainer, IPostBackEventHandler- Herança
- Atributos
- Implementações
Exemplos
O exemplo seguinte demonstra como usar um FormView controlo para mostrar os valores de um SqlDataSource controlo.
<%@ 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>FormView Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>FormView Example</h3>
<asp:formview id="EmployeeFormView"
datasourceid="EmployeeSource"
allowpaging="true"
datakeynames="EmployeeID"
runat="server">
<itemtemplate>
<table>
<tr>
<td>
<asp:image id="EmployeeImage"
imageurl='<%# Eval("PhotoPath") %>'
alternatetext='<%# Eval("LastName") %>'
runat="server"/>
</td>
<td>
<h3><%# Eval("FirstName") %> <%# Eval("LastName") %></h3>
<%# Eval("Title") %>
</td>
</tr>
</table>
</itemtemplate>
<pagersettings position="Bottom"
mode="NextPrevious"/>
</asp:formview>
<!-- 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="EmployeeSource"
selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server"/>
</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>FormView Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>FormView Example</h3>
<asp:formview id="EmployeeFormView"
datasourceid="EmployeeSource"
allowpaging="true"
datakeynames="EmployeeID"
runat="server">
<itemtemplate>
<table>
<tr>
<td>
<asp:image id="EmployeeImage"
imageurl='<%# Eval("PhotoPath") %>'
alternatetext='<%# Eval("LastName") %>'
runat="server"/>
</td>
<td>
<h3><%# Eval("FirstName") %> <%# Eval("LastName") %></h3>
<%# Eval("Title") %>
</td>
</tr>
</table>
</itemtemplate>
<pagersettings position="Bottom"
mode="NextPrevious"/>
</asp:formview>
<!-- 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="EmployeeSource"
selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server"/>
</form>
</body>
</html>
O exemplo seguinte demonstra como usar um FormView controlo para editar registos existentes.
Importante
O controlo neste exemplo tem uma caixa de texto que aceita a entrada do utilizador, o que constitui uma potencial ameaça à segurança. Por defeito, as páginas Web do ASP.NET validam que a entrada do utilizador não inclui elementos de script ou HTML. Para mais informações, consulte Visão Geral dos Exploits de Scripts.
<%@ 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 EmployeeFormView_ItemUpdating(Object sender, FormViewUpdateEventArgs e)
{
// Validate the field values entered by the user. This
// example determines whether the user left any fields
// empty. Use the NewValues property to access the new
// values entered by the user.
ArrayList emptyFieldList = ValidateFields(e.NewValues);
if (emptyFieldList.Count > 0)
{
// The user left some fields empty. Display an error message.
// Use the Keys property to retrieve the key field value.
String keyValue = e.Keys["EmployeeID"].ToString();
MessageLabel.Text = "You must enter a value for each field of record " +
keyValue + ".<br/>The following fields are missing:<br/><br/>";
// Display the missing fields.
foreach (String value in emptyFieldList)
{
// Use the OldValues property to access the original value
// of a field.
MessageLabel.Text += value + " - Original Value = " +
e.OldValues[value].ToString() + "<br />";
}
// Cancel the update operation.
e.Cancel = true;
}
else
{
// The field values passed validation. Clear the
// error message label.
MessageLabel.Text = "";
}
}
ArrayList ValidateFields(IOrderedDictionary list)
{
// Create an ArrayList object to store the
// names of any empty fields.
ArrayList emptyFieldList = new ArrayList();
// Iterate though the field values entered by
// the user and check for an empty field. Empty
// fields contain a null value.
foreach (DictionaryEntry entry in list)
{
if (entry.Value == String.Empty)
{
// Add the field name to the ArrayList object.
emptyFieldList.Add(entry.Key.ToString());
}
}
return emptyFieldList;
}
void EmployeeFormView_ModeChanging(Object sender, FormViewModeEventArgs e)
{
if (e.CancelingEdit)
{
// The user canceled the update operation.
// Clear the error message label.
MessageLabel.Text = "";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>FormView Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>FormView Example</h3>
<asp:formview id="EmployeeFormView"
datasourceid="EmployeeSource"
allowpaging="true"
datakeynames="EmployeeID"
headertext="Employee Record"
emptydatatext="No employees found."
onitemupdating="EmployeeFormView_ItemUpdating"
onmodechanging="EmployeeFormView_ModeChanging"
runat="server">
<headerstyle backcolor="CornFlowerBlue"
forecolor="White"
font-size="14"
horizontalalign="Center"
wrap="false"/>
<rowstyle backcolor="LightBlue"
wrap="false"/>
<pagerstyle backcolor="CornFlowerBlue"/>
<itemtemplate>
<table>
<tr>
<td rowspan="6">
<asp:image id="EmployeeImage"
imageurl='<%# Eval("PhotoPath") %>'
alternatetext='<%# Eval("LastName") %>'
runat="server"/>
</td>
<td colspan="2">
</td>
</tr>
<tr>
<td>
<b>Name:</b>
</td>
<td>
<%# Eval("FirstName") %> <%# Eval("LastName") %>
</td>
</tr>
<tr>
<td>
<b>Title:</b>
</td>
<td>
<%# Eval("Title") %>
</td>
</tr>
<tr>
<td>
<b>Hire Date:</b>
</td>
<td>
<%# Eval("HireDate","{0:d}") %>
</td>
</tr>
<tr style="height:150; vertical-align:top">
<td>
<b>Address:</b>
</td>
<td>
<%# Eval("Address") %><br/>
<%# Eval("City") %> <%# Eval("Region") %>
<%# Eval("PostalCode") %><br/>
<%# Eval("Country") %>
</td>
</tr>
<tr>
<td colspan="2">
<asp:linkbutton id="Edit"
text="Edit"
commandname="Edit"
runat="server"/>
</td>
</tr>
</table>
</itemtemplate>
<edititemtemplate>
<table>
<tr>
<td rowspan="6">
<asp:image id="EmployeeEditImage"
imageurl='<%# Eval("PhotoPath") %>'
alternatetext='<%# Eval("LastName") %>'
runat="server"/>
</td>
<td colspan="2">
</td>
</tr>
<tr>
<td>
<b>Name:</b>
</td>
<td>
<asp:textbox id="FirstNameUpdateTextBox"
text='<%# Bind("FirstName") %>'
runat="server"/>
<asp:textbox id="LastNameUpdateTextBox"
text='<%# Bind("LastName") %>'
runat="server"/>
</td>
</tr>
<tr>
<td>
<b>Title:</b>
</td>
<td>
<asp:textbox id="TitleUpdateTextBox"
text='<%# Bind("Title") %>'
runat="server"/>
</td>
</tr>
<tr>
<td>
<b>Hire Date:</b>
</td>
<td>
<asp:textbox id="HireDateUpdateTextBox"
text='<%# Bind("HireDate", "{0:d}") %>'
runat="server"/>
</td>
</tr>
<tr style="height:150; vertical-align:top">
<td>
<b>Address:</b>
</td>
<td>
<asp:textbox id="AddressUpdateTextBox"
text='<%# Bind("Address") %>'
runat="server"/>
<br/>
<asp:textbox id="CityUpdateTextBox"
text='<%# Bind("City") %>'
runat="server"/>
<asp:textbox id="RegionUpdateTextBox"
text='<%# Bind("Region") %>'
width="40"
runat="server"/>
<asp:textbox id="PostalCodeUpdateTextBox"
text='<%# Bind("PostalCode") %>'
width="60"
runat="server"/>
<br/>
<asp:textbox id="CountryUpdateTextBox"
text='<%# Bind("Country") %>'
runat="server"/>
</td>
</tr>
<tr>
<td colspan="2">
<asp:linkbutton id="UpdateButton"
text="Update"
commandname="Update"
runat="server"/>
<asp:linkbutton id="CancelButton"
text="Cancel"
commandname="Cancel"
runat="server"/>
</td>
</tr>
</table>
</edititemtemplate>
<pagersettings position="Bottom"
mode="Numeric"/>
</asp:formview>
<br/><br/>
<asp:label id="MessageLabel"
forecolor="Red"
runat="server"/>
<!-- 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="EmployeeSource"
selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [Address], [City], [Region], [PostalCode], [Country], [HireDate], [PhotoPath] From [Employees]"
updatecommand="Update [Employees] Set [LastName]=@LastName, [FirstName]=@FirstName, [Title]=@Title, [Address]=@Address, [City]=@City, [Region]=@Region, [PostalCode]=@PostalCode, [Country]=@Country Where [EmployeeID]=@EmployeeID"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server"/>
</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 EmployeeFormView_ItemUpdating(ByVal sender As Object, ByVal e As FormViewUpdateEventArgs) Handles EmployeeFormView.ItemUpdating
' Validate the field values entered by the user. This
' example determines whether the user left any fields
' empty. Use the NewValues property to access the new
' values entered by the user.
Dim emptyFieldList As ArrayList = ValidateFields(e.NewValues)
If emptyFieldList.Count > 0 Then
' The user left some fields empty. Display an error message.
' Use the Keys property to retrieve the key field value.
Dim keyValue As String = e.Keys("EmployeeID").ToString()
MessageLabel.Text = "You must enter a value for each field of record " & _
keyValue & ".<br/>The following fields are missing:<br/><br/>"
' Display the missing fields.
Dim value As String
For Each value In emptyFieldList
' Use the OldValues property to access the original value
' of a field.
MessageLabel.Text &= value & " - Original Value = " & _
e.OldValues(value).ToString() & "<br />"
Next
' Cancel the update operation.
e.Cancel = True
Else
' The field values passed validation. Clear the
' error message label.
MessageLabel.Text = ""
End If
End Sub
Function ValidateFields(ByVal list As IOrderedDictionary) As ArrayList
' Create an ArrayList object to store the
' names of any empty fields.
Dim emptyFieldList As New ArrayList()
' Iterate though the field values entered by
' the user and check for an empty field. Empty
' fields contain a null value.
Dim entry As DictionaryEntry
For Each entry In list
If entry.Value Is String.Empty Then
' Add the field name to the ArrayList object.
emptyFieldList.Add(entry.Key.ToString())
End If
Next
Return emptyFieldList
End Function
Sub EmployeeFormView_ModeChanging(ByVal sender As Object, ByVal e As FormViewModeEventArgs) Handles EmployeeFormView.ModeChanging
If e.CancelingEdit Then
' The user canceled the update operation.
' Clear the error message label.
MessageLabel.Text = ""
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>FormView Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>FormView Example</h3>
<asp:formview id="EmployeeFormView"
datasourceid="EmployeeSource"
allowpaging="true"
datakeynames="EmployeeID"
headertext="Employee Record"
emptydatatext="No employees found."
runat="server">
<headerstyle backcolor="CornFlowerBlue"
forecolor="White"
font-size="14"
horizontalalign="Center"
wrap="false"/>
<rowstyle backcolor="LightBlue"
wrap="false"/>
<pagerstyle backcolor="CornFlowerBlue"/>
<itemtemplate>
<table>
<tr>
<td rowspan="6">
<asp:image id="EmployeeImage"
imageurl='<%# Eval("PhotoPath") %>'
alternatetext='<%# Eval("LastName") %>'
runat="server"/>
</td>
<td colspan="2">
</td>
</tr>
<tr>
<td>
<b>Name:</b>
</td>
<td>
<%# Eval("FirstName") %> <%# Eval("LastName") %>
</td>
</tr>
<tr>
<td>
<b>Title:</b>
</td>
<td>
<%# Eval("Title") %>
</td>
</tr>
<tr>
<td>
<b>Hire Date:</b>
</td>
<td>
<%# Eval("HireDate","{0:d}") %>
</td>
</tr>
<tr style="height:150; vertical-align:top">
<td>
<b>Address:</b>
</td>
<td>
<%# Eval("Address") %><br/>
<%# Eval("City") %> <%# Eval("Region") %>
<%# Eval("PostalCode") %><br/>
<%# Eval("Country") %>
</td>
</tr>
<tr>
<td colspan="2">
<asp:linkbutton id="Edit"
text="Edit"
commandname="Edit"
runat="server"/>
</td>
</tr>
</table>
</itemtemplate>
<edititemtemplate>
<table>
<tr>
<td rowspan="6">
<asp:image id="EmployeeEditImage"
imageurl='<%# Eval("PhotoPath") %>'
alternatetext='<%# Eval("LastName") %>'
runat="server"/>
</td>
<td colspan="2">
</td>
</tr>
<tr>
<td>
<b>Name:</b>
</td>
<td>
<asp:textbox id="FirstNameUpdateTextBox"
text='<%# Bind("FirstName") %>'
runat="server"/>
<asp:textbox id="LastNameUpdateTextBox"
text='<%# Bind("LastName") %>'
runat="server"/>
</td>
</tr>
<tr>
<td>
<b>Title:</b>
</td>
<td>
<asp:textbox id="TitleUpdateTextBox"
text='<%# Bind("Title") %>'
runat="server"/>
</td>
</tr>
<tr>
<td>
<b>Hire Date:</b>
</td>
<td>
<asp:textbox id="HireDateUpdateTextBox"
text='<%# Bind("HireDate", "{0:d}") %>'
runat="server"/>
</td>
</tr>
<tr style="height:150; vertical-align:top">
<td>
<b>Address:</b>
</td>
<td>
<asp:textbox id="AddressUpdateTextBox"
text='<%# Bind("Address") %>'
runat="server"/>
<br/>
<asp:textbox id="CityUpdateTextBox"
text='<%# Bind("City") %>'
runat="server"/>
<asp:textbox id="RegionUpdateTextBox"
text='<%# Bind("Region") %>'
width="40"
runat="server"/>
<asp:textbox id="PostalCodeUpdateTextBox"
text='<%# Bind("PostalCode") %>'
width="60"
runat="server"/>
<br/>
<asp:textbox id="CountryUpdateTextBox"
text='<%# Bind("Country") %>'
runat="server"/>
</td>
</tr>
<tr>
<td colspan="2">
<asp:linkbutton id="UpdateButton"
text="Update"
commandname="Update"
runat="server"/>
<asp:linkbutton id="CancelButton"
text="Cancel"
commandname="Cancel"
runat="server"/>
</td>
</tr>
</table>
</edititemtemplate>
<pagersettings position="Bottom"
mode="Numeric"/>
</asp:formview>
<br/><br/>
<asp:label id="MessageLabel"
forecolor="Red"
runat="server"/>
<!-- 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="EmployeeSource"
selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [Address], [City], [Region], [PostalCode], [Country], [HireDate], [PhotoPath] From [Employees]"
updatecommand="Update [Employees] Set [LastName]=@LastName, [FirstName]=@FirstName, [Title]=@Title, [Address]=@Address, [City]=@City, [Region]=@Region, [PostalCode]=@PostalCode, [Country]=@Country Where [EmployeeID]=@EmployeeID"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server"/>
</form>
</body>
</html>
O exemplo seguinte demonstra como usar um FormView controlo para inserir novos registos.
Importante
O controlo neste exemplo tem uma caixa de texto que aceita a entrada do utilizador, o que constitui uma potencial ameaça à segurança. Por defeito, as páginas Web do ASP.NET validam que a entrada do utilizador não inclui elementos de script ou HTML. Para mais informações, consulte Visão Geral dos Exploits de Scripts.
<%@ 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>FormView InsertItemTemplate Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>FormView InsertItemTemplate Example</h3>
<asp:formview id="EmployeeFormView"
datasourceid="EmployeeSource"
allowpaging="true"
datakeynames="EmployeeID"
emptydatatext="No employees found."
runat="server">
<rowstyle backcolor="LightGreen"
wrap="false"/>
<insertrowstyle backcolor="LightBlue"
wrap="false"/>
<itemtemplate>
<table>
<tr>
<td rowspan="5">
<asp:image id="CompanyLogoImage"
imageurl="~/Images/Logo.jpg"
alternatetext="Company logo"
runat="server"/>
</td>
<td colspan="2">
</td>
</tr>
<tr>
<td>
<b>Name:</b>
</td>
<td>
<%# Eval("FirstName") %> <%# Eval("LastName") %>
</td>
</tr>
<tr>
<td>
<b>Title:</b>
</td>
<td>
<%# Eval("Title") %>
</td>
</tr>
<tr>
<td colspan="2">
<asp:linkbutton id="NewButton"
text="New"
commandname="New"
runat="server"/>
</td>
</tr>
</table>
</itemtemplate>
<insertitemtemplate>
<table>
<tr>
<td rowspan="4">
<asp:image id="CompanyLogoEditImage"
imageurl="~/Images/Logo.jpg"
alternatetext="Company logo"
runat="server"/>
</td>
<td colspan="2">
</td>
</tr>
<tr>
<td>
<b><asp:Label runat="server"
AssociatedControlID="FirstNameInsertTextBox"
Text="Name" />:</b>
</td>
<td>
<asp:textbox id="FirstNameInsertTextBox"
text='<%# Bind("FirstName") %>'
runat="server"/>
<asp:textbox id="LastNameInsertTextBox"
text='<%# Bind("LastName") %>'
runat="server"/>
</td>
</tr>
<tr>
<td>
<b><asp:Label runat="server"
AssociatedControlID="TitleInsertTextBox"
Text="Title" />:</b>
</td>
<td>
<asp:textbox id="TitleInsertTextBox"
text='<%# Bind("Title") %>'
runat="server"/>
</td>
</tr>
<tr>
<td colspan="2">
<asp:linkbutton id="InsertButton"
text="Insert"
commandname="Insert"
runat="server" />
<asp:linkbutton id="CancelButton"
text="Cancel"
commandname="Cancel"
runat="server" />
</td>
</tr>
</table>
</insertitemtemplate>
</asp:formview>
<!-- 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="EmployeeSource"
selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]"
insertcommand="Insert Into [Employees] ([LastName], [FirstName], [Title]) VALUES (@LastName, @FirstName, @Title)"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server"/>
</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>FormView InsertItemTemplate Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>FormView InsertItemTemplate Example</h3>
<asp:formview id="EmployeeFormView"
datasourceid="EmployeeSource"
allowpaging="true"
datakeynames="EmployeeID"
emptydatatext="No employees found."
runat="server">
<rowstyle backcolor="LightGreen"
wrap="false"/>
<insertrowstyle backcolor="LightBlue"
wrap="false"/>
<itemtemplate>
<table>
<tr>
<td rowspan="5">
<asp:image id="CompanyLogoImage"
imageurl="~/Images/Logo.jpg"
alternatetext="Company logo"
runat="server"/>
</td>
<td colspan="2">
</td>
</tr>
<tr>
<td>
<b>Name:</b>
</td>
<td>
<%# Eval("FirstName") %> <%# Eval("LastName") %>
</td>
</tr>
<tr>
<td>
<b>Title:</b>
</td>
<td>
<%# Eval("Title") %>
</td>
</tr>
<tr>
<td colspan="2">
<asp:linkbutton id="NewButton"
text="New"
commandname="New"
runat="server"/>
</td>
</tr>
</table>
</itemtemplate>
<insertitemtemplate>
<table>
<tr>
<td rowspan="4">
<asp:image id="CompanyLogoEditImage"
imageurl="~/Images/Logo.jpg"
alternatetext="Company logo"
runat="server"/>
</td>
<td colspan="2">
</td>
</tr>
<tr>
<td>
<b><asp:Label runat="server"
AssociatedControlID="FirstNameInsertTextBox"
Text="Name" />:</b>
</td>
<td>
<asp:textbox id="FirstNameInsertTextBox"
text='<%# Bind("FirstName") %>'
runat="server"/>
<asp:textbox id="LastNameInsertTextBox"
text='<%# Bind("LastName") %>'
runat="server"/>
</td>
</tr>
<tr>
<td>
<b><asp:Label runat="server"
AssociatedControlID="TitleInsertTextBox"
Text="Title" />:</b>
</td>
<td>
<asp:textbox id="TitleInsertTextBox"
text='<%# Bind("Title") %>'
runat="server"/>
</td>
</tr>
<tr>
<td colspan="2">
<asp:linkbutton id="InsertButton"
text="Insert"
commandname="Insert"
runat="server" />
<asp:linkbutton id="CancelButton"
text="Cancel"
commandname="Cancel"
runat="server" />
</td>
</tr>
</table>
</insertitemtemplate>
</asp:formview>
<!-- 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="EmployeeSource"
selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]"
insertcommand="Insert Into [Employees] ([LastName], [FirstName], [Title]) VALUES (@LastName, @FirstName, @Title)"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server"/>
</form>
</body>
</html>
Observações
Neste tópico:
Introduction
O FormView controlo é usado para mostrar um único registo de uma fonte de dados. É semelhante ao DetailsView controlo, exceto que apresenta modelos definidos pelo utilizador em vez de campos de linhas. Criar os seus próprios modelos dá-lhe maior flexibilidade no controlo de como os dados são apresentados. O FormView controlo suporta as seguintes funcionalidades:
Ligação a controlos fonte de dados, como SqlDataSource e ObjectDataSource.
Capacidades de inserção integradas.
Capacidades integradas de atualização e eliminação.
Capacidades de paginação integradas.
Acesso programático ao FormView modelo de objetos para definir dinamicamente propriedades, gerir eventos, e assim por diante.
Aparência personalizável através de modelos, temas e estilos definidos pelo utilizador.
Modelos
Para o FormView controlo mostrar conteúdo, é necessário criar modelos para as diferentes partes do controlo. A maioria dos modelos é opcional; no entanto, deve criar um modelo para o modo em que o controlo está configurado. Por exemplo, um FormView controlo que suporta a inserção de registos deve ter um modelo de inserção de item definido. A tabela seguinte lista os diferentes modelos que pode criar.
| Tipo de modelo | Description |
|---|---|
| EditItemTemplate | Define o conteúdo da linha de dados quando o FormView controlo está em modo de edição. Este modelo normalmente contém controlos de entrada e botões de comando com os quais o utilizador pode editar um registo existente. |
| EmptyDataTemplate | Define o conteúdo para a linha de dados vazia apresentada quando o FormView controlo está ligado a uma fonte de dados que não contém registos. Este modelo normalmente contém conteúdo para alertar o utilizador de que a fonte de dados não contém quaisquer registos. |
| FooterTemplate | Define o conteúdo da linha de rodapé. Este modelo normalmente contém qualquer conteúdo adicional que queira mostrar na linha de rodapé. Nota: Como alternativa, pode simplesmente especificar texto para mostrar na linha de rodapé definindo a FooterText propriedade. |
| HeaderTemplate | Define o conteúdo da linha de cabeçalho. Este modelo normalmente contém qualquer conteúdo adicional que queira mostrar na linha de cabeçalho. Nota: Como alternativa, pode simplesmente especificar texto para mostrar na linha do cabeçalho definindo a HeaderText propriedade. |
| ItemTemplate | Define o conteúdo da linha de dados quando o FormView controlo está em modo de apenas leitura. Este modelo normalmente contém conteúdo para mostrar os valores de um registo existente. |
| InsertItemTemplate | Define o conteúdo da linha de dados quando o FormView controlo está em modo de inserção. Este modelo normalmente contém controlos de entrada e botões de comando com os quais o utilizador pode adicionar um novo registo. |
| PagerTemplate | Define o conteúdo da linha do pager exibida quando a funcionalidade de paginação está ativada (quando a AllowPaging propriedade está definida para true). Este modelo normalmente contém controlos com os quais o utilizador pode navegar para outro registo.
Nota: O FormView controlo tem uma interface de utilizador (UI) integrada na linha de paginação. Só precisa de criar um modelo de pager se quiser criar a sua própria linha personalizada. |
Para mostrar o valor de um campo num modelo de item, use uma expressão de ligação de dados. Para mais informações sobre expressões de ligação de dados, veja Data-Binding Sintaxe de Expressão.
Os controlos de entrada no modelo de edição e no modelo de inserção podem ser atribuídos aos campos de uma fonte de dados usando uma expressão de ligação bidirecional. Isto permite que o FormView controlo extraia automaticamente os valores do controlo de entrada para uma operação de atualização ou inserção. Expressões de ligação bidirecional também permitem que os controlos de entrada num template de item de edição mostrem automaticamente os valores originais dos campos. Para mais informações sobre expressões de ligação bidirecional, veja Binding to Databases.
Ligação a Dados
O FormView controlo pode ser atribuído a um controlo de fonte de dados (como SqlDataSource, ObjectDataSource, ou AccessDataSource) ou a qualquer coleção de fontes 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ções. Use um dos seguintes métodos para associar o FormView controlo ao tipo de fonte de dados apropriado:
Para ligar a um controlo de fonte de dados, defina a DataSourceID propriedade do FormView controlo para o ID valor do controlo de fonte de dados. O FormView controlo liga-se automaticamente ao controlo de fonte de dados especificado e pode tirar partido das capacidades do controlo de fonte de dados para realizar funcionalidades de inserção, atualização, eliminação e paginação. Este é o método preferido para vincular dados.
Para ligar a uma fonte de dados que implementa a System.Collections.IEnumerable interface, define programaticamente a DataSource propriedade do FormView controlo para a fonte de dados e depois chama o DataBind método. Ao usar este método, o FormView controlo não fornece funcionalidade incorporada de inserção, atualização, eliminação e paginação. Precisa de fornecer esta funcionalidade usando o evento apropriado.
Para mais informações sobre ligação de dados, consulte ASP.NET Data Access Content Map.
Note
Este controlo pode ser usado para mostrar a entrada do utilizador, que pode incluir scripts de cliente maliciosos. Verifique qualquer informação enviada por um cliente para scripts executáveis, instruções SQL ou outro código antes de a exibir na sua aplicação. Sempre que possível, recomenda-se fortemente que os valores sejam codificados em HTML antes de serem exibidos neste controlo. ASP.NET fornece uma funcionalidade de validação de pedidos de entrada para bloquear scripts e HTML na entrada do utilizador. São também fornecidos controlos de servidor de validação para avaliar a entrada do utilizador. Para mais informações, consulte Introdução aos Controlos de Validação.
Operações de Dados
O FormView controlo oferece muitas funcionalidades incorporadas que permitem ao utilizador atualizar, eliminar, inserir e paginar os itens no controlo. Quando o controlo FormView está vinculado a um controlo de fonte de dados, este FormView pode tirar partido das capacidades do controlo de fonte de dados e fornecer funcionalidades automáticas de atualização, eliminação, inserção e paginação.
Note
O FormView controlo pode fornecer suporte para operações de atualização, eliminação, inserção e paginação com outros tipos de fontes de dados; no entanto, deve fornecer um gestor de eventos adequado com a implementação dessas operações.
Como o FormView controlo utiliza templates, não fornece uma forma de gerar automaticamente botões de comando para realizar operações de atualização, eliminação ou inserção. Deve incluir manualmente estes botões de comando no modelo apropriado. O FormView controlo reconhece certos botões cujas CommandName propriedades estão definidas com valores específicos. A tabela seguinte lista os botões de comando que o FormView controlo reconhece.
| Botão | Valor CommandName | Description |
|---|---|---|
| Cancelar | Cancelar | Usado na atualização ou inserção de operações para cancelar a operação e descartar os valores inseridos pelo utilizador. O FormView controlo regressa então ao modo especificado pela DefaultMode propriedade. |
| Delete | "Apagar" | Usado em operações de eliminação para eliminar o registo exibido da fonte de dados. Aumenta os ItemDeleting eventos e ItemDeleted eventos. |
| Editar | "Editar" | Usado na atualização de operações para colocar o FormView controlo em modo de edição. O conteúdo especificado na EditItemTemplate propriedade é exibido para a linha de dados. |
| Inserir | "Inserir" | Usado na inserção de operações para tentar inserir um novo registo na fonte de dados usando os valores fornecidos pelo utilizador. Aumenta os ItemInserting eventos e ItemInserted eventos. |
| Novo | "Novo" | Usado em operações de inserção para colocar o FormView controlo em modo de inserção. O conteúdo especificado na InsertItemTemplate propriedade é exibido para a linha de dados. |
| Página | Página | Usado em operações de paginação para representar um botão na linha do pager que realiza a paginação. Para especificar a operação de paginação, defina a CommandArgument propriedade do botão para "Próximo", "Anterior", "Primeiro", "Último" ou o índice da página para onde deve navegar. Aumenta os PageIndexChanging eventos e PageIndexChanged eventos.
Nota: Este tipo de botão é normalmente usado apenas no modelo do pager. |
| Atualizar | "Atualização" | Usado na atualização de operações para tentar atualizar o registo apresentado na fonte de dados com os valores fornecidos pelo utilizador. Aumenta os ItemUpdating eventos e ItemUpdated eventos. |
Ao contrário do botão Delete (que apaga imediatamente o registo apresentado), quando se carrega no botão Editar ou Novo, o FormView controlo entra em modo editar ou inserir, respetivamente. No modo de edição, o conteúdo contido na EditItemTemplate propriedade é exibido para o elemento de dados atual. Normalmente, o modelo de editar o item é definido de modo a que o botão Editar seja substituído por um botão Atualizar e um botão Cancelar. Controlos de entrada apropriados ao tipo de dados do campo (como a TextBox ou controlo CheckBox ) também são normalmente exibidos com o valor de um campo para o utilizador modificar. Clicar no botão Atualizar atualiza o registo na fonte de dados, enquanto clicar no botão Cancelar abandona quaisquer alterações.
Da mesma forma, o conteúdo contido na InsertItemTemplate propriedade é exibido para o elemento de dados quando o controlo está em modo de inserção. O modelo de inserir item é normalmente definido de modo a que o botão Novo seja substituído por um botão Inserir e um botão Cancelar, e controlos de entrada vazios são exibidos para que o utilizador possa inserir os valores do novo registo. Clicar no botão Inserir insere o registo na fonte de dados, enquanto clicar no botão Cancelar abandona quaisquer alterações.
O FormView controlo oferece uma funcionalidade de paginação, que permite ao utilizador navegar para outros registos na fonte de dados. Quando ativado, uma linha de pager é exibida no FormView controlo que contém os controlos de navegação da página. Para permitir a paginação, defina a AllowPaging propriedade para true. Pode personalizar a linha do pager definindo as propriedades dos objetos contidos na PagerStyle propriedade e PagerSettings . Em vez de usar a interface de linha do pager incorporada, pode criar a sua própria interface usando a PagerTemplate propriedade.
Personalização da Interface do Utilizador
Podes personalizar a aparência do FormView controlo definindo as propriedades de estilo para as diferentes partes do controlo. A tabela seguinte lista as diferentes propriedades de estilo.
| Propriedade de estilo | Description |
|---|---|
| EditRowStyle | As definições de estilo para a linha de dados quando o FormView controlo está em modo de edição. |
| EmptyDataRowStyle | As definições de estilo para a linha de dados vazia apresentadas no FormView controlo quando a fonte de dados não contém registos. |
| FooterStyle | As definições de estilo para a linha de rodapé do FormView controlo. |
| HeaderStyle | As definições de estilo para a linha de cabeçalho do FormView controlo. |
| InsertRowStyle | As definições de estilo para a linha de dados quando o FormView controlo está em modo de inserção. |
| PagerStyle | As definições de estilo para a linha do pager são apresentadas no FormView controlo quando a funcionalidade de paginação está ativada. |
| RowStyle | As definições de estilo para a linha de dados quando o FormView controlo está em modo apenas de leitura. |
Events
O FormView controlo oferece vários eventos contra os quais pode programar. Isto permite-lhe executar uma rotina personalizada sempre que ocorre um evento. A tabela seguinte lista os eventos suportados pelo FormView controlo.
| Event | Description |
|---|---|
| ItemCommand | Ocorre quando um botão dentro de um FormView controlo é pressionado. Este evento é frequentemente usado para realizar uma tarefa quando um botão é pressionado no controlo. |
| ItemCreated | Ocorre depois de todos FormViewRow os objetos serem criados no FormView controlo. Este evento é frequentemente usado para modificar os valores de um registo antes de este ser exibido. |
| ItemDeleted | Ocorre quando um botão Delete (um botão com CommandName a propriedade definida para "Eliminar") é clicado, mas após o FormView controlo apagar o registo da fonte de dados. Este evento é frequentemente usado para verificar os resultados da operação de eliminação. |
| ItemDeleting | Ocorre quando se clica num botão Eliminar, mas antes de o controlo FormView apagar o registo da fonte de dados. Este evento é frequentemente usado para cancelar a operação de eliminação. |
| ItemInserted | Ocorre quando um botão Inserir (um botão com CommandName a propriedade definida para "Inserir") é clicado, mas depois de o FormView controlo inserir o registo. Este evento é frequentemente usado para verificar os resultados da operação de inserção. |
| ItemInserting | Ocorre quando um botão de Inserir é clicado, mas antes de o controlo FormView inserir o registo. Este evento é frequentemente usado para cancelar a operação de inserção. |
| ItemUpdated | Ocorre quando um botão de Atualização (um botão com CommandName a propriedade definida para "Atualizar") é clicado, mas após o FormView controlo atualizar a linha. Este evento é frequentemente usado para verificar os resultados da operação de atualização. |
| ItemUpdating | Ocorre quando um botão de Atualização é clicado, mas antes de o FormView controlo atualizar o registo. Este evento é frequentemente usado para cancelar a operação de atualização. |
| ModeChanged | Ocorre depois de o FormView controlo mudar de modo (para editar, inserir ou modo apenas leitura). Este evento é frequentemente usado para realizar uma tarefa quando o FormView controlo muda de modo. |
| ModeChanging | Ocorre antes do FormView controlo mudar de modo (para editar, inserir ou modo apenas leitura). Este evento é frequentemente usado para cancelar uma mudança de modo. |
| PageIndexChanged | Ocorre quando um dos botões do pager é clicado, mas depois de o FormView controlo tratar da operação de paginação. Este evento é comumente usado quando precisa de executar uma tarefa depois de o utilizador navegar para um registo diferente no controlo. |
| PageIndexChanging | Ocorre quando um dos botões do pager é clicado, mas antes do controlo FormView tratar da operação de paginação. Este evento é frequentemente usado para cancelar a operação de paginação. |
Accessibility
Para informações sobre como configurar este controlo de modo a gerar marcação que cumpra os padrões de acessibilidade, consulte Acessibilidade em Visual Studio e ASP.NET e ASP.NET Controlos e Acessibilidade.
Aplicação de Estilos CSS
O FormView controlo permite-te especificar regras de estilo CSS na marcação. Se usares templates para personalizar a aparência do FormView controlo, podes especificar estilos CSS na marcação dos templates. Nesse caso, não é necessária uma mesa exterior extra. Pode impedir que a tabela seja renderizada definindo a RenderOuterTable propriedade para false.
Sintaxe declarativa
<asp:FormView
AccessKey="string"
AllowPaging="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"
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"
RenderOuterTable="True|False"
runat="server"
SkinID="string"
Style="string"
TabIndex="integer"
ToolTip="string"
Visible="True|False"
Width="size"
>
<EditItemTemplate>
<!-- child controls -->
</EditItemTemplate>
<EditRowStyle />
<EmptyDataRowStyle />
<EmptyDataTemplate>
<!-- child controls -->
</EmptyDataTemplate>
<FooterStyle />
<FooterTemplate>
<!-- child controls -->
</FooterTemplate>
<HeaderStyle />
<HeaderTemplate>
<!-- child controls -->
</HeaderTemplate>
<InsertItemTemplate>
<!-- child controls -->
</InsertItemTemplate>
<InsertRowStyle />
<ItemTemplate>
<!-- child controls -->
</ItemTemplate>
<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:FormView>
Construtores
| Name | Description |
|---|---|
| FormView() |
Inicializa uma nova instância da FormView classe. |
Propriedades
| Name | Description |
|---|---|
| AccessKey |
Obtém ou define a chave de acesso que permite navegar rapidamente até ao controlo do servidor Web. (Herdado de WebControl) |
| Adapter |
Recebe o adaptador específico do navegador para o controlo. (Herdado de Control) |
| AllowPaging |
Recebe ou define um valor que indica se a funcionalidade de paginação está ativada. |
| AppRelativeTemplateSourceDirectory |
Obtém ou define o diretório virtual relativo à aplicação do Page objeto ou UserControl que contém este controlo. (Herdado de Control) |
| Attributes |
Obtém a coleção de atributos arbitrários (apenas para renderização) que não correspondem a propriedades no controlo. (Herdado de WebControl) |
| BackColor |
Obtém ou define a cor de fundo do controlo do servidor Web. (Herdado de WebControl) |
| BackImageUrl |
Obtém ou define a URL para uma imagem a ser exibida em segundo plano de um FormView controlo. |
| BindingContainer |
Obtém o controlo que contém a ligação de dados desse controlo. (Herdado de Control) |
| BorderColor |
Obtém ou define a cor da borda do controlo Web. (Herdado de WebControl) |
| BorderStyle |
Obtém ou define o estilo de borda do controlo do servidor Web. (Herdado de WebControl) |
| BorderWidth |
Obtém ou define a largura da fronteira do controlo do servidor Web. (Herdado de WebControl) |
| BottomPagerRow |
Obtém o FormViewRow objeto que representa a linha do pager apresentado na parte inferior do FormView controlo. |
| Caption |
Obtém ou define o texto para renderizar num elemento de legenda HTML num FormView controlo. Esta propriedade é disponibilizada para tornar o controlo mais acessível aos utilizadores de dispositivos de tecnologia assistiva. |
| CaptionAlign |
Obtém ou define a posição horizontal ou vertical do elemento da legenda HTML num FormView controlo. Esta propriedade é disponibilizada para tornar o controlo mais acessível aos utilizadores de dispositivos de tecnologia assistiva. |
| CellPadding |
Obtém ou define a quantidade de espaço entre o conteúdo de uma célula e a borda da célula. |
| CellSpacing |
Obtém ou define a quantidade de espaço entre as células. |
| ChildControlsCreated |
Recebe um valor que indica se os controlos filhos do controlo do servidor foram criados. (Herdado de Control) |
| ClientID |
Obtém o ID de controlo para a marcação HTML gerada pelo ASP.NET. (Herdado de Control) |
| ClientIDMode |
Obtém ou define o algoritmo que é usado para gerar o valor da ClientID propriedade. (Herdado de Control) |
| ClientIDSeparator |
Obtém um valor de carácter que representa o carácter separador usado na ClientID propriedade. (Herdado de Control) |
| Context |
Obtém o controlo do HttpContext objeto associado ao servidor para o pedido Web atual. (Herdado de Control) |
| Controls |
Obtém uma coleção dos controlos filhos dentro do controlo composto com dados vinculados. (Herdado de CompositeDataBoundControl) |
| ControlStyle |
Recebe o estilo do controlo do servidor Web. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl) |
| ControlStyleCreated |
Recebe um valor que indica se um Style objeto foi criado para a ControlStyle propriedade. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl) |
| CssClass |
Obtém ou define a classe Cascading Style Sheet (CSS) renderizada pelo controlo do servidor Web no cliente. (Herdado de WebControl) |
| CurrentMode |
Obtém o modo atual de introdução de dados do FormView controlo. |
| DataItem |
O item de dados é atribuído ao FormView controlo. |
| DataItemContainer |
Obtém uma referência ao contentor de nomes se o contentor implementar IDataItemContainer. (Herdado de Control) |
| DataItemCount |
Obtém o número de itens de dados na fonte de dados. |
| DataItemIndex |
Obtém o índice do item de dados atribuído ao FormView controlo a partir da fonte de dados. |
| DataKey |
Obtém um DataKey objeto que representa a chave primária do registo apresentado. |
| DataKeyNames |
Obtém ou define um array que contém os nomes dos campos-chave da fonte de dados. |
| DataKeysContainer |
Obtém uma referência ao contentor de nomes se o contentor implementar IDataKeysControl. (Herdado de Control) |
| DataMember |
Obtém ou define o nome da lista de dados à qual o controlo de dados se liga, nos casos em que a fonte de dados contém mais do que uma lista distinta de itens de dados. (Herdado de DataBoundControl) |
| DataSource |
Obtém ou define o objeto a partir do qual o controlo ligado a dados recupera a sua lista de itens de dados. (Herdado de BaseDataBoundControl) |
| DataSourceID |
Obtém ou define o ID do controlo do qual o controlo limitado por dados recupera a sua lista de itens de dados. (Herdado de DataBoundControl) |
| DataSourceObject |
Recebe um objeto que implementa a IDataSource interface, que dá acesso ao conteúdo de dados do objeto. (Herdado de DataBoundControl) |
| DefaultMode |
Obtém ou define o modo de introdução de dados ao qual o FormView controlo regressa após uma operação de atualização, inserção ou cancelamento. |
| DeleteMethod |
Recebe ou define o nome do método na página que é chamado quando o controlo realiza uma operação de eliminação. |
| DesignMode |
Obtém um valor que indica se um controlo está a ser usado numa superfície de projeto. (Herdado de Control) |
| EditItemTemplate |
Obtém ou define o conteúdo personalizado de um item em modo de edição. |
| EditRowStyle |
Recebe uma referência ao TableItemStyle objeto que permite definir a aparência da linha de dados quando um FormView controlo está em modo de edição. |
| EmptyDataRowStyle |
Obtém uma referência ao TableItemStyle objeto que permite definir a aparência da linha de dados vazia exibida quando a fonte de dados vinculada a um FormView controlo não contém registos. |
| EmptyDataTemplate |
Obtém ou define o conteúdo definido pelo utilizador para a linha de dados vazia renderizada quando um FormView controlo está vinculado a uma fonte de dados que não contém registos. |
| EmptyDataText |
Obtém ou define o texto para ser exibido na linha de dados vazia renderizada quando um FormView controlo está associado a uma fonte de dados que não contém registos. |
| Enabled |
Recebe ou define um valor que indica se o controlo do servidor Web está ativado. (Herdado de WebControl) |
| EnableModelValidation |
Recebe ou define um valor que indica se um controlo do validador irá tratar exceções que ocorrem durante operações de inserção ou atualização. |
| EnableTheming |
Recebe ou define um valor que indica se os temas se aplicam a este controlo. (Herdado de WebControl) |
| EnableViewState |
Recebe ou define um valor que indica se o controlo do servidor mantém o seu estado de visualização, e o estado de vista de quaisquer controlos filhos que contém, para o cliente solicitante. (Herdado de Control) |
| Events |
Obtém uma lista de delegados handler de eventos para o controlo. Esta propriedade é somente leitura. (Herdado de Control) |
| Font |
Obtém as propriedades da fonte associadas ao controlo do servidor Web. (Herdado de WebControl) |
| FooterRow |
Obtém o FormViewRow objeto que representa a linha de rodapé num FormView controlo. |
| FooterStyle |
Recebe uma referência ao TableItemStyle objeto que permite definir a aparência da linha do rodapé num FormView controlo. |
| FooterTemplate |
Obtém ou define o conteúdo definido pelo utilizador para a linha de rodapé num FormView controlo. |
| FooterText |
Recebe ou define o texto para ser exibido na linha de rodapé de um FormView controlo. |
| ForeColor |
Obtém ou define a cor do primeiro plano (tipicamente a cor do texto) do controlo do servidor Web. (Herdado de WebControl) |
| GridLines |
Obtém ou define o estilo de grelha para um FormView controlo. |
| HasAttributes |
Recebe um valor que indica se o controlo tem atributos definidos. (Herdado de WebControl) |
| HasChildViewState |
Recebe um valor que indica se os controlos filhos do controlo atual do servidor têm alguma configuração de estado de visualização guardada. (Herdado de Control) |
| HeaderRow |
Obtém o FormViewRow objeto que representa a linha do cabeçalho num FormView controlo. |
| HeaderStyle |
Recebe uma referência ao TableItemStyle objeto que permite definir a aparência da linha de cabeçalho num FormView controlo. |
| HeaderTemplate |
Obtém ou define o conteúdo definido pelo utilizador para a linha de cabeçalho num FormView controlo. |
| HeaderText |
Recebe ou define o texto para ser exibido na linha de cabeçalho de um FormView controlo. |
| Height |
Obtém ou define a altura do controlo do servidor Web. (Herdado de WebControl) |
| HorizontalAlign |
Obtém ou define o alinhamento horizontal de um FormView controlo na página. |
| ID |
Obtém ou define o identificador programático atribuído ao controlo do servidor. (Herdado de Control) |
| IdSeparator |
Faz com que o carácter seja usado para separar identificadores de controlo. (Herdado de Control) |
| Initialized |
Obtém um valor que indica se o controlo ligado a dados foi inicializado. (Herdado de BaseDataBoundControl) |
| InsertItemTemplate |
Obtém ou define o conteúdo personalizado de um item no modo de inserção. |
| InsertMethod |
Recebe ou define o nome do método na página que é chamado quando o controlo realiza uma operação de inserção. |
| InsertRowStyle |
Obtém uma referência ao TableItemStyle objeto que permite definir a aparência da linha de dados num FormView controlo quando o controlo está em modo de inserção. |
| IsBoundUsingDataSourceID |
Recebe um valor que indica se a DataSourceID propriedade está definida. (Herdado de BaseDataBoundControl) |
| IsChildControlStateCleared |
Obtém um valor que indica se os controlos contidos neste controlo têm estado de controlo. (Herdado de Control) |
| IsDataBindingAutomatic |
Obtém um valor que indica se a ligação de dados é automática. (Herdado de BaseDataBoundControl) |
| IsEnabled |
Recebe um valor que indica se o controlo está ativado. (Herdado de WebControl) |
| IsTrackingViewState |
Recebe um valor que indica se o controlo do servidor está a guardar alterações ao estado de visualização. (Herdado de Control) |
| IsUsingModelBinders |
Obtém um valor que indica se a binding do modelo está em uso. (Herdado de CompositeDataBoundControl) |
| IsViewStateEnabled |
Recebe um valor que indica se o estado de visualização está ativado para este controlo. (Herdado de Control) |
| ItemTemplate |
Obtém ou define o conteúdo personalizado para a linha de dados num FormView controlo quando o controlo está em modo apenas de leitura. |
| ItemType |
Obtém ou define o nome do tipo de elemento de dados para ligação de dados fortemente tipada. (Herdado de DataBoundControl) |
| LoadViewStateByID |
Recebe um valor que indica se o controlo participa no carregamento do seu estado de visualização em ID vez de index. (Herdado de Control) |
| NamingContainer |
Obtém uma referência ao contentor de nomes do controlo do servidor, que cria um namespace único para diferenciar controlos de servidor com o mesmo ID valor de propriedade. (Herdado de Control) |
| Page |
Obtém uma referência à Page instância que contém o controlo do servidor. (Herdado de Control) |
| PageCount |
Obtém o número total de páginas necessárias para mostrar cada registo na fonte de dados. |
| PageIndex |
Obtém ou define o índice da página apresentada. |
| PagerSettings |
Obtém uma referência ao PagerSettings objeto que permite definir as propriedades dos botões do pager num FormView controlo. |
| PagerStyle |
Recebe uma referência ao TableItemStyle objeto que permite definir a aparência da linha do pager num FormView controlo. |
| PagerTemplate |
Obtém ou define o conteúdo personalizado para a linha do pager num FormView controlo. |
| Parent |
Obtém uma referência ao controlo pai do controlo do servidor na hierarquia de controlo de página. (Herdado de Control) |
| RenderingCompatibility |
Recebe um valor que especifica a versão ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control) |
| RenderOuterTable |
Recebe ou define um valor que indica se o controlo envolve HTML renderizado num |
| RequiresDataBinding |
Recebe ou define um valor que indica se o DataBind() método deve ser chamado. (Herdado de BaseDataBoundControl) |
| Row |
Obtém o FormViewRow objeto que representa a linha de dados num FormView controlo. |
| RowStyle |
Obtém uma referência ao TableItemStyle objeto que permite definir a aparência da linha de dados num FormView controlo quando o controlo está em modo apenas de leitura. |
| SelectArguments |
Obtém um DataSourceSelectArguments objeto que o controlo data-bound usa ao recuperar dados de um controlo de fonte de dados. (Herdado de DataBoundControl) |
| SelectedValue |
Obtém o valor da chave de dados do registo atual num FormView controlo. |
| SelectMethod |
O nome do método a chamar para ler dados. (Herdado de DataBoundControl) |
| Site |
Obtém informação sobre o contentor que aloja o controlo atual quando renderizado numa superfície de design. (Herdado de Control) |
| SkinID |
Obtém ou fixa a pele para aplicar no controlo. (Herdado de WebControl) |
| Style |
Recebe uma coleção de atributos de texto que serão renderizados como um atributo de estilo na etiqueta externa do controlo do servidor Web. (Herdado de WebControl) |
| SupportsDisabledAttribute |
Obtém um valor que indica se o controlo deve definir o |
| TabIndex |
Obtém ou define o índice de tabulação do controlo do servidor Web. (Herdado de WebControl) |
| TagKey |
Obtém o HtmlTextWriterTag valor do FormView controlo. |
| TagName |
Recebe o nome da etiqueta de controlo. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl) |
| TemplateControl |
Recebe ou define uma referência ao template que contém esse controlo. (Herdado de Control) |
| TemplateSourceDirectory |
Obtém o diretório virtual do Page ou UserControl que contém o controlo atual do servidor. (Herdado de Control) |
| ToolTip |
Obtém ou define o texto exibido quando o ponteiro do rato paira sobre o controlo do servidor Web. (Herdado de WebControl) |
| TopPagerRow |
Obtém o FormViewRow objeto que representa a linha do pager apresentado no topo de um FormView controlo. |
| UniqueID |
Obtém o identificador único e hierarquicamente qualificado para o controlo do servidor. (Herdado de Control) |
| UpdateMethod |
Recebe ou define o nome do método na página que é chamado quando o controlo realiza uma operação de atualização. |
| ValidateRequestMode |
Recebe ou define um valor que indica se o controlo verifica a entrada do cliente do navegador para valores potencialmente perigosos. (Herdado de Control) |
| ViewState |
Obtém um dicionário de informação de estado que permite guardar e restaurar o estado de visualização de um controlo de servidor através de múltiplos pedidos para a mesma página. (Herdado de Control) |
| ViewStateIgnoresCase |
Obtém um valor que indica se o StateBag objeto é indistinto a maiúsculas e maiúsculas. (Herdado de Control) |
| ViewStateMode |
Obtém ou define o modo view-state deste controlo. (Herdado de Control) |
| Visible |
Recebe ou define um valor que indica se um controlo de servidor é renderizado como UI na página. (Herdado de Control) |
| Width |
Obtém ou define a largura do controlo do servidor Web. (Herdado de WebControl) |
Métodos
| Name | Description |
|---|---|
| AddAttributesToRender(HtmlTextWriter) |
Adiciona atributos e estilos HTML que precisam de ser renderizados para o especificado HtmlTextWriterTag. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl) |
| AddedControl(Control, Int32) |
Chamado após um controlo filho ser adicionado à Controls coleção do Control objeto. (Herdado de Control) |
| AddParsedSubObject(Object) |
Notifica o controlo do servidor que um elemento, seja XML ou HTML, foi analisado, e adiciona o elemento ao objeto do ControlCollection controlo do servidor. (Herdado de Control) |
| ApplyStyle(Style) |
Copia quaisquer elementos não em branco do estilo especificado para o controlo Web, sobrescrevendo quaisquer elementos de estilo existentes do controlo. Este método é usado principalmente por desenvolvedores de controlo. (Herdado de WebControl) |
| ApplyStyleSheetSkin(Page) |
Aplica as propriedades de estilo definidas na folha de estilo da página ao controlo. (Herdado de Control) |
| BeginRenderTracing(TextWriter, Object) |
Inicia o rastreio em tempo de design dos dados de renderização. (Herdado de Control) |
| BuildProfileTree(String, Boolean) |
Recolhe informações sobre o controlo do servidor e entrega-as à Trace propriedade para serem exibidas quando o rastreamento for ativado para a página. (Herdado de Control) |
| ChangeMode(FormViewMode) |
Muda o FormView controlo para o modo de introdução de dados especificado. |
| ClearCachedClientID() |
Define o valor em ClientID cache para |
| ClearChildControlState() |
Apaga a informação de estado de controlo dos controlos filhos do controlo do servidor. (Herdado de Control) |
| ClearChildState() |
Apaga a informação de view-state e control-state de todos os controlos filhos do servidor. (Herdado de Control) |
| ClearChildViewState() |
Elimina a informação de estado de visualização de todos os controlos filhos do controlo do servidor. (Herdado de Control) |
| ClearEffectiveClientIDMode() |
Define a ClientIDMode propriedade da instância de controlo atual e de qualquer controlo filho para Inherit. (Herdado de Control) |
| ConfirmInitState() |
Define o estado inicializado do controlo ligado a dados. (Herdado de BaseDataBoundControl) |
| CopyBaseAttributes(WebControl) |
Copia as propriedades não encapsuladas pelo Style objeto do controlo do servidor Web especificado para o controlo do servidor Web de onde este método é chamado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl) |
| CreateChildControls() |
Cria a hierarquia de controlo que é usada para renderizar um controlo composto com dados limitados com base nos valores armazenados no estado de visualização. (Herdado de CompositeDataBoundControl) |
| CreateChildControls(IEnumerable, Boolean) |
Cria a hierarquia de controlo usada para renderizar o FormView controlo com a fonte de dados especificada. |
| CreateControlCollection() |
Cria um novo ControlCollection objeto para armazenar os controlos filhos (tanto literais como de servidor) do controlo do servidor. (Herdado de Control) |
| CreateControlStyle() |
Cria um objeto padrão de estilo tabela para o FormView controlo. |
| CreateDataSourceSelectArguments() |
Cria o DataSourceSelectArguments objeto que contém os argumentos que são passados à fonte de dados para processamento. |
| CreateRow(Int32, DataControlRowType, DataControlRowState) |
Cria um FormViewRow objeto usando o índice do item, o tipo de linha e o estado da linha especificados. |
| CreateTable() |
Cria a tabela de contenção para o FormView controlo. |
| DataBind() |
Vincula a fonte de dados ao FormView controlo. |
| DataBind(Boolean) |
Vincula uma fonte de dados ao controlo do servidor invocado e a todos os seus controlos filhos com uma opção para elevar o DataBinding evento. (Herdado de Control) |
| DataBindChildren() |
Vincula uma fonte de dados aos controlos filhos do controlo do servidor. (Herdado de Control) |
| DeleteItem() |
Apaga o registo atual no FormView controlo da fonte de dados. |
| Dispose() |
Permite que o controlo do servidor realize a limpeza final antes de ser libertado da memória. (Herdado de Control) |
| EndRenderTracing(TextWriter, Object) |
Termina o rastreio de tempo de design dos dados de renderização. (Herdado de Control) |
| EnsureChildControls() |
Determina se o controlo do servidor contém controlos filhos. Se não o fizer, cria controlos filhos. (Herdado de Control) |
| EnsureDataBound() |
Assegura que o controlo FormView está vinculado aos dados quando apropriado. |
| EnsureID() |
Cria um identificador para controlos 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, Boolean) |
Recupera os valores de cada campo declarado dentro da linha de dados e armazena-os no objeto especificado IOrderedDictionary . |
| FindControl(String, Int32) |
Pesquisa no contentor de nomenclatura atual um controlo de servidor com o especificado |
| FindControl(String) |
Procura no contentor de nomenclatura atual um controlo de servidor com o parâmetro especificado |
| Focus() |
Define o foco de entrada num controlo. (Herdado de Control) |
| GetData() |
Recupera um DataSourceView objeto que o controlo data-bound utiliza para realizar operações de dados. (Herdado de DataBoundControl) |
| GetDataSource() |
Recupera a IDataSource interface à qual o controlo de dados está associado, se existir. (Herdado de DataBoundControl) |
| GetDesignModeState() |
Obtém dados de tempo de projeto para um controlo. (Herdado de Control) |
| GetHashCode() |
Serve como função de hash predefinida. (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 o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota. (Herdado de Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Obtém o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota. (Herdado de Control) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetUniqueIDRelativeTo(Control) |
Devolve a parte prefixada da UniqueID propriedade do controlo especificado. (Herdado de Control) |
| HasControls() |
Determina se o controlo do servidor contém algum controlo filho. (Herdado de Control) |
| HasEvents() |
Devolve um valor que indica se os eventos estão registados para o controlo ou para quaisquer controlos filhos. (Herdado de Control) |
| InitializePager(FormViewRow, PagedDataSource) |
Cria a linha do pager para o FormView controlo. |
| InitializeRow(FormViewRow) |
Inicializa o objeto especificado FormViewRow . |
| InsertItem(Boolean) |
Insere o registo atual na fonte de dados. |
| IsBindableType(Type) |
Determina se o tipo de dado especificado pode ser atribuído a um campo no FormView controlo. |
| IsLiteralContent() |
Determina se o controlo do servidor contém apenas conteúdo literal. (Herdado de Control) |
| LoadControlState(Object) |
Carrega o estado das FormView propriedades de controlo que precisam de ser mantidas, mesmo quando a EnableViewState propriedade está definida para |
| LoadViewState(Object) |
Carrega o estado de visualização previamente guardado do FormView controlo. |
| MapPathSecure(String) |
Recupera o caminho físico para o qual um caminho virtual, seja absoluto ou relativo, mapeia. (Herdado de Control) |
| MarkAsDataBound() |
Define o estado do controlo no estado de visualização como vinculado com sucesso aos dados. (Herdado de DataBoundControl) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| MergeStyle(Style) |
Copia quaisquer elementos não em branco do estilo especificado para o controlo Web, mas não sobrescreve quaisquer elementos de estilo existentes do controlo. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl) |
| ModifiedOuterTableStylePropertyName() |
Determina se as regras de estilo CSS específicas da tabela associadas ao FormView controlo estão definidas para os seus valores padrão. |
| OnBubbleEvent(Object, EventArgs) |
Trata um evento passado pela hierarquia de controlo. |
| OnCreatingModelDataSource(CreatingModelDataSourceEventArgs) |
Eleva o CreatingModelDataSource evento. (Herdado de DataBoundControl) |
| OnDataBinding(EventArgs) |
Eleva o DataBinding evento. (Herdado de Control) |
| OnDataBound(EventArgs) |
Eleva o DataBound evento. (Herdado de BaseDataBoundControl) |
| OnDataPropertyChanged() |
Volta a vincular o controlo ligado aos dados aos seus dados após uma das propriedades de identificação da fonte base de dados alterar. (Herdado de DataBoundControl) |
| OnDataSourceViewChanged(Object, EventArgs) |
Eleva o DataSourceViewChanged evento. (Herdado de DataBoundControl) |
| OnInit(EventArgs) |
Eleva o Init evento. |
| OnItemCommand(FormViewCommandEventArgs) |
Eleva o ItemCommand evento. |
| OnItemCreated(EventArgs) |
Eleva o ItemCreated evento. |
| OnItemDeleted(FormViewDeletedEventArgs) |
Eleva o ItemDeleted evento. |
| OnItemDeleting(FormViewDeleteEventArgs) |
Eleva o ItemDeleting evento. |
| OnItemInserted(FormViewInsertedEventArgs) |
Eleva o ItemInserted evento. |
| OnItemInserting(FormViewInsertEventArgs) |
Eleva o ItemInserting evento. |
| OnItemUpdated(FormViewUpdatedEventArgs) |
Eleva o ItemUpdated evento. |
| OnItemUpdating(FormViewUpdateEventArgs) |
Eleva o ItemUpdating evento. |
| OnLoad(EventArgs) |
Trata do Load evento. (Herdado de DataBoundControl) |
| OnModeChanged(EventArgs) |
Eleva o ModeChanged evento. |
| OnModeChanging(FormViewModeEventArgs) |
Eleva o ModeChanging evento. |
| OnPageIndexChanged(EventArgs) |
Eleva o PageIndexChanged evento. |
| OnPageIndexChanging(FormViewPageEventArgs) |
Eleva o PageIndexChanging evento. |
| OnPagePreLoad(Object, EventArgs) |
Define o estado inicializado do controlo ligado a dados antes de este ser carregado. (Herdado de DataBoundControl) |
| OnPreRender(EventArgs) |
Trata do PreRender evento. (Herdado de BaseDataBoundControl) |
| OnUnload(EventArgs) |
Eleva o Unload evento. (Herdado de Control) |
| OpenFile(String) |
Recebe um Stream usado para ler um ficheiro. (Herdado de Control) |
| PerformDataBinding(IEnumerable) |
Vincula a fonte de dados especificada ao FormView controlo. |
| PerformSelect() |
Recupera dados da fonte de dados associada. (Herdado de DataBoundControl) |
| PrepareControlHierarchy() |
Estabelece a hierarquia de controlo do FormView controlo. |
| RaiseBubbleEvent(Object, EventArgs) |
Atribui quaisquer fontes do evento e da sua informação ao pai do controlo. (Herdado de Control) |
| RaisePostBackEvent(String) |
Levanta os eventos apropriados para o FormView controlo quando este é enviado de volta ao servidor. |
| RemovedControl(Control) |
Chamado após um controlo filho ser removido da Controls coleção do Control objeto. (Herdado de Control) |
| Render(HtmlTextWriter) |
Mostra o FormView controlo no cliente. |
| RenderBeginTag(HtmlTextWriter) |
Renderiza a etiqueta de abertura HTML do controlo ao escritor especificado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl) |
| RenderChildren(HtmlTextWriter) |
Exporta o conteúdo dos filhos de um controlo de servidor para um objeto fornecido HtmlTextWriter , que escreve o conteúdo a ser renderizado no cliente. (Herdado de Control) |
| RenderContents(HtmlTextWriter) |
Apresenta o conteúdo do controlo ao autor especificado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter usando um objeto fornecido ControlAdapter . (Herdado de Control) |
| RenderControl(HtmlTextWriter) |
Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter e armazena informação de rastreamento sobre o controlo se o rastreio estiver ativado. (Herdado de Control) |
| RenderEndTag(HtmlTextWriter) |
Renderiza a etiqueta HTML de fecho do controlo no escritor especificado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl) |
| ResolveAdapter() |
Faz com que o adaptador de controlo seja responsável por renderizar o controlo especificado. (Herdado de Control) |
| ResolveClientUrl(String) |
Recebe um URL que pode ser usado pelo navegador. (Herdado de Control) |
| ResolveUrl(String) |
Converte uma URL numa que seja utilizável no cliente solicitante. (Herdado de Control) |
| SaveControlState() |
Guarda o estado das FormView propriedades de controlo que precisam de ser mantidas, mesmo quando a EnableViewState propriedade está definida para |
| SaveViewState() |
Guarda o estado atual de visualização do FormView controlo. |
| SetDesignModeState(IDictionary) |
Define dados em tempo de projeto para um controlo. (Herdado de Control) |
| SetPageIndex(Int32) |
Define o índice da página atualmente apresentada no FormView controlo. |
| SetRenderMethodDelegate(RenderMethod) |
Atribui um delegado handler de eventos para renderizar o controlo do servidor e o seu conteúdo no controlo pai. (Herdado de Control) |
| SetTraceData(Object, Object, Object) |
Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando o objeto rastreado, a chave de dados de traço e o valor dos dados de traço. (Herdado de Control) |
| SetTraceData(Object, Object) |
Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando a chave de dados de traço e o valor dos dados de traço. (Herdado de Control) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
| TrackViewState() |
Marca o ponto de partida para começar a registar e guardar alterações de estado de visualização no FormView controlo. |
| UpdateItem(Boolean) |
Atualiza o registo atual na fonte de dados. |
| ValidateDataSource(Object) |
Verifica se o objeto ao qual um controlo databound se liga é um com o qual pode trabalhar. (Herdado de DataBoundControl) |
evento
| Name | Description |
|---|---|
| CallingDataMethods |
Ocorre quando métodos de dados estão a ser chamados. (Herdado de DataBoundControl) |
| CreatingModelDataSource |
Ocorre quando o ModelDataSource objeto está a ser criado. (Herdado de DataBoundControl) |
| DataBinding |
Ocorre quando o controlo do servidor se liga a uma fonte de dados. (Herdado de Control) |
| DataBound |
Ocorre depois de o controlo do servidor se ligar a uma fonte de dados. (Herdado de BaseDataBoundControl) |
| Disposed |
Ocorre quando um controlo de servidor é libertado da memória, que é a última etapa do ciclo de vida do controlo do servidor quando uma página ASP.NET é solicitada. (Herdado de Control) |
| Init |
Ocorre quando o controlo do servidor é inicializado, que é o primeiro passo no seu ciclo de vida. (Herdado de Control) |
| ItemCommand |
Ocorre quando um botão dentro de um FormView controlo é pressionado. |
| ItemCreated |
Ocorre depois de todas as linhas serem criadas num FormView controlo. |
| ItemDeleted |
Ocorre quando se clica num botão Delete dentro de um FormView controlo, mas após a operação de eliminação. |
| ItemDeleting |
Ocorre quando um botão Delete dentro de um FormView controlo é clicado, mas antes da operação de eliminação. |
| ItemInserted |
Ocorre quando um botão de Inserir dentro de um FormView controlo é clicado, mas após a operação de inserção. |
| ItemInserting |
Ocorre quando um botão de Inserir dentro de um FormView controlo é clicado, mas antes da operação de inserção. |
| ItemUpdated |
Ocorre quando um botão de Atualização dentro de um FormView controlo é clicado, mas após a operação de atualização. |
| ItemUpdating |
Ocorre quando um botão de Atualização dentro de um FormView controlo é clicado, mas antes da operação de atualização. |
| Load |
Ocorre quando o controlo do servidor é carregado no Page objeto. (Herdado de Control) |
| ModeChanged |
Ocorre quando o controlo FormView alterna entre editar, inserir e modo apenas leitura, mas depois de o modo ter mudado. |
| ModeChanging |
Ocorre quando o controlo FormView alterna entre editar, inserir e modo apenas leitura, mas antes de o modo mudar. |
| PageIndexChanged |
Ocorre quando o valor da PageIndex propriedade muda após uma operação de paginação. |
| PageIndexChanging |
Ocorre quando o valor da PageIndex propriedade muda antes de uma operação de paginação. |
| PreRender |
Ocorre depois do carregamento do Control objeto, mas antes da renderização. (Herdado de Control) |
| Unload |
Ocorre quando o controlo do servidor é descarregado da memória. (Herdado de Control) |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| IAttributeAccessor.GetAttribute(String) |
Recebe um atributo do controlo Web com o nome especificado. (Herdado de WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Define um atributo do controlo Web ao nome e valor especificados. (Herdado de WebControl) |
| IControlBuilderAccessor.ControlBuilder |
Para uma descrição deste elemento, veja ControlBuilder. (Herdado de Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Para uma descrição deste elemento, veja GetDesignModeState(). (Herdado de Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Para uma descrição deste elemento, veja SetDesignModeState(IDictionary). (Herdado de Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Para uma descrição deste elemento, veja SetOwnerControl(Control). (Herdado de Control) |
| IControlDesignerAccessor.UserData |
Para uma descrição deste elemento, veja UserData. (Herdado de Control) |
| IDataBindingsAccessor.DataBindings |
Para uma descrição deste elemento, veja DataBindings. (Herdado de Control) |
| IDataBindingsAccessor.HasDataBindings |
Para uma descrição deste elemento, veja HasDataBindings. (Herdado de Control) |
| IDataBoundControl.DataKeyNames |
Obtém ou define um array que contém os nomes dos campos de chave primária dos itens que são apresentados no FormView controlo. |
| IDataBoundControl.DataMember |
Obtém ou define o nome da lista de itens de dados a que o FormView controlo se associa quando a fonte de dados contém mais do que uma lista de itens de dados. |
| IDataBoundControl.DataSource |
Obtém ou define o objeto que contém a lista de dados que o FormView controlo recupera. |
| IDataBoundControl.DataSourceID |
Obtém ou define o ID do controlo de fontes de dados que contém a lista de itens de dados que o FormView controlo recupera. |
| IDataBoundControl.DataSourceObject |
Obtém o objeto fonte de dados que contém a lista de itens de dados que o FormView controlo recupera. |
| IDataBoundItemControl.DataKey |
Obtém o objeto que representa o valor da chave de dados da linha no FormView controlo. |
| IDataBoundItemControl.Mode |
Obtém o modo atual do FormView controlo. |
| IDataItemContainer.DataItemIndex |
Para uma descrição deste elemento, veja DataItemIndex. |
| IDataItemContainer.DisplayIndex |
Para uma descrição deste elemento, veja DisplayIndex. |
| IExpressionsAccessor.Expressions |
Para uma descrição deste elemento, veja Expressions. (Herdado de Control) |
| IExpressionsAccessor.HasExpressions |
Para uma descrição deste elemento, veja HasExpressions. (Herdado de Control) |
| IParserAccessor.AddParsedSubObject(Object) |
Para uma descrição deste elemento, veja AddParsedSubObject(Object). (Herdado de Control) |
| IPostBackContainer.GetPostBackOptions(IButtonControl) |
Determina as opções de evento de postback para o FormView controlo. |
| IPostBackEventHandler.RaisePostBackEvent(String) |
Levanta eventos para o FormView controlo quando este é enviado de volta ao servidor. |
Métodos da Extensão
| Name | Description |
|---|---|
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado. |
| EnableDynamicData(INamingContainer, Type, Object) |
Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado. |
| EnableDynamicData(INamingContainer, Type) |
Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado. |
| EnablePersistedSelection(BaseDataBoundControl) |
Obsoleto.
Permite que a seleção seja mantida em controlos de dados que suportam a seleção e a paginação. |
| FindDataSourceControl(Control) |
Devolve a fonte de dados associada ao controlo de dados para o controlo especificado. |
| FindFieldTemplate(Control, String) |
Devolve o modelo de campo para a coluna especificada no contentor de nomenclatura do controlo especificado. |
| FindMetaTable(Control) |
Devolve o objeto metatable para o controlo de dados que contém. |
| GetDefaultValues(INamingContainer) |
Obtém a recolha dos valores padrão para o controlo de dados especificado. |
| GetMetaTable(INamingContainer) |
Obtém os metadados da tabela para o controlo de dados especificado. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Define os metadados da tabela e o mapeamento de valores padrão para o controlo de dados especificado. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Define os metadados da tabela e o mapeamento de valores padrão para o controlo de dados especificado. |
| SetMetaTable(INamingContainer, MetaTable) |
Define os metadados da tabela para o controlo de dados especificado. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Determina se os metadados da tabela estão disponíveis. |
Aplica-se a
Ver também
- DetailsView
- GridView
- FormViewRow
- FormViewMode
- AccessDataSource
- SqlDataSource
- ObjectDataSource
- AllowPaging
- CurrentMode
- DataKeyNames
- DefaultMode
- PagerStyle
- PagerSettings
- EditRowStyle
- EmptyDataRowStyle
- FooterStyle
- HeaderStyle
- InsertRowStyle
- RowStyle
- EditItemTemplate
- EmptyDataTemplate
- FooterTemplate
- HeaderTemplate
- InsertItemTemplate
- ItemTemplate
- PagerTemplate
- ItemCreated
- ItemCommand
- ItemDeleted
- ItemDeleting
- ItemInserted
- ItemInserting
- ItemUpdated
- ItemUpdating
- ModeChanged
- ModeChanging
- PageIndexChanged
- PageIndexChanging