This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

DataGridColumnCollection الفئة

Visual Studio 2010

مجموعة من DataGridColumn-مشتقة من الكائنات العمود التي تمثل أعمدة في DataGridعنصر تحكم. و هذه الفئة لا يمكن أن تكون موروثة.

مساحة الاسم:  System.Web.UI.WebControls
التجميع:  System.Web (في System.Web.dll)

public sealed class DataGridColumnCollection : ICollection, 
	IEnumerable, IStateManager

استخدام DataGridColumnCollectionمجموعة إلى برمجياً بإدارة مجموعة من DataGridColumn-اشتقاق الكائنات العمود. هذه الكائنات تمثل أعمدة في DataGridعنصر تحكم. يمكنك إضافة أو إزالة، أو إدراج أعمدة في DataGridColumnCollectionمجموعة.

ملاحظةملاحظة

عند AutoGenerateColumnsخاصية هو معينة إلى true,أعمدة التي تم إنشاؤها بواسطة DataGridلا تتم تمت الإضافة عنصر تحكم إلى Columnsالتعيين.

DataGrid عنصر تحكم عدم تخزين المحتويات به Columnsمجموعة في الولاية العرض. لإضافة أو إزالة عمود بشكل حيوي، يجب عليك برمجياً إضافة أو إزالة العمود في كل مرة تقوم الصفحة هو تحديث. توفر Page_Initالدالة التي تضيف أو تزيل العمود قبل DataGridالولاية عنصر التحكم هو إعادة تحميل وعنصر التحكم هو إعادة بناء. Otherwهوe، يتغير إلى Columnsمجموعة لن تنعكس DataGridالتحكم عند ذلك هو dهوplayed.

ملاحظةملاحظة

على الرغم من أنه يمكنك برمجياً إضافة أعمدة إلى أو إزالة أعمدة من Columnsمجموعة من DataGridعنصر التحكم، هو أسهل lهوt الأعمدة ثابت ثم استخدم Visibleخاصية إلى dهوplay أو إخفاء كل عمود.

يحدد ترتيب أعمدة في المجموعة ترتيب عرض أعمدة في DataGridعنصر تحكم.

يسرد الجدول التالي عمود آخر فئات الذي ينحدر من DataGridColumnفئة.

عمود فئة

الوصف

BoundColumn

عمود التي هو منضم إلى حقل في مصدر بيانات. يظهر كل عنصر في الحقل كـ النص. هذا هو نوع العمود الافتراضي ل DataGridعنصر تحكم.

ButtonColumn

عمود يعرض زر أمر لكل العنصر في العمود. يسمح لك هذا إلى إنشاء عمود cusإلىm butإلىn، مثل إضافة أو إزالة butإلىns.

EditCommandColumn

عمود يحتوي على ‏‏تحرير الأوامر لكل العنصر في العمود.

HyperLinkColumn

أ عمود الذي يعرض كل عنصر في عمود كارتباط تشعبي. المحتويات عمود يمكن أن يكون منضماً إلى حقل في مصدر بيانات، أو إلى نص ثابت.

TemplateColumn

عمود يعرض كل عنصر في العمود استناداً إلى قالب معين. يسمح لك هذا ب عنصر تحكم محتوى العمود، على سبيل المثال لعرض الصور.

ملاحظةملاحظة

DataGridColumn الفئة هو الفئة الأساسية العمود فئات lهوted. هو لا تستخدم مباشرة في DataGridColumnCollectionمجموعة.

مثال التعليمة البرمجية التالية يوضح كيفية استخدام DataGridColumnCollectionمجموعة إلى حيويا إضافة عمود إلى DataGridعنصر التحكم. لاحظ أن Columnsخاصية DataGridعنصر التحكم هو مثيل DataGridColumnCollectionفئة.



<%@ 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 runat="server">

      ICollection CreateDataSource() 
      {

         // Create sample data for the DataGrid control.
         DataTable dt = new DataTable();
         DataRow dr;

         // Define the columns of the table.
         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));

         // Populate the table with sample values.
         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) 
      {

         // Create a DataGrid control.
         DataGrid ItemsGrid = new DataGrid();

         // Set the properties of the DataGrid.
         ItemsGrid.ID = "ItemsGrid";
         ItemsGrid.BorderColor = System.Drawing.Color.Black;
         ItemsGrid.CellPadding = 3;
         ItemsGrid.AutoGenerateColumns = false;

         // Set the styles for the DataGrid.
         ItemsGrid.HeaderStyle.BackColor = 
             System.Drawing.Color.FromArgb(0x0000aaaa);

         // Create the columns for the DataGrid control. The DataGrid
         // columns are dynamically generated. Therefore, the columns   
         // must be re-created each time the page is refreshed.

         // Create and add the columns to the collection.
         ItemsGrid.Columns.Add(CreateBoundColumn("IntegerValue", "Item"));
         ItemsGrid.Columns.Add(
             CreateBoundColumn("StringValue", "Description"));
         ItemsGrid.Columns.Add(
             CreateBoundColumn("CurrencyValue", "Price", "{0:c}", 
             HorizontalAlign.Right));
         ItemsGrid.Columns.Add(
             CreateLinkColumn("http://www.microsoft.com", "_self", 
             "Microsoft", "Related link"));

         // Specify the data source and bind it to the control.
         ItemsGrid.DataSource = CreateDataSource();
         ItemsGrid.DataBind();

         // Add the DataGrid control to the Controls collection of 
         // the PlaceHolder control.
         Place.Controls.Add(ItemsGrid);

      }

      BoundColumn CreateBoundColumn(String DataFieldValue, 
          String HeaderTextValue)
      {

         // This version of the CreateBoundColumn method sets only the
         // DataField and HeaderText properties.

         // Create a BoundColumn.
         BoundColumn column = new BoundColumn();

         // Set the properties of the BoundColumn.
         column.DataField = DataFieldValue;
         column.HeaderText = HeaderTextValue;

         return column;

      }

      BoundColumn CreateBoundColumn(String DataFieldValue, 
          String HeaderTextValue, String FormatValue, 
          HorizontalAlign AlignValue)
      {

         // This version of CreateBoundColumn method sets the DataField,
         // HeaderText, and DataFormatString properties. It also sets the 
         // HorizontalAlign property of the ItemStyle property of the column. 

         // Create a BoundColumn using the overloaded CreateBoundColumn method.
         BoundColumn column = CreateBoundColumn(DataFieldValue, HeaderTextValue);

         // Set the properties of the BoundColumn.
         column.DataFormatString = FormatValue;
         column.ItemStyle.HorizontalAlign = AlignValue;

         return column;

      }

      HyperLinkColumn CreateLinkColumn(String NavUrlValue, 
          String TargetValue, String TextValue, String HeaderTextValue)
      {

         // Create a BoundColumn.
         HyperLinkColumn column = new HyperLinkColumn();

         // Set the properties of the ButtonColumn.
         column.NavigateUrl = NavUrlValue;
         column.Target = TargetValue;
         column.Text = TextValue;
         column.HeaderText = HeaderTextValue;

         return column;

      }

   </script>

<head runat="server">
    <title>DataGrid Constructor Example</title>
</head>
<body>

   <form id="form1" runat="server">

      <h3>DataGrid Constructor Example</h3>

      <b>Product List</b>

      <asp:PlaceHolder id="Place"
           runat="server"/>

   </form>

</body>
</html>



System.Object
  System.Web.UI.WebControls.DataGridColumnCollection

يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في Visual Basic) من هذا النوع. لن يتم ضمان تأمين العملية الجزئية لأي عضو مثيل.

نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0, 1.1, 1.0
إظهار: