BoundColumn Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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: Object

DataGridColumn
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