Tento článek byl přeložený strojově. Pokud chcete zobrazit článek v angličtině, zaškrtněte políčko Angličtina. Anglickou verzi článku můžete také zobrazit v místním okně přesunutím ukazatele myši nad text.
Překlad
Angličtina

Třída CommandField

.NET Framework (current version)
 

Publikováno: duben 2016

Představuje zvláštní pole, které příkazová tlačítka provádět výběr, úpravy, vložení nebo odstranění operací v ovládacím prvku vázané na data.

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


public class CommandField : ButtonFieldBase

NázevPopis
System_CAPS_pubmethodCommandField()

Inicializuje novou instanci CommandField třídy.

NázevPopis
System_CAPS_pubpropertyAccessibleHeaderText

Získá nebo nastaví text, který je vykreslen jako AbbreviatedText hodnotou vlastnosti v některé ovládací prvky.(Zděděno z DataControlField.)

System_CAPS_pubpropertyButtonType

Získá nebo nastaví typ tlačítka pro zobrazení v poli tlačítko.(Zděděno z ButtonFieldBase.)

System_CAPS_pubpropertyCancelImageUrl

Získá nebo nastaví adresu URL obrázku pro tlačítko Storno v zobrazení CommandField pole.

System_CAPS_pubpropertyCancelText

Získá nebo nastaví popisek pro tlačítko Storno, které jsou zobrazeny v CommandField pole.

System_CAPS_pubpropertyCausesValidation

Získá nebo nastaví hodnotu určující, zda je provedeno ověření, když uživatel klikne na tlačítko v CommandField pole.(Přepisuje ButtonFieldBase.CausesValidation.)

System_CAPS_protpropertyControl

Získá odkaz na ovládací prvek dat, který DataControlField objekt přidružen.(Zděděno z DataControlField.)

System_CAPS_pubpropertyControlStyle

Získá styl všechny ovládací prvky webového serveru obsažený DataControlField objektu.(Zděděno z DataControlField.)

System_CAPS_pubpropertyDeleteImageUrl

Získá nebo nastaví adresu URL obrázku pro tlačítko Odstranit v zobrazení CommandField pole.

System_CAPS_pubpropertyDeleteText

Získá nebo nastaví popisek pro tlačítko Odstranit v CommandField pole.

System_CAPS_protpropertyDesignMode

Získává hodnotu určující, zda je pole ovládacího prvku dat aktuálně zobrazeného v prostředí návrhu.(Zděděno z DataControlField.)

System_CAPS_pubpropertyEditImageUrl

Získá nebo nastaví adresu URL obrázku pro tlačítko pro úpravy v zobrazení CommandField pole.

System_CAPS_pubpropertyEditText

Získá nebo nastaví popisek pro tlačítko pro úpravy v CommandField pole.

System_CAPS_pubpropertyFooterStyle

Získá nebo nastaví styl zápatí datové ovládací prvek pole.(Zděděno z DataControlField.)

System_CAPS_pubpropertyFooterText

Získá nebo nastaví text, který se zobrazí v položce zápatí pole data ovládacího prvku.(Zděděno z DataControlField.)

System_CAPS_pubpropertyHeaderImageUrl

Získá nebo nastaví adresu URL bitovou kopii, která se zobrazí v položce záhlaví pole data ovládacího prvku.(Zděděno z DataControlField.)

System_CAPS_pubpropertyHeaderStyle

Získá nebo nastaví styl záhlaví pole data ovládacího prvku.(Zděděno z DataControlField.)

System_CAPS_pubpropertyHeaderText

Získá nebo nastaví text, který se zobrazí v položce záhlaví pole data ovládacího prvku.(Zděděno z DataControlField.)

System_CAPS_pubpropertyInsertImageUrl

Získá nebo nastaví adresu URL obrázku pro tlačítko Vložit v zobrazení CommandField pole.

System_CAPS_pubpropertyInsertText

Získá nebo nastaví popisek pro tlačítko Vložit v CommandField pole.

System_CAPS_pubpropertyInsertVisible

Získává hodnotu označující zda DataControlField objekt je zobrazen, pokud je jeho nadřazený ovládací prvek vázaný na data v režimu vkládání.(Zděděno z DataControlField.)

System_CAPS_protpropertyIsTrackingViewState

Získává hodnotu označující zda DataControlField objektu je ukládání změn do zobrazení stavu.(Zděděno z DataControlField.)

System_CAPS_pubpropertyItemStyle

Získá styl žádný textový obsah zobrazuje data pole ovládacího prvku.(Zděděno z DataControlField.)

System_CAPS_pubpropertyNewImageUrl

Získá nebo nastaví adresu URL pro bitovou kopii k zobrazení pro nové tlačítko ve CommandField pole.

System_CAPS_pubpropertyNewText

