BoundColumn BoundColumn BoundColumn BoundColumn Class

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à

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

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

Campi

thisExpr thisExpr thisExpr thisExpr

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

Proprietà

DataField DataField DataField 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 DataFormatString DataFormatString 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 DesignMode DesignMode DesignMode

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

(Inherited from DataGridColumn)
FooterStyle FooterStyle FooterStyle 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.

(Inherited from DataGridColumn)
FooterText FooterText FooterText 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.

(Inherited from DataGridColumn)
HeaderImageUrl HeaderImageUrl HeaderImageUrl 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.

(Inherited from DataGridColumn)
HeaderStyle HeaderStyle HeaderStyle HeaderStyle

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

(Inherited from DataGridColumn)
HeaderText HeaderText HeaderText 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.

(Inherited from DataGridColumn)
IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState 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.

(Inherited from DataGridColumn)
IsTrackingViewState IsTrackingViewState IsTrackingViewState 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.

(Inherited from DataGridColumn)
ItemStyle ItemStyle ItemStyle ItemStyle

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

(Inherited from DataGridColumn)
Owner Owner Owner Owner

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

(Inherited from DataGridColumn)
ReadOnly ReadOnly ReadOnly 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 SortExpression SortExpression 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.

(Inherited from DataGridColumn)
ViewState ViewState ViewState 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.

(Inherited from DataGridColumn)
Visible Visible Visible 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.

(Inherited from DataGridColumn)

Metodi

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

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

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

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
Initialize() Initialize() Initialize() Initialize()

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

InitializeCell(TableCell, Int32, ListItemType) InitializeCell(TableCell, Int32, ListItemType) InitializeCell(TableCell, Int32, ListItemType) 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) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

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

(Inherited from DataGridColumn)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
OnColumnChanged() OnColumnChanged() OnColumnChanged() OnColumnChanged()

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

(Inherited from DataGridColumn)
SaveViewState() SaveViewState() SaveViewState() SaveViewState()

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

(Inherited from DataGridColumn)
ToString() ToString() ToString() ToString()

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

(Inherited from DataGridColumn)
TrackViewState() TrackViewState() TrackViewState() 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.

(Inherited from DataGridColumn)

Implementazioni dell'interfaccia esplicita

IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

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

(Inherited from DataGridColumn)
IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState()

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

(Inherited from DataGridColumn)
IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState()

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

(Inherited from DataGridColumn)

Si applica a

Vedi anche