BoundField Třída

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

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í.

Představuje pole, které se zobrazí jako text v ovládacím prvku vázaném na data.

public ref class BoundField : System::Web::UI::WebControls::DataControlField

public class BoundField : System.Web.UI.WebControls.DataControlField

type BoundField = class
    inherit DataControlField

Public Class BoundField
Inherits DataControlField

Dědičnost: Object

DataControlField
BoundField

Odvozené: System.Web.UI.WebControls.AutoGeneratedField

System.Web.UI.WebControls.CheckBoxField

Příklady

Následující příklad kódu ukazuje, jak použít BoundField objekt k zobrazení hodnot pole v ovládacím prvku GridView .


<%@ 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>BoundField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>BoundField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        autogenerateeditbutton="true"
        allowpaging="true" 
        datakeynames="CustomerID"  
        runat="server">
         
        <columns>
          <asp:boundfield datafield="CustomerID"
            readonly="true"      
            headertext="Customer ID"/>
          <asp:boundfield datafield="CompanyName"
            convertemptystringtonull="true"
            headertext="Customer Name"/>
          <asp:boundfield datafield="Address"
            convertemptystringtonull="true"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            convertemptystringtonull="true"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            convertemptystringtonull="true"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            convertemptystringtonull="true"
            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>BoundField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>BoundField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        autogenerateeditbutton="true"
        allowpaging="true" 
        datakeynames="CustomerID"  
        runat="server">
         
        <columns>
          <asp:boundfield datafield="CustomerID"
            readonly="true"      
            headertext="Customer ID"/>
          <asp:boundfield datafield="CompanyName"
            convertemptystringtonull="true"
            headertext="Customer Name"/>
          <asp:boundfield datafield="Address"
            convertemptystringtonull="true"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            convertemptystringtonull="true"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            convertemptystringtonull="true"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            convertemptystringtonull="true"
            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řídu BoundField používají ovládací prvky vázané na data (například GridView a DetailsView) k zobrazení hodnoty pole jako textu. Objekt BoundField se zobrazí odlišně v závislosti na ovládacím prvku vázaném na data, ve kterém se používá. GridView Například ovládací prvek zobrazí BoundField objekt jako sloupec, zatímco DetailsView ovládací prvek ho zobrazí jako řádek.

Pokud chcete zadat pole, které se má zobrazit v objektu BoundField , nastavte DataField vlastnost na název pole. Hodnota pole může být před zobrazením zakódována ve formátu HTML nastavením HtmlEncode vlastnosti na true. Na hodnotu pole můžete použít vlastní formátovací řetězec nastavením DataFormatString vlastnosti. HtmlEncode Pokud je truevlastnost , kódovaná řetězcová hodnota pole se použije v řetězci vlastního formátu. Formátovací řetězec se ve výchozím nastavení použije na hodnoty polí pouze v případě, že je ovládací prvek vázaný na data v režimu jen pro čtení. Pokud chcete formátovací řetězec použít u hodnot zobrazených v režimu úprav ovládacího prvku vázaného ApplyFormatInEditMode na data, nastavte vlastnost na truehodnotu . Pokud je hodnota pole null, můžete vlastní titulek zobrazit nastavením NullDisplayText vlastnosti. Objekt BoundField může také automaticky převést hodnoty pole prázdných řetězců ("") na hodnoty null nastavením ConvertEmptyStringToNull vlastnosti na true.

Objekt v ovládacím prvku vázaném BoundField na data můžete skrýt nastavením Visible vlastnosti na false. Pokud chcete zabránit úpravě hodnoty pole v režimu úprav, nastavte ReadOnly vlastnost na true. V ovládacích prvcích vázaných na data, které podporují vkládání záznamů (například DetailsView ovládacího prvku), můžete objekt skrýt BoundField nastavením InsertVisible vlastnosti na false. To se obvykle provádí, když chcete skrýt automaticky vygenerované pole klíče v režimu vložení.

Oddíly záhlaví a zápatí objektu BoundField můžete přizpůsobit. Pokud chcete zobrazit titulek v oddílu záhlaví nebo zápatí, nastavte HeaderText vlastnosti nebo FooterText . Místo zobrazení textu v oddílu záhlaví můžete obrázek zobrazit nastavením HeaderImageUrl vlastnosti. Oddíl záhlaví může být v objektu BoundField skrytý nastavením ShowHeader vlastnosti 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 pouze celou část záhlaví ovládacího prvku. Tyto ovládací prvky vázané na ShowHeader data nepodporují vlastnost pro jednotlivé vázané pole. Pokud chcete zobrazit nebo skrýt celou část záhlaví ovládacího prvku vázaného na data (pokud je k dispozici), použijte vlastnost ovládacího prvku ShowHeader .

Můžete také přizpůsobit vzhled objektu BoundField (barvu písma, barvu pozadí atd.) nastavením vlastností stylu pro různé části pole. V následující tabulce jsou uvedeny různé vlastnosti stylu.

Vlastnost Style	Description
ControlStyle	Nastavení stylu podřízeného webového serveru ovládací prvky objektu BoundField .
FooterStyle	Nastavení stylu pro část zápatí objektu BoundField .
HeaderStyle	Nastavení stylu pro oddíl záhlaví objektu BoundField .
ItemStyle	Nastavení stylu pro datové položky v objektu BoundField .

Konstruktory

BoundField()

