BoundColumn Classe

Riferimento

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.

Tipo di colonna per il controllo DataGrid associato a un campo in un'origine dati.

public ref class BoundColumn : System::Web::UI::WebControls::DataGridColumn

public class BoundColumn : System.Web.UI.WebControls.DataGridColumn

type BoundColumn = class
    inherit DataGridColumn

Public Class BoundColumn
Inherits DataGridColumn

Ereditarietà: Object

DataGridColumn
BoundColumn

Esempio

Nell'esempio seguente viene illustrato come utilizzare un BoundColumn tipo di colonna nel DataGrid controllo per visualizzare i campi in un'origine dati.

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!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" >
   <script language="C#" runat="server">
 
      ICollection CreateDataSource() 
      {
         DataTable dt = new DataTable();
         DataRow dr;
 
         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));
 
         for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();
 
            dr[0] = i;
            dr[1] = "Item " + i.ToString();
            dr[2] = 1.23 * (i + 1);
 
            dt.Rows.Add(dr);
         }
 
         DataView dv = new DataView(dt);
         return dv;
      }
 
      void Page_Load(Object sender, EventArgs e) 
      {
 
         if (!IsPostBack) 
         {
            // Load this data only once.
            ItemsGrid.DataSource= CreateDataSource();
            ItemsGrid.DataBind();
         }
      }
 
   </script>
 
<head runat="server">
    <title>BoundColumn Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>BoundColumn Example</h3>
 
      <b>Product List</b>
 
      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           AutoGenerateColumns="false"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle>

         <Columns>

            <asp:BoundColumn
                 HeaderText="Number" 
                 DataField="IntegerValue">
            </asp:BoundColumn>

            <asp:BoundColumn
                 HeaderText="Description" 
                 DataField="StringValue">
            </asp:BoundColumn>

            <asp:BoundColumn
                 HeaderText="Price" 
                 DataField="CurrencyValue" 
                 DataFormatString="{0:c}">
            </asp:BoundColumn>

         </Columns>
 
      </asp:DataGrid>
 
   </form>
 
</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!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" >
   <script language="VB" runat="server">
    Function CreateDataSource() As ICollection
        Dim dt As New DataTable()
        Dim dr As DataRow
        
        dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
        dt.Columns.Add(New DataColumn("StringValue", GetType(String)))
        dt.Columns.Add(New DataColumn("CurrencyValue", GetType(Double)))
        
        Dim i As Integer
        For i = 0 To 8
            dr = dt.NewRow()
            
            dr(0) = i
            dr(1) = "Item " + i.ToString()
            dr(2) = 1.23 *(i + 1)
            
            dt.Rows.Add(dr)
        Next i
        
        Dim dv As New DataView(dt)
        Return dv
    End Function 'CreateDataSource


    Sub Page_Load(sender As Object, e As EventArgs)
        
        If Not IsPostBack Then
            ' Load this data only once.
            ItemsGrid.DataSource = CreateDataSource()
            ItemsGrid.DataBind()
        End If
    End Sub 'Page_Load
   </script>
<head runat="server">
    <title>BoundColumn Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>BoundColumn Example</h3>
 
      <b>Product List</b>
 
      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           AutoGenerateColumns="false"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle>

         <Columns>

            <asp:BoundColumn
                 HeaderText="Number" 
                 DataField="IntegerValue">
            </asp:BoundColumn>

            <asp:BoundColumn
                 HeaderText="Description" 
                 DataField="StringValue">
            </asp:BoundColumn>

            <asp:BoundColumn
                 HeaderText="Price" 
                 DataField="CurrencyValue" 
                 DataFormatString="{0:c}">
            </asp:BoundColumn>

         </Columns>
 
      </asp:DataGrid>
 
   </form>
 
</body>
</html>

Commenti

Utilizzare il BoundColumn tipo di colonna in un DataGrid controllo per visualizzare il contenuto di un campo nell'origine dati. I valori sono elencati in una singola colonna. Il campo è collegato a BoundColumn, pertanto tutti gli aggiornamenti nell'origine dati rifletteranno nelle celle corrispondenti del DataGrid controllo.

Nota

Questo tipo di colonna è l'impostazione predefinita per il DataGrid controllo .

Per controllare l'aspetto di questa colonna, utilizzare le proprietà di stile del DataGrid controllo .

Attenzione

Il testo non è codificato in HTML prima che venga visualizzato in BoundColumn. In questo modo è possibile incorporare lo script all'interno di tag HTML nel testo. Se i valori di questa colonna provengono dall'input dell'utente, assicurarsi di convalidare i valori per ridurre le vulnerabilità di sicurezza.

Costruttori

BoundColumn()

Inizializza una nuova istanza della classe BoundColumn.

Campi

thisExpr

Rappresenta la stringa "!". Questo campo è di sola lettura.

Proprietà

DataField	Ottiene o imposta il nome del campo dell'origine dati da associare all'oggetto BoundColumn.
DataFormatString	Ottiene o imposta la stringa in cui è specificato il formato di visualizzazione per gli elementi della colonna.
DesignMode	Ottiene un valore che indica se la colonna è in modalità progettazione. (Ereditato da DataGridColumn)
FooterStyle	Ottiene le proprietà di stile per la sezione del piè di pagina della colonna. (Ereditato da DataGridColumn)
FooterText	Ottiene o imposta il testo visualizzato nella sezione del piè di pagina della colonna. (Ereditato da DataGridColumn)
HeaderImageUrl	Ottiene o imposta la posizione di un'immagine da visualizzare nella sezione di intestazione della colonna. (Ereditato da DataGridColumn)
HeaderStyle	Ottiene le proprietà di stile per la sezione di intestazione della colonna. (Ereditato da DataGridColumn)
HeaderText	Ottiene o imposta il testo visualizzato nella sezione di intestazione della colonna. (Ereditato da DataGridColumn)
IsTrackingViewState	Ottiene un valore che determina se l'oggetto DataGridColumn è contrassegnato per il salvataggio dello stato. (Ereditato da DataGridColumn)
ItemStyle	Ottiene le proprietà di stile per le celle degli elementi della colonna. (Ereditato da DataGridColumn)
Owner	Ottiene il controllo DataGrid di cui la colonna è membro. (Ereditato da DataGridColumn)
ReadOnly	Ottiene o imposta un valore che indica se è possibile modificare gli elementi presenti nell'oggetto BoundColumn.
SortExpression	Ottiene o imposta il nome del campo o l'espressione da passare al metodo OnSortCommand(DataGridSortCommandEventArgs) quando una colonna viene selezionata per l'ordinamento. (Ereditato da DataGridColumn)
ViewState	Ottiene l'oggetto StateBag che consente a una colonna derivata dalla classe DataGridColumn di memorizzare le relative proprietà. (Ereditato da DataGridColumn)
Visible	Ottiene o imposta un valore che indica se la colonna è visibile nel controllo DataGrid. (Ereditato da DataGridColumn)

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
FormatDataValue(Object)	Converte il valore specificato nel formato indicato dalla proprietà DataFormatString.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Initialize()	Ripristina lo stato iniziale del controllo BoundColumn.
InitializeCell(TableCell, Int32, ListItemType)	Ripristina lo stato iniziale della cella specificata nell'oggetto BoundColumn.
LoadViewState(Object)	Carica lo stato dell'oggetto DataGridColumn. (Ereditato da DataGridColumn)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnColumnChanged()	Chiama il metodo OnColumnsChanged(). (Ereditato da DataGridColumn)
SaveViewState()	Salva lo stato corrente dell'oggetto DataGridColumn. (Ereditato da DataGridColumn)
ToString()	Restituisce la rappresentazione in forma di stringa della colonna. (Ereditato da DataGridColumn)
TrackViewState()	Attiva il rilevamento delle modifiche dello stato di visualizzazione nel controllo server per consentirne la memorizzazione nell'oggetto StateBag del controllo server. (Ereditato da DataGridColumn)

Implementazioni dell'interfaccia esplicita

IStateManager.IsTrackingViewState	Ottiene un valore che indica se nella colonna vengono registrate le modifiche dello stato di visualizzazione. (Ereditato da DataGridColumn)
IStateManager.LoadViewState(Object)	Carica lo stato salvato in precedenza. (Ereditato da DataGridColumn)
IStateManager.SaveViewState()	Restituisce un oggetto contenente le modifiche dello stato. (Ereditato da DataGridColumn)
IStateManager.TrackViewState()	Avvia la registrazione delle modifiche dello stato. (Ereditato da DataGridColumn)

Si applica a