Udostępnij za pośrednictwem


BoundField Klasa

Definicja

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
Pochodne

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

Zobacz też