Získá nebo nastaví popisek pro nové tlačítko ve CommandField pole.

System_CAPS_pubpropertySelectImageUrl

Získá nebo nastaví adresu URL obrázku pro tlačítko vybrat v zobrazení CommandField pole.

System_CAPS_pubpropertySelectText

Získá nebo nastaví popisek pro tlačítko vybrat v CommandField pole.

System_CAPS_pubpropertyShowCancelButton

Získá nebo nastaví hodnotu určující, zda se zobrazí tlačítko Storno CommandField pole.

System_CAPS_pubpropertyShowDeleteButton

Získá nebo nastaví hodnotu určující, zda se v zobrazí tlačítko pro odstranění CommandField pole.

System_CAPS_pubpropertyShowEditButton

Získá nebo nastaví hodnotu určující, zda se v zobrazí tlačítko pro úpravy CommandField pole.

System_CAPS_pubpropertyShowHeader

Získá nebo nastaví hodnotu určující, zda se zobrazí v záhlaví části v ButtonFieldBase objektu.(Zděděno z ButtonFieldBase.)

System_CAPS_pubpropertyShowInsertButton

Získá nebo nastaví hodnotu určující, zda se zobrazí nové tlačítko CommandField pole.

System_CAPS_pubpropertyShowSelectButton

Získá nebo nastaví hodnotu určující, zda se v zobrazí tlačítko Vybrat CommandField pole.

System_CAPS_pubpropertySortExpression

Získá nebo nastaví výraz řazení, který je používán ovládací prvek zdroje dat řazení dat.(Zděděno z DataControlField.)

System_CAPS_pubpropertyUpdateImageUrl

Získá nebo nastaví adresu URL pro bitovou kopii k zobrazení na tlačítko Aktualizovat v CommandField pole.

System_CAPS_pubpropertyUpdateText

Získá nebo nastaví popisek pro na tlačítko Aktualizovat v CommandField pole.

System_CAPS_protpropertyValidateRequestMode

Získá nebo nastaví hodnotu, která určuje, zda ovládací prvek ověřovat klienta vstup.(Zděděno z DataControlField.)

System_CAPS_pubpropertyValidationGroup

Získá nebo nastaví název skupiny ovládacích prvků ověřování pro ověření, kdy tlačítka v ButtonFieldBase klepnutí na objekt.(Zděděno z ButtonFieldBase.)

System_CAPS_protpropertyViewState

Získá slovník informace o stavu, který umožňuje uložení a obnovení stavu zobrazení DataControlField objektu napříč více požadavků na stejné stránce.(Zděděno z DataControlField.)

System_CAPS_pubpropertyVisible

Získá nebo nastaví hodnotu určující, zda je vykreslen pole data ovládacího prvku.(Zděděno z DataControlField.)

NázevPopis
System_CAPS_protmethodCloneField()

Toto rozhraní API podporuje infrastrukturu produkt a není určené pro použití přímo z vašeho kódu. Vytvoří kopii aktuální DataControlField-odvozeného objektu.(Zděděno z DataControlField.)

System_CAPS_protmethodCopyProperties(DataControlField)

Zkopíruje vlastnostmi aktuálního CommandField objekt k zadanému DataControlField objektu.(Přepisuje ButtonFieldBase.CopyProperties(DataControlField).)

System_CAPS_protmethodCreateField()

Vytvoří prázdnou CommandField objektu.(Přepisuje DataControlField.CreateField().)

System_CAPS_pubmethodEquals(Object)

Určuje, zda se zadaný objekt rovná aktuálnímu objektu.(Zděděno z Object.)

System_CAPS_pubmethodExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Extrahuje hodnotu ovládacího prvku pole data z aktuální buňky tabulky a přidá hodnotu zadanou IDictionary kolekce.(Zděděno z DataControlField.)

System_CAPS_protmethodFinalize()

Umožňuje objektu pokusit se uvolnit prostředky a provést další operace vyčištění předtím, než je odstraněn při uvolňování paměti.

(Zděděno z Object.)

System_CAPS_pubmethodGetHashCode()

Slouží jako výchozí funkce hash.(Zděděno z Object.)

System_CAPS_pubmethodGetType()

Získá Type aktuální instance.(Zděděno z Object.)

System_CAPS_pubmethodInitialize(Boolean, Control)

Provede inicializaci základní instance pro pole dat ovládacího prvku.(Zděděno z DataControlField.)

System_CAPS_pubmethodInitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)
System_CAPS_protmethodLoadViewState(Object)

Obnoví zobrazení zdroje dat dříve uložený stav zobrazení.(Zděděno z DataControlField.)

System_CAPS_protmethodMemberwiseClone()

Vytvoří mělká kopie aktuálního Object.(Zděděno z Object.)

