BoundField Classe

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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à: Object

DataControlField
BoundField

Derivato: System.Web.UI.WebControls.AutoGeneratedField

System.Web.UI.WebControls.CheckBoxField

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare un BoundField oggetto per visualizzare i valori di un 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 a 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 a dati in cui viene utilizzato. 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 in 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 di campo solo quando il controllo associato a dati è in modalità di sola lettura. Per applicare la stringa di formattazione ai valori visualizzati mentre il controllo associato a 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 i valori di campo stringa vuota ("") in valori Null impostando la ConvertEmptyStringToNull proprietà su true.

È possibile nascondere un BoundField oggetto in un controllo associato a dati impostando la Visible proprietà su false. Per impedire che il valore di un campo venga modificato 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 in genere eseguita quando si desidera 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.

Annotazioni

Alcuni controlli associati a dati,ad esempio il GridView controllo, possono mostrare o nascondere solo l'intera sezione di 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 di intestazione di un controllo associato a dati (se disponibile), utilizzare 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à di 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

Nome	Descrizione
BoundField()	Inizializza una nuova istanza della classe BoundField.

Campi

Nome	Descrizione
ThisExpression	Questa API supporta l'infrastruttura del prodotto e non è previsto che venga usata direttamente dal codice. Rappresenta l'espressione "this".

Nome

Descrizione

ThisExpression

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

Rappresenta l'espressione "this".

Proprietà

Nome	Descrizione
AccessibleHeaderText	Ottiene o imposta il testo di cui viene eseguito il rendering come valore della `AbbreviatedText` proprietà in alcuni controlli. (Ereditato da DataControlField)
ApplyFormatInEditMode	Ottiene o imposta un valore che indica se la stringa di formattazione specificata dalla DataFormatString proprietà viene applicata ai valori di campo quando il controllo associato a dati che contiene l'oggetto BoundField è in modalità di modifica.
Control	Ottiene un riferimento al controllo dati a cui è associato l'oggetto DataControlField . (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 stringa vuoti ("") vengono 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 che specifica 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 in fase di progettazione. (Ereditato da DataControlField)
FooterStyle	Ottiene o imposta lo stile del piè di pagina del campo del controllo dati. (Ereditato da DataControlField)
FooterText	Ottiene o imposta il testo visualizzato nell'elemento piè di pagina di un campo del controllo dati. (Ereditato da DataControlField)
HeaderImageUrl	Ottiene o imposta l'URL di un'immagine visualizzata nell'elemento di intestazione di un campo di controllo dati. (Ereditato da DataControlField)
HeaderStyle	Ottiene o imposta lo stile dell'intestazione del campo del 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 dei campi sono codificati in formato HTML prima che vengano visualizzati in un BoundField oggetto .
HtmlEncodeFormatString	Ottiene o imposta un valore che indica se il testo creato applicando la DataFormatString proprietà al BoundField valore deve essere codificato IN FORMATO HTML quando viene visualizzato.
InsertVisible	Ottiene un valore che indica se l'oggetto è visibile quando il DataControlField controllo associato a dati padre è in modalità di inserimento. (Ereditato da DataControlField)
IsTrackingViewState	Ottiene un valore che indica se l'oggetto DataControlField sta salvando le modifiche apportate allo stato di visualizzazione. (Ereditato da DataControlField)
ItemStyle	Ottiene lo stile di qualsiasi contenuto basato su testo visualizzato 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 del controllo dati. (Ereditato da DataControlField)
SortExpression	Ottiene o imposta un'espressione di ordinamento utilizzata da un controllo origine dati per ordinare i dati. (Ereditato da DataControlField)
SupportsHtmlEncode	Ottiene un valore che indica se la codifica HTML è supportata da un BoundField oggetto .
ValidateRequestMode	Ottiene o imposta un valore che determina se il controllo convalida o meno l'input client.
ViewState	Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un DataControlField oggetto in 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

Nome	Descrizione
CloneField()	Crea una copia duplicata dell'oggetto derivato da corrente DataControlField. (Ereditato da DataControlField)
CopyProperties(DataControlField)	Copia le proprietà dell'oggetto corrente BoundField nell'oggetto specificato DataControlField .
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)	Riempie l'oggetto specificato IDictionary con i valori dell'oggetto specificato TableCell .
FormatDataValue(Object, Boolean)	Formatta il valore del campo specificato per una cella nell'oggetto BoundField .
GetDesignTimeValue()	Recupera il valore utilizzato per il valore di un campo durante il rendering dell'oggetto BoundField in una finestra di progettazione.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene il 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 specificato TableCell nello stato di riga specificato.
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Inizializza l'oggetto specificato TableCell nello stato di riga specificato.
LoadViewState(Object)	Ripristina le informazioni sullo stato di visualizzazione archiviate in precedenza per questo campo.
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (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 DataControlField visualizzazione dal momento in cui la pagina è stata pubblicata nel server. (Ereditato da DataControlField)
ToString()	Restituisce una stringa che rappresenta questo DataControlField oggetto. (Ereditato da DataControlField)
TrackViewState()	Fa in modo che l'oggetto DataControlField possa tenere traccia delle modifiche apportate allo stato di visualizzazione in modo che possano essere archiviate nella proprietà del ViewState controllo e mantenute tra le richieste per la stessa pagina. (Ereditato da DataControlField)
ValidateSupportsCallback()	Determina se i controlli contenuti in un BoundField oggetto supportano i callback.

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Ottiene o imposta lo schema associato a questo DataControlField oggetto. (Ereditato da DataControlField)
IStateManager.IsTrackingViewState	Ottiene un valore che indica se l'oggetto DataControlField sta salvando le modifiche apportate allo stato di visualizzazione. (Ereditato da DataControlField)
IStateManager.LoadViewState(Object)	Ripristina lo stato di visualizzazione salvato in precedenza del campo del controllo dati. (Ereditato da DataControlField)
IStateManager.SaveViewState()	Salva le modifiche apportate allo stato di DataControlField visualizzazione dal momento in cui la pagina è stata pubblicata nel server. (Ereditato da DataControlField)
IStateManager.TrackViewState()	Fa in modo che l'oggetto DataControlField possa tenere traccia delle modifiche apportate allo stato di visualizzazione in modo che possano essere archiviate nella proprietà del ViewState controllo e mantenute tra le richieste per la stessa pagina. (Ereditato da DataControlField)

Si applica a

Vedi anche

Commenti e suggerimenti

Questa pagina è stata utile?