BoundColumn Classe

Definizione

Tipo di colonna per il controllo DataGrid associato a un campo in un'origine dati.A column type for the DataGrid control that is bound to a field in a data source.

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

Esempi

Nell'esempio seguente viene illustrato come utilizzare un BoundColumn tipo di colonna DataGrid nel controllo per visualizzare i campi in un'origine dati.The following example demonstrates how to use a BoundColumn column type in the DataGrid control to display the fields in a data source.

<%@ 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 DataGrid un controllo per visualizzare il contenuto di un campo nell'origine dati.Use the BoundColumn column type in a DataGrid control to display the contents of a field in the data source. I valori sono elencati in un'unica colonna.The values are listed in a single column. Il campo è collegato a BoundColumn, quindi qualsiasi aggiornamento nell'origine dati verrà rispecchiato nelle celle corrispondenti DataGrid del controllo.The field is linked to the BoundColumn, so any updates in the data source will reflect in the corresponding cells of the DataGrid control.

Nota

Questo tipo di colonna è il valore predefinito DataGrid per il controllo.This column type is the default for the DataGrid control.

Per controllare l'aspetto di questa colonna, utilizzare le proprietà di stile DataGrid del controllo.To control appearance of this column, use the style properties of the DataGrid control.

Attenzione

Il BoundColumntesto non è codificato in HTML prima di essere visualizzato in.Text is not HTML encoded before it is displayed in the BoundColumn. In questo modo è possibile incorporare script all'interno di tag HTML nel testo.This makes it possible to embed script within HTML tags in the text. Se i valori per questa colonna provengono dall'input dell'utente, assicurarsi di convalidare i valori per ridurre le vulnerabilità della sicurezza.If the values for this column come from user input, be sure to validate the values to reduce security vulnerabilities.

Costruttori

BoundColumn()

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

Campi

thisExpr

Rappresenta la stringa "!".Represents the string "!". Questo campo è di sola lettura.This field is read-only.

Proprietà

DataField

Ottiene o imposta il nome del campo dell'origine dati da associare all'oggetto BoundColumn.Gets or sets the field name from the data source to bind to the BoundColumn.

DataFormatString

Ottiene o imposta la stringa in cui è specificato il formato di visualizzazione per gli elementi della colonna.Gets or sets the string that specifies the display format for items in the column.

DesignMode

Ottiene un valore che indica se la colonna è in modalità progettazione.Gets a value that indicates whether the column is in design mode.

(Ereditato da DataGridColumn)
FooterStyle

Ottiene le proprietà di stile per la sezione del piè di pagina della colonna.Gets the style properties for the footer section of the column.

(Ereditato da DataGridColumn)
FooterText

Ottiene o imposta il testo visualizzato nella sezione del piè di pagina della colonna.Gets or sets the text displayed in the footer section of the column.

(Ereditato da DataGridColumn)
HeaderImageUrl

Ottiene o imposta la posizione di un'immagine da visualizzare nella sezione di intestazione della colonna.Gets or sets the location of an image to display in the header section of the column.

(Ereditato da DataGridColumn)
HeaderStyle

Ottiene le proprietà di stile per la sezione di intestazione della colonna.Gets the style properties for the header section of the column.

(Ereditato da DataGridColumn)
HeaderText

Ottiene o imposta il testo visualizzato nella sezione di intestazione della colonna.Gets or sets the text displayed in the header section of the column.

(Ereditato da DataGridColumn)
IsTrackingViewState

Ottiene un valore che determina se l'oggetto DataGridColumn è contrassegnato per il salvataggio dello stato.Gets a value that determines whether the DataGridColumn object is marked to save its state.

(Ereditato da DataGridColumn)
ItemStyle

Ottiene le proprietà di stile per le celle degli elementi della colonna.Gets the style properties for the item cells of the column.

(Ereditato da DataGridColumn)
Owner

Ottiene il controllo DataGrid di cui la colonna è membro.Gets the DataGrid control that the column is a member of.

(Ereditato da DataGridColumn)
ReadOnly

Ottiene o imposta un valore che indica se è possibile modificare gli elementi presenti nell'oggetto BoundColumn.Gets or sets a value that indicates whether the items in the BoundColumn can be edited.

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.Gets or sets the name of the field or expression to pass to the OnSortCommand(DataGridSortCommandEventArgs) method when a column is selected for sorting.

(Ereditato da DataGridColumn)
ViewState

Ottiene l'oggetto StateBag che consente a una colonna derivata dalla classe DataGridColumn di memorizzare le relative proprietà.Gets the StateBag object that allows a column derived from the DataGridColumn class to store its properties.

(Ereditato da DataGridColumn)
Visible

Ottiene o imposta un valore che indica se la colonna è visibile nel controllo DataGrid.Gets or sets a value that indicates whether the column is visible in the DataGrid control.

(Ereditato da DataGridColumn)

Metodi

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)
FormatDataValue(Object)

Converte il valore specificato nel formato indicato dalla proprietà DataFormatString.Converts the specified value to the format indicated by the DataFormatString property.

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)
Initialize()

Ripristina lo stato iniziale del controllo BoundColumn.Resets the BoundColumn to its initial state.

InitializeCell(TableCell, Int32, ListItemType)

Ripristina lo stato iniziale della cella specificata nell'oggetto BoundColumn.Resets the specified cell in the BoundColumn to its initial state.

LoadViewState(Object)

Carica lo stato dell'oggetto DataGridColumn.Loads the state of the DataGridColumn object.

(Ereditato da DataGridColumn)
MemberwiseClone()

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

(Ereditato da Object)
OnColumnChanged()

Chiama il metodo OnColumnsChanged().Calls the OnColumnsChanged() method.

(Ereditato da DataGridColumn)
SaveViewState()

Salva lo stato corrente dell'oggetto DataGridColumn.Saves the current state of the DataGridColumn object.

(Ereditato da DataGridColumn)
ToString()

Restituisce la rappresentazione in forma di stringa della colonna.Returns the string representation of the column.

(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.Causes tracking of view-state changes to the server control so they can be stored in the server control's StateBag object.

(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.Gets a value that indicates whether the column is tracking view state changes.

(Ereditato da DataGridColumn)
IStateManager.LoadViewState(Object)

Carica lo stato salvato in precedenza.Loads previously saved state.

(Ereditato da DataGridColumn)
IStateManager.SaveViewState()

Restituisce un oggetto contenente le modifiche dello stato.Returns an object containing state changes.

(Ereditato da DataGridColumn)
IStateManager.TrackViewState()

Avvia la registrazione delle modifiche dello stato.Starts tracking state changes.

(Ereditato da DataGridColumn)

Si applica a

Vedi anche