BoundColumn 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.

Tipo di colonna per il controllo associato a un campo in un'origine DataGrid 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.

Note

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 .

Caution

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

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

Campi

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

Proprietà

Nome	Descrizione
DataField	Ottiene o imposta il nome del campo dall'origine dati da associare all'oggetto BoundColumn.
DataFormatString	Ottiene o imposta la stringa che specifica il formato di visualizzazione per gli elementi nella 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 piè di pagina della colonna. (Ereditato da DataGridColumn)
FooterText	Ottiene o imposta il testo visualizzato nella sezione piè di pagina della colonna. (Ereditato da DataGridColumn)
HeaderImageUrl	Ottiene o imposta la posizione di un'immagine da visualizzare nella sezione intestazione della colonna. (Ereditato da DataGridColumn)
HeaderStyle	Ottiene le proprietà di stile per la sezione intestazione della colonna. (Ereditato da DataGridColumn)
HeaderText	Ottiene o imposta il testo visualizzato nella sezione intestazione della colonna. (Ereditato da DataGridColumn)
IsTrackingViewState	Ottiene un valore che determina se l'oggetto DataGridColumn è contrassegnato per salvare il relativo stato. (Ereditato da DataGridColumn)
ItemStyle	Ottiene le proprietà di stile per le celle dell'elemento della colonna. (Ereditato da DataGridColumn)
Owner	Ottiene il DataGrid controllo di cui la colonna è membro. (Ereditato da DataGridColumn)
ReadOnly	Ottiene o imposta un valore che indica se gli elementi in BoundColumn possono essere modificati.
SortExpression	Ottiene o imposta il nome del campo o dell'espressione da passare al OnSortCommand(DataGridSortCommandEventArgs) metodo quando viene selezionata una colonna per l'ordinamento. (Ereditato da DataGridColumn)
ViewState	Ottiene l'oggetto StateBag che consente a una colonna derivata dalla DataGridColumn classe di archiviarne le proprietà. (Ereditato da DataGridColumn)
Visible	Ottiene o imposta un valore che indica se la colonna è visibile nel DataGrid controllo . (Ereditato da DataGridColumn)

Metodi

Nome	Descrizione
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
FormatDataValue(Object)	Converte il valore specificato nel formato indicato dalla DataFormatString proprietà .
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
Initialize()	Reimposta l'oggetto sullo BoundColumn stato iniziale.
InitializeCell(TableCell, Int32, ListItemType)	Reimposta 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 del Objectcorrente. (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 di stringa della colonna. (Ereditato da DataGridColumn)
TrackViewState()	Determina il rilevamento delle modifiche dello stato di visualizzazione al controllo server in modo che possano essere archiviate nell'oggetto del StateBag controllo server. (Ereditato da DataGridColumn)

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
IStateManager.IsTrackingViewState	Ottiene un valore che indica se la colonna sta tenendo traccia delle 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 modifiche dello stato. (Ereditato da DataGridColumn)
IStateManager.TrackViewState()	Avvia il rilevamento delle modifiche dello stato. (Ereditato da DataGridColumn)

Si applica a

Vedi anche

Commenti e suggerimenti

Questa pagina è stata utile?