DetailsViewMode Enumerazione
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta le diverse modalità di immissione dati di un controllo DetailsView.
public enum class DetailsViewMode
public enum DetailsViewMode
type DetailsViewMode =
Public Enum DetailsViewMode
- Ereditarietà
Campi
Edit | 1 | Modalità di modifica che consente all'utente di aggiornare i valori di un record esistente. |
Insert | 2 | Modalità di inserimento che consente all'utente di immettere i valori per un nuovo record. |
ReadOnly | 0 | Modalità di visualizzazione che impedisce all'utente di modificare i valori di un record. |
Esempio
Nell'esempio di codice seguente viene illustrato come mantenere il DetailsView controllo in modalità di modifica dopo un'operazione di aggiornamento impostando la DefaultMode proprietà su DetailsViewMode.Edit
.
<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>DetailsView DefaultMode Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>DetailsView DefaultMode Example</h3>
<asp:detailsview id="CustomerDetailView"
datasourceid="DetailsViewSource"
datakeynames="CustomerID"
autogenerateeditbutton="true"
autogeneraterows="true"
allowpaging="true"
defaultmode="Edit"
runat="server">
<headerstyle backcolor="Navy"
forecolor="White"/>
</asp:detailsview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the web.config file. -->
<asp:SqlDataSource ID="DetailsViewSource" runat="server"
ConnectionString=
"<%$ ConnectionStrings:NorthWindConnectionString%>"
InsertCommand="INSERT INTO [Customers]([CustomerID],
[CompanyName], [Address], [City], [PostalCode], [Country])
VALUES (@CustomerID, @CompanyName, @Address, @City,
@PostalCode, @Country)"
SelectCommand="Select [CustomerID], [CompanyName],
[Address], [City], [PostalCode], [Country] From
[Customers]">
</asp:SqlDataSource>
</form>
</body>
</html>
<%@ Page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>DetailsView DefaultMode Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>DetailsView DefaultMode Example</h3>
<asp:detailsview id="CustomerDetailView"
datasourceid="DetailsViewSource"
datakeynames="CustomerID"
autogenerateeditbutton="true"
autogeneraterows="true"
allowpaging="true"
defaultmode="Edit"
runat="server">
<headerstyle backcolor="Navy"
forecolor="White"/>
</asp:detailsview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the web.config file. -->
<asp:SqlDataSource ID="DetailsViewSource" runat="server"
ConnectionString=
"<%$ ConnectionStrings:NorthWindConnectionString%>"
InsertCommand="INSERT INTO [Customers]([CustomerID],
[CompanyName], [Address], [City], [PostalCode], [Country])
VALUES (@CustomerID, @CompanyName, @Address, @City,
@PostalCode, @Country)"
SelectCommand="Select [CustomerID], [CompanyName],
[Address], [City], [PostalCode], [Country] From
[Customers]">
</asp:SqlDataSource>
</form>
</body>
</html>
Commenti
L'enumerazione DetailsViewMode viene utilizzata per rappresentare le modalità di immissione dei dati di un DetailsView controllo. Per determinare la modalità corrente del controllo, utilizzare la CurrentMode proprietà . Dopo un'operazione di inserimento o aggiornamento, il DetailsView controllo torna alla modalità specificata dalla DefaultMode proprietà . Per impostazione predefinita, il controllo torna alla modalità di sola lettura. È possibile specificare una modalità alternativa a cui tornare impostando la DefaultMode proprietà . Per modificare le modalità a livello di codice, usare il ChangeMode metodo . Quando il DetailsView controllo cambia modalità, vengono generati gli eventi nella tabella seguente.
event | Descrizione |
---|---|
ModeChanging | Si verifica quando un DetailsView controllo tenta di passare dalla modalità di modifica, inserimento e sola lettura, ma prima che la modalità venga effettivamente modificata. Questo evento viene spesso usato per annullare una modifica della modalità. |
ModeChanged | Si verifica dopo la modifica, l'inserimento o la modalità di sola lettura di un DetailsView controllo a un'altra modalità. Questo evento viene spesso usato per eseguire un'attività quando il DetailsView controllo cambia modalità. |