Sdílet prostřednictvím

CommandField Třída

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Představuje speciální pole, které zobrazuje příkazová tlačítka pro provádění výběrů, úprav, vkládání nebo odstraňování operací v ovládacím prvku vázaném na data.

public ref class CommandField : System::Web::UI::WebControls::ButtonFieldBase
public class CommandField : System.Web.UI.WebControls.ButtonFieldBase
type CommandField = class
    inherit ButtonFieldBase
Public Class CommandField
Inherits ButtonFieldBase
Dědičnost
Object
DataControlField
ButtonFieldBase
CommandField

Příklady

Následující příklad kódu ukazuje použití CommandField pole k zobrazení ovládacích prvků k úpravě záznamu v ovládacím GridView prvku.


<%@ 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:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        datakeynames="CustomerID"  
        runat="server">
        
        <columns>
          <asp:commandfield showeditbutton="true"
            headertext="Edit Controls"/>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID" />
          <asp:boundfield datafield="CompanyName"
            headertext="Company Name"/>
          <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"/>
        </columns>
        
      </asp:gridview>
            
      <!-- 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]"
        updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
        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:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        datakeynames="CustomerID"  
        runat="server">
        
        <columns>
          <asp:commandfield showeditbutton="true"
            headertext="Edit Controls"/>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID" />
          <asp:boundfield datafield="CompanyName"
            headertext="Company Name"/>
          <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"/>
        </columns>
        
      </asp:gridview>
            
      <!-- 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]"
        updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

Následující příklad kódu ukazuje, jak použít CancelText, EditTexta UpdateText vlastnosti přizpůsobit text pro ovládací prvky pro úpravy.


<%@ 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:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        datakeynames="CustomerID"  
        runat="server">
        
        <columns>
          <asp:commandfield showeditbutton="true"
            edittext="Edit Customer"
            canceltext="Discard"
            updatetext="Revise"
            headertext="Edit Controls"/>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID" />
          <asp:boundfield datafield="CompanyName"
            headertext="Company Name"/>
          <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"/>
        </columns>
        
      </asp:gridview>
            
      <!-- 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]"
        updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
        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:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        datakeynames="CustomerID"  
        runat="server">
        
        <columns>
          <asp:commandfield showeditbutton="true"
            edittext="Edit Customer"
            canceltext="Discard"
            updatetext="Revise"
            headertext="Edit Controls"/>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID" />
          <asp:boundfield datafield="CompanyName"
            headertext="Company Name"/>
          <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"/>
        </columns>
        
      </asp:gridview>
            
      <!-- 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]"
        updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

Poznámky

Třída CommandField je speciální pole, které používají ovládací prvky vázané na data (například GridView a DetailsView) k zobrazení příkazových tlačítek, která provádějí operace odstranění, úpravy, vložení nebo výběr. Příkazová tlačítka pro provedení těchto operací se dají zobrazit nebo skrýt pomocí vlastností zobrazených v následující tabulce.

Vlastnost Popis
ShowDeleteButton Zobrazí nebo skryje tlačítko Delete v CommandField poli pro každý záznam v ovládacím prvku vázaném na data. Tlačítko Odstranit umožňuje uživateli odstranit záznam ze zdroje dat.
ShowEditButton Zobrazí nebo skryje tlačítko Upravit v CommandField poli pro každý záznam v ovládacím prvku vázaném na data. Tlačítko Upravit umožňuje uživateli upravit záznam ze zdroje dat. Když uživatel klikne na tlačítko Upravit pro konkrétní záznam, nahradí se toto tlačítko Upravit tlačítkem Aktualizovat a tlačítkem Zrušit. Všechna ostatní příkazová tlačítka jsou také skrytá.
ShowInsertButton Zobrazí nebo skryje tlačítko Nový v CommandField poli. Tlačítko Nový umožňuje uživateli vložit nový záznam do zdroje dat. Když uživatel klikne na tlačítko Nový, nahradí se tlačítkem Vložit a tlačítkem Storno. Všechna ostatní příkazová tlačítka jsou také skrytá. Poznámka: Tato vlastnost se vztahuje pouze na ovládací prvky vázané na data, které podporují operace vkládání, jako DetailsView je například ovládací prvek.
ShowSelectButton Zobrazí nebo skryje tlačítko Vybrat v CommandField poli pro každý záznam v ovládacím prvku vázaném na data. Tlačítko Vybrat umožňuje uživateli vybrat záznam v ovládacím prvku vázaném na data.

