BoundField Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Reprezentuje pole, które jest wyświetlane jako tekst w kontrolce powiązanej z danymi.

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

Dziedziczenie: Object

DataControlField
BoundField

Pochodne: System.Web.UI.WebControls.AutoGeneratedField

System.Web.UI.WebControls.CheckBoxField

Przykłady

W poniższym przykładzie kodu pokazano, jak używać BoundField obiektu do wyświetlania wartości pola w kontrolce 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>

Uwagi

Klasa BoundField jest używana przez kontrolki powiązane z danymi (takie jak GridView i DetailsView), aby wyświetlić wartość pola jako tekst. Obiekt BoundField jest wyświetlany inaczej w zależności od kontrolki powiązanej z danymi, w której jest używany. Na przykład kontrolka GridView wyświetla BoundField obiekt jako kolumnę, a kontrolka DetailsView wyświetla go jako wiersz.

Aby określić pole do wyświetlenia w BoundField obiekcie, ustaw DataField właściwość na nazwę pola. Wartość pola może być zakodowana w formacie HTML, zanim zostanie wyświetlona, ustawiając HtmlEncode właściwość na true. Możesz zastosować niestandardowy ciąg formatowania do wartości pola, ustawiając DataFormatString właściwość . Gdy HtmlEncode właściwość ma truewartość , zakodowana wartość ciągu pola jest używana w ciągu formatu niestandardowego. Domyślnie ciąg formatowania jest stosowany do wartości pól tylko wtedy, gdy kontrolka powiązana z danymi jest w trybie tylko do odczytu. Aby zastosować ciąg formatowania do wartości wyświetlanych, gdy kontrolka powiązana z danymi jest w trybie edycji, ustaw ApplyFormatInEditMode właściwość na truewartość . Jeśli wartość pola ma wartość null, możesz wyświetlić podpis niestandardowy, ustawiając NullDisplayText właściwość . Obiekt BoundField może również automatycznie konwertować wartości pól pustych ("") na wartości null, ustawiając ConvertEmptyStringToNull właściwość na truewartość .

Obiekt można ukryć BoundField w kontrolce powiązanej z danymi, ustawiając Visible właściwość na false. Aby zapobiec modyfikacji wartości pola w trybie edycji, ustaw ReadOnly właściwość na truewartość . W kontrolkach powiązanych z danymi, które obsługują wstawianie rekordów (takich jak kontrolka DetailsView ), można ukryć BoundField obiekt, ustawiając InsertVisible właściwość na false. Jest to często wykonywane, gdy chcesz ukryć automatycznie wygenerowane pole klucza w trybie wstawiania.

Sekcje nagłówka BoundField i stopki obiektu można dostosować. Aby wyświetlić podpis w sekcjach nagłówka lub stopki, ustaw HeaderText odpowiednio właściwości lub FooterText . Zamiast wyświetlać tekst w sekcji nagłówka, możesz wyświetlić obraz, ustawiając HeaderImageUrl właściwość . Sekcja nagłówka BoundField może być ukryta w obiekcie, ustawiając ShowHeader właściwość na false.

Uwaga

Niektóre kontrolki powiązane z danymi (takie jak kontrolka GridView ) mogą pokazywać lub ukrywać tylko całą sekcję nagłówka kontrolki. Te kontrolki powiązane z danymi nie obsługują ShowHeader właściwości dla pojedynczego pola powiązanego. Aby wyświetlić lub ukryć całą sekcję nagłówka kontrolki powiązanej z danymi (jeśli jest dostępna), użyj właściwości kontrolki ShowHeader .

Możesz również dostosować wygląd BoundField obiektu (kolor czcionki, kolor tła itd.), ustawiając właściwości stylu dla różnych części pola. W poniższej tabeli wymieniono różne właściwości stylu.

Właściwość Stylu	Opis
ControlStyle	Ustawienia stylu podrzędnego serwera sieci Web steruje obiektem BoundField .
FooterStyle	Ustawienia stylu sekcji BoundField stopki obiektu.
HeaderStyle	Ustawienia stylu sekcji nagłówka BoundField obiektu.
ItemStyle	Ustawienia stylu elementów danych w BoundField obiekcie.

