BoundColumn Klasa

Definicja

Namespace:: System.Web.UI.WebControls

Montaż:: System.Web.dll

Ważny

Niektóre informacje dotyczą produktów przedpremierowych, które mogą zostać znacznie zmodyfikowane przed premierą. Microsoft nie udziela żadnych gwarancji, ani wyraźnych, ani domniemanych, dotyczących informacji podanych tutaj.

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.

Konstruktorów

Nazwa	Opis
BoundColumn()	Inicjuje nowe wystąpienie klasy BoundColumn.

Pola

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

Właściwości

Nazwa	Opis
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. (Dziedziczone od DataGridColumn)
FooterStyle	Pobiera właściwości stylu dla sekcji stopki kolumny. (Dziedziczone od DataGridColumn)
FooterText	Pobiera lub ustawia tekst wyświetlany w sekcji stopki kolumny. (Dziedziczone od DataGridColumn)
HeaderImageUrl	Pobiera lub ustawia lokalizację obrazu do wyświetlenia w sekcji nagłówka kolumny. (Dziedziczone od DataGridColumn)
HeaderStyle	Pobiera właściwości stylu dla sekcji nagłówka kolumny. (Dziedziczone od DataGridColumn)
HeaderText	Pobiera lub ustawia tekst wyświetlany w sekcji nagłówka kolumny. (Dziedziczone od DataGridColumn)
IsTrackingViewState	Pobiera wartość określającą, czy DataGridColumn obiekt jest oznaczony w celu zapisania jego stanu. (Dziedziczone od DataGridColumn)
ItemStyle	Pobiera właściwości stylu dla komórek elementów kolumny. (Dziedziczone od DataGridColumn)
Owner	Pobiera kontrolkę DataGrid , do którego należy kolumna. (Dziedziczone od 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. (Dziedziczone od DataGridColumn)
ViewState	StateBag Pobiera obiekt, który umożliwia kolumnie pochodzącej DataGridColumn z klasy przechowywanie jej właściwości. (Dziedziczone od DataGridColumn)
Visible	Pobiera lub ustawia wartość wskazującą, czy kolumna jest widoczna w kontrolce DataGrid . (Dziedziczone od DataGridColumn)

Metody

Nazwa	Opis
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Dziedziczone od 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. (Dziedziczone od Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Dziedziczone od 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. (Dziedziczone od DataGridColumn)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Dziedziczone od Object)
OnColumnChanged()	Wywołuje metodę OnColumnsChanged() . (Dziedziczone od DataGridColumn)
SaveViewState()	Zapisuje bieżący stan DataGridColumn obiektu. (Dziedziczone od DataGridColumn)
ToString()	Zwraca reprezentację ciągu kolumny. (Dziedziczone od DataGridColumn)
TrackViewState()	Powoduje śledzenie zmian stanu widoku w kontrolce serwera, dzięki czemu można je przechowywać w obiekcie kontrolki StateBag serwera. (Dziedziczone od DataGridColumn)

Implementacje interfejsów jawnych

Nazwa	Opis
IStateManager.IsTrackingViewState	Pobiera wartość wskazującą, czy kolumna śledzi zmiany stanu widoku. (Dziedziczone od DataGridColumn)
IStateManager.LoadViewState(Object)	Ładuje wcześniej zapisany stan. (Dziedziczone od DataGridColumn)
IStateManager.SaveViewState()	Zwraca obiekt zawierający zmiany stanu. (Dziedziczone od DataGridColumn)
IStateManager.TrackViewState()	Rozpoczyna śledzenie zmian stanu. (Dziedziczone od DataGridColumn)

Dotyczy

Zobacz także

Sprzężenie zwrotne

Czy ta strona była pomocna?