Tlačítko Storno se navíc zobrazí, když je záznam v režimu úprav nebo vložení, můžete zobrazit nebo skrýt nastavením ShowCancelButton vlastnosti.

Poznámka

Při použití ovládacího prvku vázaného na data v kombinaci s ovládacím prvku 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 funkce automatického odstranění, aktualizace a vložení. U jiných zdrojů dat je potřeba poskytnout rutiny, které tyto operace provádějí během vhodných událostí pro ovládací prvek vázané na data.

Pole CommandField se zobrazuje odlišně v závislosti na ovládacím prvku vázaném na data, ve kterém se používá. Ovládací prvek například GridView zobrazí CommandField pole jako sloupec, zatímco ovládací DetailsView prvek ho zobrazí jako řádek.

Chcete-li určit typ tlačítka, který se má zobrazit, použijte ButtonType vlastnost. ButtonType Pokud je vlastnost nastavena na ButtonType.Button nebo ButtonType.Link, můžete zadat text, který se má zobrazit pro tlačítka nastavením vlastností zobrazených v následující tabulce.

Vlastnost Popis
CancelText Titulek tlačítka Zrušit
DeleteText Titulek tlačítka Odstranit
EditText Titulek tlačítka Upravit
InsertText Titulek tlačítka Vložit 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.
NewText Titulek tlačítka Nový 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.
SelectText Titulek tlačítka Vybrat
UpdateText Titulek tlačítka Aktualizovat

Místo zobrazení příkazového tlačítka nebo tlačítka odkazu můžete zobrazit tlačítko obrázku nastavením ButtonType vlastnosti a ButtonType.Image následným nastavením vlastností zobrazených v následující tabulce.

Vlastnost Popis
CancelImageUrl Obrázek, který se má zobrazit pro tlačítko Zrušit
DeleteImageUrl Obrázek, který se má zobrazit pro tlačítko Odstranit
EditImageUrl Obrázek, který se má zobrazit pro tlačítko Upravit
InsertText Obrázek, který se má zobrazit pro tlačítko Vložit 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.
NewImageUrl Obrázek, který se má zobrazit pro tlačítko Nový 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.
SelectImageUrl Obrázek, který se má zobrazit pro tlačítko Vybrat
UpdateImageUrl Obrázek, který se má zobrazit pro tlačítko Aktualizovat

Když uživatel ve výchozím nastavení klikne na tlačítko v CommandField poli, provede se ověření u všech ověřovacích ovládacích prvků na stránce. Chcete-li zabránit, aby při kliknutí na tlačítko došlo k ověření, nastavte CausesValidation vlastnost na false.

Pole v ovládacím prvku vázaném na data můžete skrýt CommandField nastavením Visible vlastnosti na false.

Pole CommandField umožňuje přizpůsobit oddíly záhlaví a zápatí. Chcete-li zobrazit titulek v záhlaví nebo oddílu zápatí, nastavte nebo HeaderText FooterText vlastnost v uvedeném pořadí. Místo zobrazení textu v oddílu záhlaví můžete obrázek zobrazit nastavením HeaderImageUrl vlastnosti. Chcete-li skrýt oddíl záhlaví v objektu CommandField , nastavte ShowHeader vlastnost na false.

Poznámka

Některé ovládací prvky vázané na data (například GridView ovládací prvek) můžou zobrazit nebo skrýt jenom celý oddíl záhlaví ovládacího prvku. Tyto ovládací prvky vázané na data nepodporují ShowHeader vlastnost pro jednotlivá pole tlačítka. Pokud chcete zobrazit nebo skrýt celý oddíl záhlaví ovládacího prvku vázaného na data (pokud je k dispozici), použijte vlastnost ovládacího prvku ShowHeader .

Vzhled objektu CommandField (barva písma, barva pozadí atd.) můžete také přizpůsobit nastavením vlastností stylu pro různé části pole. Následující tabulka uvádí různé vlastnosti stylu.

Vlastnost stylu Description
ControlStyle Nastavení stylu podřízených ovládacích prvků webového serveru objektu CommandField .
FooterStyle Nastavení stylu pro oddíl zápatí objektu CommandField .
HeaderStyle Nastavení stylu pro oddíl záhlaví objektu CommandField .
ItemStyle Nastavení stylu datových položek v objektu CommandField .

Konstruktory

CommandField()

Inicializuje novou instanci CommandField třídy.

Vlastnosti

AccessibleHeaderText

Získá nebo nastaví text, který je vykreslen jako AbbreviatedText hodnota vlastnosti v některých ovládacích prvcích.

(Zděděno od DataControlField)
ButtonType

Získá nebo nastaví typ tlačítka, který se zobrazí v poli tlačítka.

(Zděděno od ButtonFieldBase)
CancelImageUrl

Získá nebo nastaví adresu URL na obrázek, který se zobrazí pro tlačítko Zrušit v CommandField poli.
CancelText

Získá nebo nastaví titulek tlačítka Zrušit zobrazené v CommandField poli.
CausesValidation

Získá nebo nastaví hodnotu označující, zda je ověření provedeno, když uživatel klikne na tlačítko v CommandField poli.
Control

Získá odkaz na ovládací prvek dat, ke kterému DataControlField je objekt přidružen.

(Zděděno od DataControlField)
ControlStyle

Získá styl všech webových server ovládacích prvků obsažených objektem DataControlField .

(Zděděno od DataControlField)
DeleteImageUrl

Získá nebo nastaví adresu URL na obrázek, který se zobrazí pro tlačítko Odstranit v CommandField poli.
DeleteText

Získá nebo nastaví titulek tlačítka Odstranit v CommandField poli.
DesignMode

Získá hodnotu označující, zda je pole ovládacího prvku dat aktuálně zobrazeno v návrhovém prostředí.

(Zděděno od DataControlField)
EditImageUrl

Získá nebo nastaví adresu URL na obrázek, který se zobrazí pro tlačítko Upravit v CommandField poli.
EditText

Získá nebo nastaví titulek tlačítka Upravit v CommandField poli.
FooterStyle

Získá nebo nastaví styl zápatí pole ovládacího prvku dat.

(Zděděno od DataControlField)
FooterText

Získá nebo nastaví text, který je zobrazen v zápatí položky pole ovládacího prvku dat.

(Zděděno od DataControlField)
HeaderImageUrl

Získá nebo nastaví adresu URL obrázku, který se zobrazí v položce záhlaví pole ovládacího prvku dat.

(Zděděno od DataControlField)
HeaderStyle

Získá nebo nastaví styl záhlaví pole ovládacího prvku dat.

(Zděděno od DataControlField)
HeaderText

Získá nebo nastaví text zobrazený v položce záhlaví pole ovládacího prvku dat.

(Zděděno od DataControlField)
InsertImageUrl

Získá nebo nastaví adresu URL na obrázek, který se zobrazí pro tlačítko Vložit v CommandField poli.
InsertText

Získá nebo nastaví titulek tlačítka Vložit do CommandField pole.
InsertVisible

Získá hodnotu označující, zda DataControlField je objekt viditelný, když je nadřazený ovládací prvek vázané na data v režimu vložení.

(Zděděno od DataControlField)
IsTrackingViewState

Získá hodnotu určující, zda DataControlField objekt ukládá změny do stavu zobrazení.

(Zděděno od DataControlField)
ItemStyle

Získá styl libovolného textového obsahu zobrazeného polem ovládacího prvku dat.

(Zděděno od DataControlField)
NewImageUrl

Získá nebo nastaví adresu URL na obrázek, který se zobrazí pro tlačítko Nový v CommandField poli.
NewText

Získá nebo nastaví titulek tlačítka Nový v CommandField poli.
SelectImageUrl

Získá nebo nastaví adresu URL na obrázek, který se zobrazí pro tlačítko Vybrat v CommandField poli.
SelectText

Získá nebo nastaví titulek tlačítka Vybrat v CommandField poli.
ShowCancelButton

Získá nebo nastaví hodnotu označující, zda je tlačítko Storno zobrazeno v CommandField poli.
ShowDeleteButton

Získá nebo nastaví hodnotu určující, zda je tlačítko Odstranit zobrazeno v CommandField poli.
ShowEditButton

Získá nebo nastaví hodnotu označující, jestli se tlačítko Upravit zobrazí v CommandField poli.
ShowHeader

Získá nebo nastaví hodnotu označující, zda je oddíl záhlaví zobrazen v objektu ButtonFieldBase .

