BoundField Classe

Definizione

Rappresenta un campo visualizzato come testo in un controllo associato a dati.Represents a field that is displayed as text in a data-bound control.

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 riportato di seguito viene illustrato come utilizzare un oggetto BoundField per visualizzare i valori di un campo in un controllo GridView.The following code example demonstrates how to use a BoundField object to display the values of a field in a GridView control.


<%@ 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 classe BoundField viene utilizzata dai controlli con associazione a dati, ad esempio GridView e DetailsView, per visualizzare il valore di un campo come testo.The BoundField class is used by data-bound controls (such as GridView and DetailsView) to display the value of a field as text. L'oggetto BoundField viene visualizzato in modo diverso a seconda del controllo con associazione a dati in cui viene usato.The BoundField object is displayed differently depending on the data-bound control in which it is used. Ad esempio, il controllo GridView Visualizza un oggetto BoundField come colonna, mentre il controllo DetailsView lo Visualizza come riga.For example, the GridView control displays a BoundField object as a column, while the DetailsView control displays it as a row.

Per specificare il campo da visualizzare in un oggetto BoundField, impostare la proprietà DataField sul nome del campo.To specify the field to display in a BoundField object, set the DataField property to the field's name. Il valore del campo può essere codificato in HTML prima di essere visualizzato impostando la proprietà HtmlEncode su true.The field's value can be HTML-encoded before it is displayed by setting the HtmlEncode property to true. È possibile applicare una stringa di formattazione personalizzata al valore del campo impostando la proprietà DataFormatString.You can apply a custom formatting string to the field's value by setting the DataFormatString property. Quando la proprietà HtmlEncode è true, il valore stringa codificato del campo viene usato nella stringa di formato personalizzata.When the HtmlEncode property is true, the encoded string value of the field is used in the custom format string. Per impostazione predefinita, la stringa di formattazione viene applicata ai valori di campo solo quando il controllo con associazione a dati è in modalità di sola lettura.By default, the formatting string is applied to field values only when the data-bound control is in read-only mode. Per applicare la stringa di formattazione ai valori visualizzati mentre il controllo con associazione a dati è in modalità di modifica, impostare la proprietà ApplyFormatInEditMode su true.To apply the formatting string to values displayed while the data-bound control is in edit mode, set the ApplyFormatInEditMode property to true. Se il valore di un campo è null, è possibile visualizzare una didascalia personalizzata impostando la proprietà NullDisplayText.If a field's value is null, you can display a custom caption by setting the NullDisplayText property. L'oggetto BoundField può inoltre convertire automaticamente i valori di campo stringa vuota ("") in valori null impostando la proprietà ConvertEmptyStringToNull su true.The BoundField object can also automatically convert empty string ("") field values to null values by setting the ConvertEmptyStringToNull property to true.

È possibile nascondere un oggetto BoundField in un controllo con associazione a dati impostando la proprietà Visible su false.You can hide a BoundField object in a data-bound control by setting the Visible property to false. Per impedire che il valore di un campo venga modificato in modalità di modifica, impostare la proprietà ReadOnly su true.To prevent the value of a field from being modified in edit mode, set the ReadOnly property to true. Nei controlli associati a dati che supportano l'inserimento di record, ad esempio il controllo DetailsView, è possibile nascondere un oggetto BoundField impostando la proprietà InsertVisible su false.In data-bound controls that support inserting records (such as the DetailsView control), you can hide a BoundField object by setting the InsertVisible property to false. Questa operazione viene in genere eseguita quando si desidera nascondere un campo chiave generato automaticamente in modalità di inserimento.This is commonly done when you want to hide an automatically generated key field in insert mode.

È possibile personalizzare le sezioni dell'intestazione e del piè di pagina di un oggetto BoundField.You can customize the header and footer sections of a BoundField object. Per visualizzare una didascalia nelle sezioni dell'intestazione o del piè di pagina, impostare rispettivamente le proprietà HeaderText o FooterText.To display a caption in the header or footer sections, set the HeaderText or FooterText properties, respectively. Anziché visualizzare il testo nella sezione dell'intestazione, è possibile visualizzare un'immagine impostando la proprietà HeaderImageUrl.Instead of displaying text in the header section, you can display an image by setting the HeaderImageUrl property. La sezione dell'intestazione può essere nascosta nell'oggetto BoundField impostando la proprietà ShowHeader su false.The header section can be hidden in the BoundField object by setting the ShowHeader property to false.

Nota