Inicializuje novou instanci BoundField třídy.

Pole

ThisExpression

Toto rozhraní API podporuje produktovou infrastrukturu a není určené k použití přímo z uživatelského kódu.

Představuje výraz "this".

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)
ApplyFormatInEditMode	Získá nebo nastaví hodnotu určující, zda formátovací řetězec určený DataFormatString vlastností je použit na hodnoty pole, když ovládací prvek vázané na data, který obsahuje BoundField objekt je v režimu úprav.
Control	Získá odkaz na ovládací prvek dat, který DataControlField je přidružen objektu. (Zděděno od DataControlField)
ControlStyle	Získá styl všech ovládacích prvků webového serveru obsažených v objektu DataControlField . (Zděděno od DataControlField)
ConvertEmptyStringToNull	Získá nebo nastaví hodnotu určující, zda prázdné řetězcové hodnoty ("") jsou automaticky převedeny na hodnoty null při aktualizaci datového pole ve zdroji dat.
DataField	Získá nebo nastaví název datového pole na vazbu k objektu BoundField .
DataFormatString	Získá nebo nastaví řetězec, který určuje formát zobrazení pro hodnotu pole.
DesignMode	Získá hodnotu označující, zda je pole ovládacích prvků dat aktuálně zobrazen v prostředí návrhu. (Zděděno od DataControlField)
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í pole ovládacího prvku dat. (Zděděno od DataControlField)
HeaderImageUrl	Získá nebo nastaví adresu URL obrázku, který je zobrazen 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, který je zobrazen v záhlaví datového ovládacího prvku.
HtmlEncode	Získá nebo nastaví hodnotu označující, zda jsou hodnoty pole kódovány html před jejich zobrazením v objektu BoundField .
HtmlEncodeFormatString	Získá nebo nastaví hodnotu, která označuje, zda text, který je vytvořen použitím DataFormatString vlastnosti na BoundField hodnotu by měl být kód html při zobrazení.
InsertVisible	Získá hodnotu označující, zda DataControlField objekt je viditelný, když jeho nadřazený ovládací prvek vázané na data je v režimu vložení. (Zděděno od DataControlField)
IsTrackingViewState	Získá hodnotu označující, zda DataControlField objekt ukládá změny do svého 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)
NullDisplayText	Získá nebo nastaví titulek zobrazený pro pole, když je hodnota pole null.
ReadOnly	Získá nebo nastaví hodnotu označující, zda hodnotu pole lze upravit v režimu úprav.
ShowHeader	Získá nebo nastaví hodnotu určující, zda položka záhlaví pole ovládacího prvku dat je vykreslena. (Zděděno od DataControlField)
SortExpression	Získá nebo nastaví výraz řazení, který se používá ovládací prvek zdroje dat k řazení dat. (Zděděno od DataControlField)
SupportsHtmlEncode	Získá hodnotu označující, zda kódování HTML je podporováno objektem BoundField .
ValidateRequestMode	Získá nebo nastaví hodnotu, která určuje, zda ovládací prvek ověřuje vstup klienta nebo ne.
ValidateRequestMode	Získá nebo nastaví hodnotu, která určuje, zda ovládací prvek ověřuje vstup klienta. (Zděděno od DataControlField)
ViewState	Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení objektu DataControlField napříč několika požadavky na stejnou stránku. (Zděděno od DataControlField)
Visible	Získá nebo nastaví hodnotu označující, zda je vykreslena pole ovládacího prvku dat. (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 BoundField objektu do zadaného DataControlField objektu.
CreateField()	Vytvoří prázdný BoundField objekt.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Vyplní zadaný IDictionary objekt hodnotami ze zadaného TableCell objektu.
FormatDataValue(Object, Boolean)	Formátuje zadanou hodnotu pole pro buňku v objektu BoundField .
GetDesignTimeValue()	Načte hodnotu použitou pro hodnotu pole při vykreslování objektu BoundField v návrháři.
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
GetValue(Control)	Načte hodnotu pole vázaného na BoundField objekt.
Initialize(Boolean, Control)	Inicializuje BoundField objekt.
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Inicializuje zadaný TableCell objekt do zadaného stavu řádku.
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Inicializuje zadaný TableCell objekt do zadaného stavu řádku.
LoadViewState(Object)	Obnoví dříve uložené informace o stavu zobrazení pro toto pole.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
OnDataBindField(Object, EventArgs)	Sváže hodnotu pole s objektem BoundField .
OnFieldChanged()	`FieldChanged` Vyvolá událost. (Zděděno od DataControlField)
SaveViewState()	Uloží změny provedené ve DataControlField stavu zobrazení od okamžiku, 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í, že DataControlField objekt sleduje změny stavu zobrazení, aby je bylo možné uložit ve vlastnosti ovládacího prvku ViewState a zachovat v požadavcích na stejnou stránku. (Zděděno od DataControlField)
ValidateSupportsCallback()	Určuje, zda ovládací prvky obsažené v objektu BoundField 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 svého 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 okamžiku, kdy byla stránka publikována zpět na server. (Zděděno od DataControlField)
IStateManager.TrackViewState()	Způsobí, že DataControlField objekt sleduje změny stavu zobrazení, aby je bylo možné uložit ve vlastnosti ovládacího prvku ViewState a zachovat v požadavcích na stejnou stránku. (Zděděno od DataControlField)

Platí pro