BoundField Třída

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 použití BoundField objektu k zobrazení hodnot pole 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>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 zobrazuje 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.

Chcete-li zadat pole, které se má zobrazit v objektu BoundField , nastavte DataField vlastnost na název pole. Hodnotu pole lze před zobrazením html kódovat nastavením HtmlEncode vlastnosti na truehodnotu . 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žívá v řetězci vlastního formátu. Ve výchozím nastavení se formátovací řetězec použije na hodnoty polí pouze v případě, že je ovládací prvek vázaný na data v režimu jen pro čtení. Chcete-li použít formátovací řetězec na hodnoty zobrazené, zatímco ovládací prvek vázané na data je v režimu úprav, nastavte ApplyFormatInEditMode vlastnost na true. Pokud je hodnota pole null, můžete zobrazit vlastní titulek nastavením NullDisplayText vlastnosti. Objekt BoundField může také automaticky převést hodnoty prázdného řetězce ("") 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 falsehodnotu . Chcete-li 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 falsehodnotu . To se běžně provádí, když chcete v režimu vložení skrýt automaticky vygenerované pole klíče.

Oddíly záhlaví a zápatí objektu BoundField můžete přizpůsobit. Pokud chcete zobrazit titulek v oddílech záhlaví nebo zápatí, nastavte HeaderText příslušné FooterText vlastnosti. 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 celý oddíl 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 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 BoundField (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 Style	Description
ControlStyle	Nastavení stylu podřízených ovládacích prvků webového serveru objektu BoundField .
FooterStyle	Nastavení stylu pro oddíl zápatí objektu BoundField .
HeaderStyle	Nastavení stylu pro oddíl záhlaví objektu BoundField .
ItemStyle	Nastavení stylu datových položek v objektu BoundField .

Konstruktory

Name	Description
BoundField()	Inicializuje novou instanci BoundField třídy.

Pole

Name	Description
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".

Name

Description

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

Name	Description
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žita na hodnoty pole, když ovládací prvek vázané na data obsahující BoundField objekt je v režimu úprav.
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 ovládacích prvků webového serveru obsažené 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 pro 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 pole ovládacího prvku dat je aktuálně zobrazeno v návrhovém prostředí. (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í 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 záhlaví ovládacího prvku dat.
HtmlEncode	Získá nebo nastaví hodnotu určující, zda hodnoty pole jsou kódovány HTML před jejich zobrazením v objektu BoundField .
HtmlEncodeFormatString	Získá nebo nastaví hodnotu, která urč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 určující, zda DataControlField objekt je viditelný, když nadřazený ovládací prvek vázané na data je 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 jeho 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, pokud hodnota pole je null.
ReadOnly	Získá nebo nastaví hodnotu určující, zda hodnotu pole lze upravit v režimu úprav.
ShowHeader	Získá nebo nastaví hodnotu určující, zda je položka záhlaví pole ovládacího prvku dat vykreslena. (Zděděno od DataControlField)
SortExpression	Získá nebo nastaví výraz řazení, který 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.
ViewState	Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení objektu DataControlField napříč více požadavky na stejnou stránku. (Zděděno od DataControlField)
Visible	Získá nebo nastaví hodnotu určující, zda je pole ovládacího prvku dat vykresleno. (Zděděno od DataControlField)

Metody

Name	Description
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čuje, zda je zadaný objekt roven 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)	Naformátuje zadanou hodnotu pole pro buňku v objektu BoundField .
GetDesignTimeValue()	Načte hodnotu použitou pro hodnotu pole při vykreslování BoundField objektu v návrháři.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (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 Object. (Zděděno od Object)
OnDataBindField(Object, EventArgs)	Vytvoří vazbu hodnoty pole na BoundField objekt.
OnFieldChanged()	`FieldChanged` Vyvolá událost. (Zděděno od DataControlField)
SaveViewState()	Uloží změny provedené ve DataControlField stavu zobrazení od doby, kdy byla stránka odeslá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 bude sledovat změny stavu zobrazení, aby je bylo možné uložit do vlastnosti ovládacího prvku ViewState a zachovat v rámci požadavků 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í

Name	Description
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 určující, zda DataControlField objekt ukládá změny do jeho 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 odeslána zpět na server. (Zděděno od DataControlField)
IStateManager.TrackViewState()	Způsobí, že DataControlField objekt bude sledovat změny stavu zobrazení, aby je bylo možné uložit do vlastnosti ovládacího prvku ViewState a zachovat v rámci požadavků na stejnou stránku. (Zděděno od DataControlField)

Platí pro

Viz také

Váš názor

Byla tato stránka užitečná?