CommandField.ShowInsertButton Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví hodnotu označující, zda je v poli zobrazen CommandField tlačítko Nový.
public:
virtual property bool ShowInsertButton { bool get(); void set(bool value); };public virtual bool ShowInsertButton { get; set; }member this.ShowInsertButton : bool with get, setPublic Overridable Property ShowInsertButton As BooleanHodnota vlastnosti
true pro zobrazení tlačítka Nový v objektu CommandField; v opačném případě false. Výchozí formát je false.
Příklady
Následující příklad kódu ukazuje, jak použít ShowInsertButton vlastnost k zobrazení tlačítka Nový v ovládacím DetailsView prvku, který uživateli umožňuje přidat nový záznam do zdroje dat.
<%@ 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>CommandField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>CommandField Example</h3>
<asp:detailsview id="CustomersGridView"
datasourceid="CustomersSqlDataSource"
autogeneraterows="false"
datakeynames="CustomerID"
allowpaging="true"
runat="server">
<fields>
<asp:boundfield datafield="CustomerID"
headertext="Customer ID" />
<asp:boundfield datafield="CompanyName"
headertext="CompanyName"/>
<asp:boundfield datafield="Address"
headertext="Address"/>
<asp:boundfield datafield="City"
headertext="City"/>
<asp:boundfield datafield="PostalCode"
headertext="ZIP Code"/>
<asp:boundfield datafield="Country"
headertext="Country"/>
<asp:commandfield showinsertbutton="true"
showheader="true"
headertext="Add Customer"/>
</fields>
</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="CustomersSqlDataSource"
selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
insertcommand="Insert Into [Customers]([CustomerID], [CompanyName], [City], [PostalCode], [Country]) Values (@CustomerID, @CompanyName, @City, @PostalCode, @Country)"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server">
</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>CommandField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>CommandField Example</h3>
<asp:detailsview id="CustomersGridView"
datasourceid="CustomersSqlDataSource"
autogeneraterows="false"
datakeynames="CustomerID"
allowpaging="true"
runat="server">
<fields>
<asp:boundfield datafield="CustomerID"
headertext="Customer ID" />
<asp:boundfield datafield="CompanyName"
headertext="CompanyName"/>
<asp:boundfield datafield="Address"
headertext="Address"/>
<asp:boundfield datafield="City"
headertext="City"/>
<asp:boundfield datafield="PostalCode"
headertext="ZIP Code"/>
<asp:boundfield datafield="Country"
headertext="Country"/>
<asp:commandfield showinsertbutton="true"
showheader="true"
headertext="Add Customer"/>
</fields>
</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="CustomersSqlDataSource"
selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
insertcommand="Insert Into [Customers]([CustomerID], [CompanyName], [City], [PostalCode], [Country]) Values (@CustomerID, @CompanyName, @City, @PostalCode, @Country)"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
Poznámky
ShowInsertButton Pomocí vlastnosti určete, zda se má v CommandField poli zobrazit tlačítko Nový. Tlačítko Nový se v CommandField poli zobrazí pouze jednou a umožňuje uživateli přidat nový záznam do zdroje dat.
Poznámka
Tato vlastnost se vztahuje pouze na ovládací prvky vázané na data, které podporují operace vložení, jako je například ovládací DetailsView prvek.
Když uživatel klikne na tlačítko Nový, zobrazí se vstupní ovládací prvky pro každé pole zobrazené v ovládacím prvku vázaném na data, což uživateli umožní zadat hodnoty nového záznamu. Tlačítko Nový se nahradí tlačítkem Vložit a Zrušit a všechna ostatní příkazová tlačítka v CommandField poli jsou skrytá. Kliknutím na tlačítko Vložit přidáte záznam do zdroje dat, zatímco kliknutím na tlačítko Zrušit operaci zrušíte.
Poznámka
Pokud se ovládací prvek vázaný na data používá v kombinaci s ovládacím prvek zdroje dat (například ovládací prvek SqlDataSource ), může tento ovládací prvek vázané na data využívat možnosti ovládacího prvku zdroje dat a poskytovat funkce automatického vkládání. Pro jiné zdroje dat je nutné zadat rutiny pro provedení operace vložení během příslušné události pro ovládací prvek vázané na data.
ButtonType Pokud je vlastnost pole nastavena CommandField na ButtonType.Button nebo ButtonType.Link, pomocí NewText vlastnosti určete text, který se má zobrazit pro tlačítko Nový. Případně můžete obrázek zobrazit tak, že nejprve nastavíte ButtonType vlastnost na ButtonType.Image a pak nastavíte NewImageUrl vlastnost.
