Udostępnij za pośrednictwem


BoundColumn Klasa

Definicja

Typ kolumny kontrolki DataGrid powiązanej z polem w źródle danych.

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

Przykłady

W poniższym przykładzie pokazano, jak za pomocą BoundColumn typu kolumny w kontrolce DataGrid wyświetlić pola w źródle danych.

<%@ 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>

Uwagi

BoundColumn Użyj typu kolumny w kontrolceDataGrid, aby wyświetlić zawartość pola w źródle danych. Wartości są wymienione w jednej kolumnie. Pole jest połączone z elementem BoundColumn, więc wszystkie aktualizacje w źródle danych będą odzwierciedlane w odpowiednich komórkach kontrolki DataGrid .

Uwaga

Ten typ kolumny jest domyślnym typem kontrolki DataGrid .

Aby kontrolować wygląd tej kolumny, użyj właściwości stylu kontrolki DataGrid .

Przestroga

Tekst nie jest zakodowany w formacie HTML przed wyświetleniem go w pliku BoundColumn. Dzięki temu można osadzić skrypt w tagach HTML w tekście. Jeśli wartości tej kolumny pochodzą z danych wejściowych użytkownika, sprawdź poprawność wartości w celu zmniejszenia luk w zabezpieczeniach.

Konstruktory

BoundColumn()

Inicjuje nowe wystąpienie klasy BoundColumn.

Pola

thisExpr

Reprezentuje ciąg "!". To pole jest tylko do odczytu.

Właściwości

DataField

Pobiera lub ustawia nazwę pola ze źródła danych w celu powiązania z elementem BoundColumn.

DataFormatString

Pobiera lub ustawia ciąg określający format wyświetlania elementów w kolumnie.

DesignMode

Pobiera wartość wskazującą, czy kolumna jest w trybie projektowania.

(Odziedziczone po DataGridColumn)
FooterStyle

Pobiera właściwości stylu dla sekcji stopki kolumny.

(Odziedziczone po DataGridColumn)
FooterText

Pobiera lub ustawia tekst wyświetlany w sekcji stopki kolumny.

(Odziedziczone po DataGridColumn)
HeaderImageUrl

Pobiera lub ustawia lokalizację obrazu do wyświetlenia w sekcji nagłówka kolumny.

(Odziedziczone po DataGridColumn)
HeaderStyle

Pobiera właściwości stylu dla sekcji nagłówka kolumny.

(Odziedziczone po DataGridColumn)
HeaderText

Pobiera lub ustawia tekst wyświetlany w sekcji nagłówka kolumny.

(Odziedziczone po DataGridColumn)
IsTrackingViewState

Pobiera wartość określającą, czy DataGridColumn obiekt jest oznaczony w celu zapisania jego stanu.

(Odziedziczone po DataGridColumn)
ItemStyle

Pobiera właściwości stylu dla komórek elementów kolumny.

(Odziedziczone po DataGridColumn)
Owner

Pobiera kontrolkę DataGrid , do którego należy kolumna.

(Odziedziczone po DataGridColumn)
ReadOnly

Pobiera lub ustawia wartość wskazującą, czy elementy w obiekcie BoundColumn można edytować.

SortExpression

Pobiera lub ustawia nazwę pola lub wyrażenia, które ma być przekazywane do OnSortCommand(DataGridSortCommandEventArgs) metody po wybraniu kolumny do sortowania.

(Odziedziczone po DataGridColumn)
ViewState

StateBag Pobiera obiekt, który umożliwia kolumnie pochodzącej DataGridColumn z klasy przechowywanie jej właściwości.

(Odziedziczone po DataGridColumn)
Visible

Pobiera lub ustawia wartość wskazującą, czy kolumna jest widoczna w kontrolce DataGrid .

(Odziedziczone po DataGridColumn)

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
FormatDataValue(Object)

Konwertuje określoną wartość na format wskazany przez DataFormatString właściwość .

GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
Initialize()

Resetuje element BoundColumn do stanu początkowego.

InitializeCell(TableCell, Int32, ListItemType)

Resetuje określoną komórkę w BoundColumn stanie początkowym.

LoadViewState(Object)

Ładuje stan DataGridColumn obiektu.

(Odziedziczone po DataGridColumn)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
OnColumnChanged()

Wywołuje metodę OnColumnsChanged() .

(Odziedziczone po DataGridColumn)
SaveViewState()

Zapisuje bieżący stan DataGridColumn obiektu.

(Odziedziczone po DataGridColumn)
ToString()

Zwraca reprezentację ciągu kolumny.

(Odziedziczone po DataGridColumn)
TrackViewState()

Powoduje śledzenie zmian stanu widoku w kontrolce serwera, dzięki czemu można je przechowywać w obiekcie kontrolki StateBag serwera.

(Odziedziczone po DataGridColumn)

Jawne implementacje interfejsu

IStateManager.IsTrackingViewState

Pobiera wartość wskazującą, czy kolumna śledzi zmiany stanu widoku.

(Odziedziczone po DataGridColumn)
IStateManager.LoadViewState(Object)

Ładuje wcześniej zapisany stan.

(Odziedziczone po DataGridColumn)
IStateManager.SaveViewState()

Zwraca obiekt zawierający zmiany stanu.

(Odziedziczone po DataGridColumn)
IStateManager.TrackViewState()

Rozpoczyna śledzenie zmian stanu.

(Odziedziczone po DataGridColumn)

Dotyczy

Zobacz też