(Zděděno od ButtonFieldBase)
ShowInsertButton

Získá nebo nastaví hodnotu určující, zda je tlačítko Nový zobrazeno v CommandField poli.
ShowSelectButton

Získá nebo nastaví hodnotu označující, jestli se tlačítko Vybrat zobrazí v CommandField poli.
SortExpression

Získá nebo nastaví výraz řazení, který používá ovládací prvek zdroje dat k řazení dat.

(Zděděno od DataControlField)
UpdateImageUrl

Získá nebo nastaví adresu URL na obrázek, který se má zobrazit pro tlačítko Aktualizovat v CommandField poli.
UpdateText

Získá nebo nastaví titulek tlačítka Aktualizovat v CommandField poli.
ValidateRequestMode

Získá nebo nastaví hodnotu, která určuje, zda ovládací prvek ověřuje vstup klienta.

(Zděděno od DataControlField)
ValidationGroup

Získá nebo nastaví název skupiny ověřovacích ovládacích prvků k ověření při kliknutí na tlačítko v objektu ButtonFieldBase .

(Zděděno od ButtonFieldBase)
ViewState

Získá slovník informací o stavu, který umožňuje uložit a obnovit stav DataControlField zobrazení objektu napříč více požadavky na stejnou stránku.

(Zděděno od DataControlField)
Visible

Získá nebo nastaví hodnotu označující, zda je pole ovládacího prvku dat vykresleno.

(Zděděno od DataControlField)

Metody

CloneField()

Vytvoří duplicitní kopii aktuálního DataControlFieldodvozeného objektu.

(Zděděno od DataControlField)
CopyProperties(DataControlField)

Zkopíruje vlastnosti aktuálního CommandField objektu do zadaného DataControlField objektu.
CreateField()

Vytvoří prázdný CommandField objekt.
Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Extrahuje hodnotu pole ovládacího prvku dat z aktuální buňky tabulky a přidá hodnotu do zadané IDictionary kolekce.

(Zděděno od DataControlField)
GetHashCode()

Slouží jako výchozí funkce hash.

(Zděděno od Object)
GetType()

Type Získá aktuální instanci.

(Zděděno od Object)
Initialize(Boolean, Control)

Provede základní inicializaci instance pro pole ovládacího prvku dat.

(Zděděno od DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Inicializuje zadaný DataControlFieldCell objekt do zadaného stavu řádku.
LoadViewState(Object)

Obnoví dříve uložený stav zobrazení zdroje dat.

(Zděděno od DataControlField)
MemberwiseClone()

Vytvoří použádnou kopii aktuálního souboru Object.

(Zděděno od Object)
OnFieldChanged()

Vyvolá FieldChanged událost.

(Zděděno od DataControlField)
SaveViewState()

Uloží změny provedené ve DataControlField stavu zobrazení od doby, kdy byla stránka publikována zpět na server.

(Zděděno od DataControlField)
ToString()

Vrátí řetězec, který představuje tento DataControlField objekt.

(Zděděno od DataControlField)
TrackViewState()

Způsobí, DataControlField že objekt bude sledovat změny ve stavu zobrazení, aby je bylo možné uložit do vlastnosti ovládacího prvku ViewState a zachovat napříč požadavky na stejnou stránku.

(Zděděno od DataControlField)
ValidateSupportsCallback()

Určuje, zda ovládací prvky obsažené v objektu CommandField podporují zpětné volání.

Explicitní implementace rozhraní

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Získá nebo nastaví schéma přidružené k tomuto DataControlField objektu.

(Zděděno od DataControlField)
IStateManager.IsTrackingViewState

Získá hodnotu označující, zda DataControlField objekt ukládá změny do stavu zobrazení.

(Zděděno od DataControlField)
IStateManager.LoadViewState(Object)

Obnoví dříve uložený stav zobrazení pole ovládacího prvku dat.

(Zděděno od DataControlField)
IStateManager.SaveViewState()

Uloží změny provedené ve DataControlField stavu zobrazení od doby, kdy byla stránka publikována zpět na server.

(Zděděno od DataControlField)
IStateManager.TrackViewState()

Způsobí, DataControlField že objekt bude sledovat změny ve stavu zobrazení, aby je bylo možné uložit do vlastnosti ovládacího prvku ViewState a zachovat napříč požadavky na stejnou stránku.

(Zděděno od DataControlField)

Platí pro

Viz také