Konstruktory

BoundField()

Inicjuje nowe wystąpienie klasy BoundField.

Pola

ThisExpression

Ten interfejs API obsługuje infrastrukturę produktu i nie jest przeznaczony do użycia bezpośrednio z poziomu kodu.

Reprezentuje wyrażenie "this".

Właściwości

AccessibleHeaderText	Pobiera lub ustawia tekst renderowany jako `AbbreviatedText` wartość właściwości w niektórych kontrolkach. (Odziedziczone po DataControlField)
ApplyFormatInEditMode	Pobiera lub ustawia wartość wskazującą, czy ciąg formatowania określony przez DataFormatString właściwość jest stosowany do wartości pól, gdy kontrolka powiązana z danymi zawierająca BoundField obiekt jest w trybie edycji.
Control	Pobiera odwołanie do kontrolki danych, z którą DataControlField jest skojarzony obiekt. (Odziedziczone po DataControlField)
ControlStyle	Pobiera styl dowolnych kontrolek serwera sieci Web zawartych w DataControlField obiekcie . (Odziedziczone po DataControlField)
ConvertEmptyStringToNull	Pobiera lub ustawia wartość wskazującą, czy puste wartości ciągu ("") są automatycznie konwertowane na wartości null po zaktualizowaniu pola danych w źródle danych.
DataField	Pobiera lub ustawia nazwę pola danych, które ma być powiązane z obiektem BoundField .
DataFormatString	Pobiera lub ustawia ciąg określający format wyświetlania wartości pola.
DesignMode	Pobiera wartość wskazującą, czy pole kontrolki danych jest obecnie wyświetlane w środowisku czasu projektowania. (Odziedziczone po DataControlField)
FooterStyle	Pobiera lub ustawia styl stopki pola kontrolki danych. (Odziedziczone po DataControlField)
FooterText	Pobiera lub ustawia tekst wyświetlany w elemencie stopki pola kontrolki danych. (Odziedziczone po DataControlField)
HeaderImageUrl	Pobiera lub ustawia adres URL obrazu wyświetlanego w elemencie nagłówka pola kontrolki danych. (Odziedziczone po DataControlField)
HeaderStyle	Pobiera lub ustawia styl nagłówka pola kontrolki danych. (Odziedziczone po DataControlField)
HeaderText	Pobiera lub ustawia tekst wyświetlany w nagłówku kontrolki danych.
HtmlEncode	Pobiera lub ustawia wartość wskazującą, czy wartości pól są zakodowane w formacie HTML przed ich wyświetleniem BoundField w obiekcie.
HtmlEncodeFormatString	Pobiera lub ustawia wartość wskazującą, czy tekst, który jest tworzony przez zastosowanie DataFormatString właściwości do BoundField wartości, powinien być zakodowany w formacie HTML podczas jego wyświetlania.
InsertVisible	Pobiera wartość wskazującą, czy DataControlField obiekt jest widoczny, gdy jego nadrzędna kontrolka związana z danymi jest w trybie wstawiania. (Odziedziczone po DataControlField)
IsTrackingViewState	Pobiera wartość wskazującą, czy DataControlField obiekt zapisuje zmiany w stanie widoku. (Odziedziczone po DataControlField)
ItemStyle	Pobiera styl dowolnej zawartości tekstowej wyświetlanej przez pole kontrolki danych. (Odziedziczone po DataControlField)
NullDisplayText	Pobiera lub ustawia podpis wyświetlany dla pola, gdy wartość pola ma wartość null.
ReadOnly	Pobiera lub ustawia wartość wskazującą, czy wartość pola można zmodyfikować w trybie edycji.
ShowHeader	Pobiera lub ustawia wartość wskazującą, czy element nagłówka pola kontrolki danych jest renderowany. (Odziedziczone po DataControlField)
SortExpression	Pobiera lub ustawia wyrażenie sortowania używane przez kontrolkę źródła danych do sortowania danych. (Odziedziczone po DataControlField)
SupportsHtmlEncode	Pobiera wartość wskazującą, czy kodowanie HTML jest obsługiwane przez BoundField obiekt.
ValidateRequestMode	Pobiera lub ustawia wartość, która określa, czy kontrolka weryfikuje dane wejściowe klienta, czy nie.
ValidateRequestMode	Pobiera lub ustawia wartość określającą, czy kontrolka weryfikuje dane wejściowe klienta. (Odziedziczone po DataControlField)
ViewState	Pobiera słownik informacji o stanie, który umożliwia zapisanie i przywrócenie stanu DataControlField widoku obiektu w wielu żądaniach dla tej samej strony. (Odziedziczone po DataControlField)
Visible	Pobiera lub ustawia wartość wskazującą, czy pole kontrolki danych jest renderowane. (Odziedziczone po DataControlField)