System_CAPS_protmethodOnFieldChanged()

Vyvolá FieldChanged událostí.(Zděděno z DataControlField.)

System_CAPS_protmethodSaveViewState()

Uloží změny provedené DataControlField stavu zobrazení od doby, stránka byla odeslána zpět na server.(Zděděno z DataControlField.)

System_CAPS_pubmethodToString()

Vrátí řetězec, který představuje to DataControlField objektu.(Zděděno z DataControlField.)

System_CAPS_protmethodTrackViewState()

Způsobí, že DataControlField objekt, který chcete sledovat změny do zobrazení stavu, proto mohou být uloženy v ovládacím prvku ViewState vlastnost a trvalý napříč požadavky na stejné stránce.(Zděděno z DataControlField.)

System_CAPS_pubmethodValidateSupportsCallback()

Určuje, zda ovládací prvky obsažené v CommandField objektu podporu zpětná volání.(Přepisuje DataControlField.ValidateSupportsCallback().)

NázevPopis
System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.LoadViewState(Object)

Toto rozhraní API podporuje infrastrukturu produkt a není určené pro použití přímo z vašeho kódu. Obnoví stav dříve uložené zobrazení datového pole ovládacího prvku.(Zděděno z DataControlField.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.SaveViewState()

Toto rozhraní API podporuje infrastrukturu produkt a není určené pro použití přímo z vašeho kódu. Uloží změny provedené DataControlField stavu zobrazení od doby, stránka byla odeslána zpět na server.(Zděděno z DataControlField.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.TrackViewState()

Toto rozhraní API podporuje infrastrukturu produkt a není určené pro použití přímo z vašeho kódu. Způsobí, že DataControlField objekt, který chcete sledovat změny do zobrazení stavu, proto mohou být uloženy v ovládacím prvku ViewState vlastnost a trvalý napříč požadavky na stejné stránce.(Zděděno z DataControlField.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataSourceViewSchemaAccessor.DataSourceViewSchema

Toto rozhraní API podporuje infrastrukturu produkt a není určené pro použití přímo z vašeho kódu. Získá nebo nastaví schéma přidružený k tomuto DataControlField objektu.(Zděděno z DataControlField.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIStateManager.IsTrackingViewState

Toto rozhraní API podporuje infrastrukturu produkt a není určené pro použití přímo z vašeho kódu. Získává hodnotu označující zda DataControlField objektu je ukládání změn do zobrazení stavu.(Zděděno z DataControlField.)

CommandField Třída je speciální pole používá ovládací prvky vázané na data (jako je například GridView a DetailsView) zobrazit příkazová tlačítka, které provádějí odstranit, upravit, vložit nebo vybrat operace. Příkazová tlačítka provádět tyto operace může být zobrazen nebo skryt pomocí vlastností, které jsou uvedeny v následující tabulce.

Vlastnost

Popis

ShowDeleteButton

Zobrazí nebo skryje tlačítko Odstranit v CommandField pole pro každý záznam v ovládacím prvku vázané na data. Tlačítko Odstranit umožňuje uživateli k odstranění záznamu z datového zdroje.

ShowEditButton

Zobrazí nebo skryje tlačítko pro úpravy v CommandField pole pro každý záznam v ovládacím prvku vázané na data. Tlačítko Upravit umožňuje uživateli upravit záznam z datového zdroje. Když uživatel klikne na tlačítko Upravit pro konkrétní záznam, který upravit nahrazen tlačítko na tlačítko Aktualizovat a tlačítko Storno. Všechna ostatní příkazová tlačítka jsou rovněž skryté.

ShowInsertButton

Zobrazí nebo skryje tlačítko Nový v CommandField pole. Nové tlačítko umožňuje uživateli vložit nový záznam v datovém zdroji. Když uživatel klikne na tlačítko Nový, je nahrazen tlačítko pro vložení a tlačítko Storno. Všechna ostatní příkazová tlačítka jsou rovněž skryté.

System_CAPS_notePoznámka

Tato vlastnost se vztahuje pouze na ovládací prvky vázané na data, které podporují vkládání operace, jako je například DetailsView ovládacího prvku.

ShowSelectButton

Zobrazí nebo skryje tlačítko vybrat v CommandField pole pro každý záznam v ovládacím prvku vázané na data. Vyberte tlačítko umožňuje uživateli vybrat záznam v ovládacím prvku vázané na data.

Kromě toho můžete zrušit tlačítko zobrazí, když je záznam v úpravy nebo režim vkládání zobrazen nebo skryt nastavením ShowCancelButton vlastnost.

System_CAPS_notePoznámka

Pokud používáte ovládací prvek vázaný na data v kombinaci s ovládacím prvkem zdroje dat (jako je například SqlDataSource ovládací prvek), ovládací prvek vázaný na data můžete využít možnosti ovládacího prvku pomocí zdroje dat a poskytují automatické odstranit, aktualizovat a funkce vkládání. Pro ostatní zdroje dat musíte zadat rutiny k provádění těchto operací během příslušné události pro ovládací prvek vázaný na data.

CommandField Pole je zobrazeno odlišně v závislosti na ovládací prvek vázaný na data, ve které je používán. Například GridView řízení zobrazí CommandField pole jako sloupec, zatímco DetailsView ovládací prvek zobrazí jako řádek.

Chcete-li určit typ tlačítko pro zobrazení, použijte ButtonType vlastnost. Když ButtonType je vlastnost nastavena na ButtonType.Button nebo ButtonType.Link, můžete zadat text k zobrazení pro tlačítka nastavením vlastností uvedené v následující tabulce.

Vlastnost

Popis

CancelText

Titulek pro tlačítko Storno.

DeleteText

Titulek pro tlačítko Odstranit.

EditText

Titulek pro tlačítko Upravit.

InsertText

Titulek pro tlačítko Vložit.

System_CAPS_notePoznámka

Tato vlastnost se vztahuje pouze na ovládací prvky vázané na data, podpora vložit operace, jako je například DetailsView ovládacího prvku.

NewText

Titulek pro nové tlačítko.

System_CAPS_notePoznámka

Tato vlastnost se vztahuje pouze na ovládací prvky vázané na data, podpora vložit operace, jako je například DetailsView ovládacího prvku.

SelectText

Titulek pro tlačítko Vybrat.

UpdateText

Titulek pro tlačítko Aktualizovat.

Místo zobrazení příkazové tlačítko nebo odkaz, můžete zobrazit obrázek tlačítka nastavením ButtonType vlastnost ButtonType.Image a nastavením vlastnosti uvedené v následující tabulce.

Vlastnost

Popis

CancelImageUrl

Bitovou kopii k zobrazení pro funkci tlačítka Storno

DeleteImageUrl

Obrázek, který se zobrazí na tlačítko Odstranit.

EditImageUrl

Obrázek, který se zobrazí tlačítko Upravit.

InsertText

Obrázek, který se zobrazí tlačítko Vložit.

System_CAPS_notePoznámka

Tato vlastnost se vztahuje pouze na ovládací prvky vázané na data, podpora vložit operace, jako je například DetailsView ovládacího prvku.

NewImageUrl

Obrázek, který se má zobrazit pro nové tlačítko.

System_CAPS_notePoznámka

Tato vlastnost se vztahuje pouze na ovládací prvky vázané na data, podpora vložit operace, jako je například DetailsView ovládacího prvku.

SelectImageUrl

Obrázek, který se má zobrazit pro tlačítko Vybrat.

UpdateImageUrl

Obrázek, který se má zobrazit pro tlačítko Aktualizovat.

Ve výchozím nastavení, když uživatel klikne na tlačítko v CommandField pole, ověření se provede na všech ověřovacích ovládacích prvků na stránce. Chcete-li zabránit ověřování při stisknutí tlačítka, nastavte CausesValidation vlastnost false.

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

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

System_CAPS_notePoznámka

Některé ovládací prvky vázané na data (jako je například GridView ovládací prvek) můžete zobrazit nebo skrýt pouze část celý záhlaví ovládacího prvku. Tyto ovládací prvky vázané na data nepodporují ShowHeader vlastnost pro jednotlivé tlačítko pole. Chcete-li zobrazit nebo skrýt části celý záhlaví ovládacích prvků vázaných na data (je-li k dispozici), použít ovládací prvek ShowHeader vlastnost.

Můžete také upravit vzhled CommandField objektu (Barva písma, barvy pozadí a tak dále) nastavením vlastnosti stylu pro různé části pole. V následující tabulce jsou uvedeny vlastnosti jiný styl.

Vlastnost stylu

Popis

ControlStyle

Nastavení stylu pro podřízené ovládací prvky webového serveru z CommandField objektu.

FooterStyle

Nastavení stylů pro část zápatí CommandField objektu.

HeaderStyle

Nastavení stylů pro části záhlaví CommandField objektu.

ItemStyle

Nastavení stylu pro datové položky v CommandField objektu.

Následující příklad kódu ukazuje způsob použití CommandField pole k zobrazení ovládacích prvků můžete upravit záznam v GridView ovládacího 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>

Následující příklad kódu ukazuje způsob použití CancelText, EditText, a UpdateText vlastnosti přizpůsobení textu 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>

.NET Framework
K dispozici od 2.0

Všechny veřejné statické členy ( Sdílené v jazyce Visual Basic) tohoto typu mají bezpečný přístup z více vláken. U členů instancí není bezpečný přístup z více vláken zaručen.

Zpět na začátek
Zobrazit: