Condividi tramite


BoundField Classe

Definizione

Rappresenta un campo visualizzato come testo in un controllo associato a dati.

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
Ereditarietà
Derivato

Esempio

Nell'esempio di codice seguente viene illustrato come usare un oggetto per visualizzare i valori di un BoundField campo in un GridView controllo.


<%@ 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>

Commenti

La BoundField classe viene usata dai controlli associati ai dati (ad esempio GridView e DetailsView) per visualizzare il valore di un campo come testo. L'oggetto BoundField viene visualizzato in modo diverso a seconda del controllo associato ai dati in cui viene usato. Ad esempio, il GridView controllo visualizza un BoundField oggetto come colonna, mentre il DetailsView controllo lo visualizza come riga.

Per specificare il campo da visualizzare in un BoundField oggetto, impostare la DataField proprietà sul nome del campo. Il valore del campo può essere codificato con codice HTML prima che venga visualizzato impostando la HtmlEncode proprietà su true. È possibile applicare una stringa di formattazione personalizzata al valore del campo impostando la DataFormatString proprietà. Quando la HtmlEncode proprietà è true, il valore stringa codificato del campo viene usato nella stringa di formato personalizzata. Per impostazione predefinita, la stringa di formattazione viene applicata ai valori dei campi solo quando il controllo associato ai dati è in modalità di sola lettura. Per applicare la stringa di formattazione ai valori visualizzati mentre il controllo associato ai dati è in modalità di modifica, impostare la ApplyFormatInEditMode proprietà su true. Se il valore di un campo è Null, è possibile visualizzare una didascalia personalizzata impostando la NullDisplayText proprietà. L'oggetto BoundField può anche convertire automaticamente valori di campo vuota ("") in valori Null impostando la ConvertEmptyStringToNull proprietà su true.

È possibile nascondere un oggetto in un BoundField controllo associato a dati impostando la Visible proprietà su false. Per impedire la modifica del valore di un campo in modalità di modifica, impostare la ReadOnly proprietà su true. Nei controlli associati a dati che supportano l'inserimento di record (ad esempio il DetailsView controllo), è possibile nascondere un BoundField oggetto impostando la InsertVisible proprietà su false. Questa operazione viene eseguita in genere quando si vuole nascondere un campo chiave generato automaticamente in modalità di inserimento.

È possibile personalizzare le sezioni intestazione e piè di pagina di un BoundField oggetto. Per visualizzare una didascalia nelle sezioni intestazione o piè di pagina, impostare rispettivamente le HeaderText proprietà o FooterText . Anziché visualizzare il testo nella sezione intestazione, è possibile visualizzare un'immagine impostando la HeaderImageUrl proprietà. La sezione intestazione può essere nascosta nell'oggetto BoundField impostando la ShowHeader proprietà su false.

Nota

Alcuni controlli associati a dati ,ad esempio il GridView controllo, possono visualizzare o nascondere solo l'intera sezione dell'intestazione del controllo. Questi controlli associati a dati non supportano la ShowHeader proprietà per un singolo campo associato. Per visualizzare o nascondere l'intera sezione dell'intestazione di un controllo associato a dati (se disponibile), usare la proprietà del ShowHeader controllo.

È anche possibile personalizzare l'aspetto dell'oggetto BoundField (colore del carattere, colore di sfondo e così via) impostando le proprietà dello stile per le diverse parti del campo. Nella tabella seguente sono elencate le diverse proprietà di stile.

Proprietà Style Descrizione
ControlStyle Impostazioni di stile per i controlli server Web figlio dell'oggetto BoundField .
FooterStyle Impostazioni di stile per la sezione piè di pagina dell'oggetto BoundField .
HeaderStyle Impostazioni di stile per la sezione intestazione dell'oggetto BoundField .
ItemStyle Impostazioni di stile per gli elementi di dati nell'oggetto BoundField .

Costruttori

BoundField()

Inizializza una nuova istanza della classe BoundField.

Campi

ThisExpression

Questa API supporta l'infrastruttura del prodotto e non è previsto che venga usata direttamente dal codice.

Rappresenta l'espressione "this".

Proprietà

AccessibleHeaderText

Ottiene o imposta il testo che viene sottoposto a rendering come valore della proprietà AbbreviatedText in alcuni controlli.

(Ereditato da DataControlField)
ApplyFormatInEditMode

Ottiene o imposta un valore che indica se la stringa di formattazione specificata dalla proprietà DataFormatString è applicata a valori di campo quando il controllo con associazione a dati che contiene l'oggetto BoundField è in modalità di modifica.

Control

Ottiene un riferimento al controllo dati a cui l'oggetto DataControlField è associato.

(Ereditato da DataControlField)
ControlStyle

Ottiene lo stile di tutti i controlli server Web contenuti nell'oggetto DataControlField.

(Ereditato da DataControlField)
ConvertEmptyStringToNull

Ottiene o imposta un valore che indica se i valori di stringa vuota ("") sono convertiti automaticamente in valori null quando il campo dati viene aggiornato nell'origine dati.

DataField

Ottiene o imposta il nome del campo dati da associare all'oggetto BoundField.

DataFormatString

Ottiene o imposta la stringa in cui è specificato il formato di visualizzazione per il valore del campo.

DesignMode

Ottiene un valore che indica se un campo di controllo dati è attualmente visualizzato in un ambiente di progettazione.

(Ereditato da DataControlField)
FooterStyle

Ottiene o imposta lo stile del piè di pagina del campo di controllo dati.

(Ereditato da DataControlField)
FooterText

Ottiene o imposta il testo visualizzato nell'elemento del piè di pagina del campo di controllo dati.

(Ereditato da DataControlField)
HeaderImageUrl