Metody

CloneField()	Tworzy zduplikowaną kopię bieżącego DataControlFieldobiektu pochodnego. (Odziedziczone po DataControlField)
CopyProperties(DataControlField)	Kopiuje właściwości bieżącego BoundField obiektu do określonego DataControlField obiektu.
CreateField()	Tworzy pusty BoundField obiekt.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Wypełnia określony IDictionary obiekt wartościami z określonego TableCell obiektu.
FormatDataValue(Object, Boolean)	Formatuje określoną wartość pola dla komórki w BoundField obiekcie.
GetDesignTimeValue()	Pobiera wartość używaną dla wartości pola podczas renderowania BoundField obiektu w projektancie.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
GetValue(Control)	Pobiera wartość pola powiązanego z obiektem BoundField .
Initialize(Boolean, Control)	Inicjuje BoundField obiekt.
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Inicjuje określony TableCell obiekt do określonego stanu wiersza.
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Inicjuje określony TableCell obiekt do określonego stanu wiersza.
LoadViewState(Object)	Przywraca wcześniej przechowywane informacje o stanie widoku dla tego pola.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnDataBindField(Object, EventArgs)	Wiąże wartość pola z obiektem BoundField .
OnFieldChanged()	`FieldChanged` Zgłasza zdarzenie. (Odziedziczone po DataControlField)
SaveViewState()	Zapisuje zmiany wprowadzone w DataControlField stanie widoku od czasu opublikowania strony z powrotem na serwerze. (Odziedziczone po DataControlField)
ToString()	Zwraca ciąg reprezentujący ten DataControlField obiekt. (Odziedziczone po DataControlField)
TrackViewState()	DataControlField Powoduje, że obiekt śledzi zmiany stanu widoku, dzięki czemu można je przechowywać we właściwości kontrolki ViewState i utrwalać w żądaniach dla tej samej strony. (Odziedziczone po DataControlField)
ValidateSupportsCallback()	Określa, czy kontrolki zawarte w BoundField obiekcie obsługują wywołania zwrotne.

Jawne implementacje interfejsu

IDataSourceViewSchemaAccessor.DataSourceViewSchema	Pobiera lub ustawia schemat skojarzony z tym DataControlField obiektem. (Odziedziczone po DataControlField)
IStateManager.IsTrackingViewState	Pobiera wartość wskazującą, czy DataControlField obiekt zapisuje zmiany w stanie widoku. (Odziedziczone po DataControlField)
IStateManager.LoadViewState(Object)	Przywraca wcześniej zapisany stan widoku pola sterowania danymi. (Odziedziczone po DataControlField)
IStateManager.SaveViewState()	Zapisuje zmiany wprowadzone w DataControlField stanie widoku od czasu opublikowania strony z powrotem na serwerze. (Odziedziczone po DataControlField)
IStateManager.TrackViewState()	DataControlField Powoduje, że obiekt śledzi zmiany stanu widoku, dzięki czemu można je przechowywać we właściwości kontrolki ViewState i utrwalać w żądaniach dla tej samej strony. (Odziedziczone po DataControlField)

Dotyczy