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 určující, zda je tlačítko Nový zobrazen v CommandField poli.
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 chcete-li zobrazit tlačítko Nový v objektu CommandField; v opačném případě false. Výchozí hodnota je false.
Příklady
Následující příklad kódu ukazuje, jak pomocí ShowInsertButton vlastnosti zobrazit tlačítko Nový v ovládacím DetailsView prvku, což 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 můžete určit, zda je tlačítko Nový zobrazeno v CommandField poli. Tlačítko Nový se zobrazí pouze jednou v CommandField poli a umožní 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 DetailsView je například ovládací 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 tlačítkem Zrušit a všechny 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 Storno operaci zrušíte.
Poznámka:
Při použití ovládacího prvku vázaného na data v kombinaci s ovládacím prvek zdroje dat (například SqlDataSource ovládací prvek), může ovládací prvek svázaný s daty využívat možnosti ovládacího prvku zdroje dat a poskytovat funkci automatického vložení. U jiných zdrojů dat je nutné zadat rutiny pro provedení operace vložení během příslušné události pro ovládací prvek svázaný s daty.
ButtonType Pokud je vlastnost CommandField pole nastavena nebo ButtonType.ButtonButtonType.Link, použijte NewText vlastnost k určení textu, který se má zobrazit pro tlačítko Nový. Případně můžete obrázek zobrazit tak ButtonType , že nejprve nastavíte vlastnost na ButtonType.Image vlastnost a pak ji nastavíte NewImageUrl .