Ottiene o imposta l'URL di un'immagine che viene visualizzata nell'elemento di intestazione di un campo di controlli dati.

(Ereditato da DataControlField)
HeaderStyle

Ottiene o imposta lo stile dell'intestazione del campo di controllo dati.

(Ereditato da DataControlField)
HeaderText

Ottiene o imposta il testo visualizzato nell'intestazione di un controllo dati.

HtmlEncode

Ottiene o imposta un valore che indica se i valori di campo sono codificati in HTML prima di essere visualizzati in un oggetto BoundField.

HtmlEncodeFormatString

Ottiene o imposta un valore che indica se il testo creato applicando la proprietà DataFormatString al valore BoundField deve essere codificato in formato HTML al momento della visualizzazione.

InsertVisible

Ottiene un valore che indica se l'oggetto DataControlField è visibile quando il controllo con associazione a dati padre si trova in modalità di inserimento.

(Ereditato da DataControlField)
IsTrackingViewState

Ottiene un valore che indica se l'oggetto DataControlField sta salvando le modifiche apportate al relativo stato di visualizzazione.

(Ereditato da DataControlField)
ItemStyle

Ottiene lo stile di tutti i contenuti basati sul testo visualizzati da un campo di controllo dati.

(Ereditato da DataControlField)
NullDisplayText

Ottiene o imposta la didascalia visualizzata per un campo quando il valore del campo è null.

ReadOnly

Ottiene o imposta un valore che indica se il valore del campo può essere modificato in modalità di modifica.

ShowHeader

Ottiene o imposta un valore che indica se viene eseguito il rendering dell'elemento di intestazione di un campo di controllo dati.

(Ereditato da DataControlField)
SortExpression

Ottiene o imposta l'espressione di ordinamento che viene utilizzata da un controllo origine dati per ordinare i dati.

(Ereditato da DataControlField)
SupportsHtmlEncode

Ottiene un valore che indica se la codifica in HTML è supportata da un oggetto BoundField.

ValidateRequestMode

Ottiene o imposta un valore che determina se il controllo convalida l'input del client.

ValidateRequestMode

Ottiene o imposta un valore che specifica se il controllo convalida l'input del client.

(Ereditato da DataControlField)
ViewState

Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un oggetto DataControlField tra più richieste per la stessa pagina.

(Ereditato da DataControlField)
Visible

Ottiene o imposta un valore che indica se viene eseguito il rendering di un campo di controllo dati.

(Ereditato da DataControlField)

Metodi

CloneField()

Crea una copia duplicata dell'oggetto corrente derivato da DataControlField.

(Ereditato da DataControlField)
CopyProperties(DataControlField)

Copia le proprietà dell'oggetto BoundField corrente nell'oggetto DataControlField specificato.

CreateField()

Crea un oggetto BoundField vuoto.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Inserisce nell'oggetto IDictionary specificato i valori dell'oggetto TableCell specificato.

FormatDataValue(Object, Boolean)

Esegue la formattazione del valore di campo specificato per una cella nell'oggetto BoundField.

GetDesignTimeValue()

Recupera il valore utilizzato per il valore di un campo quando si esegue il rendering dell'oggetto BoundField in una finestra di progettazione.

GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
GetValue(Control)

Recupera il valore del campo associato all'oggetto BoundField.

Initialize(Boolean, Control)

Inizializza l'oggetto BoundField.

InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Inizializza l'oggetto TableCell specificato nello stato della riga specificata.

InitializeDataCell(DataControlFieldCell, DataControlRowState)

Inizializza l'oggetto TableCell specificato nello stato della riga specificata.

LoadViewState(Object)

Ripristina le informazioni sullo stato di visualizzazione precedentemente archiviate per questo campo.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
OnDataBindField(Object, EventArgs)

Associa il valore di un campo all'oggetto BoundField.

OnFieldChanged()

Genera l'evento FieldChanged.

(Ereditato da DataControlField)
SaveViewState()

Salva le modifiche apportate allo stato di visualizzazione DataControlField dal momento in cui è stato eseguito il postback della pagina al server.

(Ereditato da DataControlField)
ToString()

Restituisce una stringa che rappresenta questo oggetto DataControlField.

(Ereditato da DataControlField)
TrackViewState()

Mediante questo metodo l'oggetto DataControlField tiene traccia delle modifiche apportate al relativo stato di visualizzazione in modo che possano essere memorizzate nella proprietà ViewState del controllo e mantenute nelle richieste della stessa pagina.

(Ereditato da DataControlField)
ValidateSupportsCallback()

Determina se i controlli contenuti in un oggetto BoundField supportano i callback.

Implementazioni dell'interfaccia esplicita

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Ottiene o imposta lo schema associato all'oggetto DataControlField.

(Ereditato da DataControlField)
IStateManager.IsTrackingViewState

Ottiene un valore che indica se l'oggetto DataControlField sta salvando le modifiche apportate al relativo stato di visualizzazione.

(Ereditato da DataControlField)
IStateManager.LoadViewState(Object)

Ripristina lo stato di visualizzazione del campo del controllo dati salvato in precedenza.

(Ereditato da DataControlField)
IStateManager.SaveViewState()

Salva le modifiche apportate allo stato di visualizzazione DataControlField dal momento in cui è stato eseguito il postback della pagina al server.

(Ereditato da DataControlField)
IStateManager.TrackViewState()

Mediante questo metodo l'oggetto DataControlField tiene traccia delle modifiche apportate al relativo stato di visualizzazione in modo che possano essere memorizzate nella proprietà ViewState del controllo e mantenute nelle richieste della stessa pagina.

(Ereditato da DataControlField)

Si applica a

Vedi anche