Alcuni controlli associati a dati, ad esempio il controllo GridView, possono visualizzare o nascondere solo l'intera sezione di intestazione del controllo.Some data-bound controls (such as the GridView control) can show or hide only the entire header section of the control. Questi controlli associati a dati non supportano la proprietà ShowHeader per un singolo campo associato.These data-bound controls do not support the ShowHeader property for an individual bound field. Per visualizzare o nascondere l'intera sezione di intestazione di un controllo con associazione a dati (se disponibile), utilizzare la proprietà ShowHeader del controllo.To show or hide the entire header section of a data-bound control (if available), use the control's ShowHeader property.

È anche possibile personalizzare l'aspetto dell'oggetto BoundField (colore del carattere, colore di sfondo e così via) impostando le proprietà di stile per le diverse parti del campo.You also can customize the appearance of the BoundField object (font color, background color, and so on) by setting the style properties for the different parts of the field. Nella tabella seguente sono elencate le diverse proprietà di stile.The following table lists the different style properties.

Style (proprietà)Style property DescrizioneDescription
ControlStyle Impostazioni di stile per i controlli del server Web figlio dell'oggetto BoundField.The style settings for the child Web server controls of the BoundField object.
FooterStyle Impostazioni di stile per la sezione del piè di pagina dell'oggetto BoundField.The style settings for the footer section of the BoundField object.
HeaderStyle Impostazioni di stile per la sezione di intestazione dell'oggetto BoundField.The style settings for the header section of the BoundField object.
ItemStyle Impostazioni di stile per gli elementi di dati nell'oggetto BoundField.The style settings for the data items in the BoundField object.

Costruttori

BoundField()

Inizializza una nuova istanza della classe BoundField.Initializes a new instance of the BoundField class.

Campi

ThisExpression

Rappresenta l'espressione "this".Represents the "this" expression.

Proprietà

AccessibleHeaderText

Ottiene o imposta il testo che viene sottoposto a rendering come valore della proprietà AbbreviatedText in alcuni controlli.Gets or sets text that is rendered as the AbbreviatedText property value in some controls.

