GridView.Columns 속성

  • 참조

정의

네임스페이스:
System.Web.UI.WebControls
어셈블리:
System.Web.dll

DataControlField 컨트롤의 열 필드를 나타내는 GridView 개체의 컬렉션을 가져옵니다.

public:
 virtual property System::Web::UI::WebControls::DataControlFieldCollection ^ Columns { System::Web::UI::WebControls::DataControlFieldCollection ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual System.Web.UI.WebControls.DataControlFieldCollection Columns { get; }
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.Columns : System.Web.UI.WebControls.DataControlFieldCollection
Public Overridable ReadOnly Property Columns As DataControlFieldCollection

속성 값

DataControlFieldCollection

DataControlFieldCollection 컨트롤의 모든 열 필드가 들어 있는 GridView입니다.

특성
PersistenceModeAttribute

예제

다음 예제에서는 컬렉션을 선언적으로 채우는 Columns 방법을 보여 줍니다.


<%@ Page language="C#" %>

<!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" >
  <head runat="server">
    <title>GridView Columns Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView Columns Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        runat="server">
        
        <columns>
          <asp:boundfield datafield="CustomerID" headertext="Customer ID"/>
          <asp:boundfield datafield="CompanyName" headertext="Company Name"/>
          <asp:boundfield datafield="Address" headertext="Address"/>
          <asp:boundfield datafield="City" headertext="City"/>
          <asp:boundfield datafield="PostalCode" headertext="Postal Code"/>
          <asp:boundfield datafield="Country" headertext="Country"/>
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
        
    </form>
  </body>
</html>


<%@ Page language="VB" %>

<!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" >
  <head runat="server">
    <title>GridView Columns Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView Columns Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        runat="server">
        
        <columns>
          <asp:boundfield datafield="CustomerID" headertext="Customer ID"/>
          <asp:boundfield datafield="CompanyName" headertext="Company Name"/>
          <asp:boundfield datafield="Address" headertext="Address"/>
          <asp:boundfield datafield="City" headertext="City"/>
          <asp:boundfield datafield="PostalCode" headertext="Postal Code"/>
          <asp:boundfield datafield="Country" headertext="Country"/>
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
        
    </form>
  </body>
</html>

설명

열 필드는 컨트롤의 열을 GridView 나타냅니다. Columns 속성(컬렉션)은 컨트롤에 렌더링 GridView 되는 명시적으로 선언된 모든 열 필드를 저장하는 데 사용됩니다. 컬렉션을 사용하여 Columns 열 필드의 컬렉션을 프로그래밍 방식으로 관리할 수도 있습니다.

참고

명시적으로 선언된 열 필드는 자동으로 생성된 열 필드와 함께 사용할 수 있습니다. 둘 다 사용되면 명시적으로 선언된 열 필드가 먼저 렌더링되고 그 뒤에 자동으로 생성된 열 필드가 표시됩니다. 자동으로 생성된 열 필드는 컬렉션에 Columns 추가되지 않습니다.

열 필드는 열 필드가 컬렉션에 GridView 표시되는 순서대로 컨트롤에 Columns 표시됩니다. 다음 표에서는 클래스에서 파생되고 컬렉션에서 DataControlField 사용할 수 있는 다양한 열 필드 클래스를 Columns 보여 줍니다.

열 필드 형식 Description
BoundField 데이터 원본의 필드 값을 표시합니다. 기본 열 형식는 GridView 제어 합니다.
ButtonField 컨트롤의 각 항목 GridView 에 대한 명령 단추를 표시합니다. 이렇게 하면 추가 또는 제거 단추와 같은 사용자 지정 단추 컨트롤의 열을 만들 수 있습니다.
CheckBoxField 컨트롤의 각 항목에 대한 확인란을 GridView 표시합니다. 이 열 필드 형식은 일반적으로 부울 값이 있는 필드를 표시하는 데 사용됩니다.
CommandField 선택, 편집 또는 삭제 작업을 수행하기 위해 미리 정의된 명령 단추를 표시합니다.
HyperLinkField 하이퍼링크로 데이터 원본의 필드의 값을 표시합니다. 이 열 필드 형식을 사용하면 하이퍼링크의 URL에 두 번째 필드를 바인딩할 수 있습니다.
ImageField 컨트롤의 각 항목에 GridView 대한 이미지를 표시합니다.
TemplateField 지정된 템플릿에 따라 컨트롤의 각 항목에 GridView 대해 사용자 정의 콘텐츠를 표시합니다. 이 열 필드 형식을 사용하면 사용자 지정 열 필드를 만들 수 있습니다.

프로그래밍 방식으로 열 필드를 컬렉션에 Columns 추가할 수 있지만 컨트롤에서 GridView 선언적으로 열 필드를 나열한 다음 각 열 필드의 속성을 사용하여 Visible 각 열 필드를 표시하거나 숨기는 것이 더 쉽습니다.

Visible 열 필드의 속성을 로 설정false하면 열이 컨트롤에 GridView 표시되지 않고 열의 데이터가 클라이언트로 왕복하지 않습니다. 라운드트립을 만들기 위해 표시되지 않는 열에 대한 데이터를 원하는 경우 속성에 필드 이름을 DataKeyNames 추가합니다.

적용 대상

추가 정보