(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.Gets or sets a value indicating whether the formatting string specified by the DataFormatString property is applied to field values when the data-bound control that contains the BoundField object is in edit mode.

Control

Ottiene un riferimento al controllo dati a cui l'oggetto DataControlField è associato.Gets a reference to the data control that the DataControlField object is associated with.

(Ereditato da DataControlField)
ControlStyle

Ottiene lo stile di tutti i controlli server Web contenuti nell'oggetto DataControlField.Gets the style of any Web server controls contained by the DataControlField object.

(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.Gets or sets a value indicating whether empty string values ("") are automatically converted to null values when the data field is updated in the data source.

DataField

Ottiene o imposta il nome del campo dati da associare all'oggetto BoundField.Gets or sets the name of the data field to bind to the BoundField object.

DataFormatString

Ottiene o imposta la stringa in cui è specificato il formato di visualizzazione per il valore del campo.Gets or sets the string that specifies the display format for the value of the field.

DesignMode

Ottiene un valore che indica se un campo di controllo dati è attualmente visualizzato in un ambiente di progettazione.Gets a value indicating whether a data control field is currently viewed in a design-time environment.

(Ereditato da DataControlField)
FooterStyle

Ottiene o imposta lo stile del piè di pagina del campo di controllo dati.Gets or sets the style of the footer of the data control field.

(Ereditato da DataControlField)
FooterText

Ottiene o imposta il testo visualizzato nell'elemento del piè di pagina del campo di controllo dati.Gets or sets the text that is displayed in the footer item of a data control field.

(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.Gets or sets the URL of an image that is displayed in the header item of a data control field.

(Ereditato da DataControlField)
HeaderStyle

Ottiene o imposta lo stile dell'intestazione del campo di controllo dati.Gets or sets the style of the header of the data control field.

(Ereditato da DataControlField)
HeaderText

Ottiene o imposta il testo visualizzato nell'intestazione di un controllo dati.Gets or sets the text that is displayed in the header of a data control.

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.Gets or sets a value indicating whether field values are HTML-encoded before they are displayed in a BoundField object.

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.Gets or sets a value that indicates whether text that is created by applying the DataFormatString property to the BoundField value should be HTML encoded when it is displayed.

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.Gets a value indicating whether the DataControlField object is visible when its parent data-bound control is in insert mode.

(Ereditato da DataControlField)
IsTrackingViewState

Ottiene un valore che indica se l'oggetto DataControlField sta salvando le modifiche apportate al relativo stato di visualizzazione.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(Ereditato da DataControlField)
ItemStyle

Ottiene lo stile di tutti i contenuti basati sul testo visualizzati da un campo di controllo dati.Gets the style of any text-based content displayed by a data control field.

(Ereditato da DataControlField)
NullDisplayText

Ottiene o imposta la didascalia visualizzata per un campo quando il valore del campo è null.Gets or sets the caption displayed for a field when the field's value is null.

ReadOnly

Ottiene o imposta un valore che indica se il valore del campo può essere modificato in modalità di modifica.Gets or sets a value indicating whether the value of the field can be modified in edit mode.

ShowHeader

Ottiene o imposta un valore che indica se viene eseguito il rendering dell'elemento di intestazione di un campo di controllo dati.Gets or sets a value indicating whether the header item of a data control field is rendered.

(Ereditato da DataControlField)
SortExpression

Ottiene o imposta l'espressione di ordinamento che viene utilizzata da un controllo origine dati per ordinare i dati.Gets or sets a sort expression that is used by a data source control to sort data.

(Ereditato da DataControlField)
SupportsHtmlEncode

Ottiene un valore che indica se la codifica in HTML è supportata da un oggetto BoundField.Gets a value indicating whether HTML encoding is supported by a BoundField object.

ValidateRequestMode

Ottiene o imposta un valore che determina se il controllo convalida l'input del client.Gets or sets a value that determines whether the control validates client input or not.

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.Gets a dictionary of state information that allows you to save and restore the view state of a DataControlField object across multiple requests for the same page.

(Ereditato da DataControlField)
Visible

Ottiene o imposta un valore che indica se viene eseguito il rendering di un campo di controllo dati.Gets or sets a value indicating whether a data control field is rendered.

(Ereditato da DataControlField)

Metodi

CloneField()

Crea una copia duplicata dell'oggetto corrente derivato da DataControlField.Creates a duplicate copy of the current DataControlField-derived object.

(Ereditato da DataControlField)
CopyProperties(DataControlField)

Copia le proprietà dell'oggetto BoundField corrente nell'oggetto DataControlField specificato.Copies the properties of the current BoundField object to the specified DataControlField object.

CreateField()

Crea un oggetto BoundField vuoto.Creates an empty BoundField object.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

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

Inserisce nell'oggetto IDictionary specificato i valori dell'oggetto TableCell specificato.Fills the specified IDictionary object with the values from the specified TableCell object.

FormatDataValue(Object, Boolean)

Esegue la formattazione del valore di campo specificato per una cella nell'oggetto BoundField.Formats the specified field value for a cell in the BoundField object.

GetDesignTimeValue()

Recupera il valore utilizzato per il valore di un campo quando si esegue il rendering dell'oggetto BoundField in una finestra di progettazione.Retrieves the value used for a field's value when rendering the BoundField object in a designer.

GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
GetValue(Control)

Recupera il valore del campo associato all'oggetto BoundField.Retrieves the value of the field bound to the BoundField object.

Initialize(Boolean, Control)

Inizializza l'oggetto BoundField.Initializes the BoundField object.

InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Inizializza l'oggetto TableCell specificato nello stato della riga specificata.Initializes the specified TableCell object to the specified row state.

InitializeDataCell(DataControlFieldCell, DataControlRowState)

Inizializza l'oggetto TableCell specificato nello stato della riga specificata.Initializes the specified TableCell object to the specified row state.

LoadViewState(Object)

Ripristina le informazioni sullo stato di visualizzazione precedentemente archiviate per questo campo.Restores the previously stored view-state information for this field.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
OnDataBindField(Object, EventArgs)

Associa il valore di un campo all'oggetto BoundField.Binds the value of a field to the BoundField object.

OnFieldChanged()

Genera l'evento FieldChanged.Raises the FieldChanged event.

(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.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

(Ereditato da DataControlField)
ToString()

Restituisce una stringa che rappresenta questo oggetto DataControlField.Returns a string that represents this DataControlField object.

(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.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page.

(Ereditato da DataControlField)
ValidateSupportsCallback()

Determina se i controlli contenuti in un oggetto BoundField supportano i callback.Determines whether the controls contained in a BoundField object support callbacks.

Implementazioni dell'interfaccia esplicita

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Ottiene o imposta lo schema associato all'oggetto DataControlField.Gets or sets the schema associated with this DataControlField object.

(Ereditato da DataControlField)
IStateManager.IsTrackingViewState

Ottiene un valore che indica se l'oggetto DataControlField sta salvando le modifiche apportate al relativo stato di visualizzazione.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(Ereditato da DataControlField)
IStateManager.LoadViewState(Object)

Ripristina lo stato di visualizzazione del campo del controllo dati salvato in precedenza.Restores the data control field's previously saved view state.

(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.Saves the changes made to the DataControlField view state since the time the page was posted back to the 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.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page.

(Ereditato da DataControlField)

Si applica a

Vedi anche