다음을 통해 공유


DynamicField 클래스

정의

ASP.NET Dynamic Data 기능을 사용하는 데이터 바인딩된 컨트롤에 표시되는 데이터 필드를 나타냅니다.

public ref class DynamicField : System::Web::UI::WebControls::DataControlField, System::Web::DynamicData::IFieldFormattingOptions, System::Web::UI::IAttributeAccessor
public class DynamicField : System.Web.UI.WebControls.DataControlField, System.Web.DynamicData.IFieldFormattingOptions, System.Web.UI.IAttributeAccessor
type DynamicField = class
    inherit DataControlField
    interface IAttributeAccessor
    interface IFieldFormattingOptions
Public Class DynamicField
Inherits DataControlField
Implements IAttributeAccessor, IFieldFormattingOptions
상속
DynamicField
구현

예제

이 기능은 런타임에 코드 예제를 보려면: 실행합니다.

다음 예제에서는 컨트롤의 DynamicField 개체 GridView 를 사용하여 데이터베이스 테이블의 값을 표시하고 편집하는 방법을 보여 줍니다.

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
  protected void Page_Init(object sender, EventArgs e)
  {
    DynamicDataManager1.RegisterControl(CustomersGridView);
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
  <title>DynamicField Sample</title>
  <link href="~/Site.css" rel="stylesheet" type="text/css" />
</head>
<body>
  <form id="form1" runat="server">
    <div>
    
      <h2><%= CustomersDataSource.TableName%> Table</h2>
      
      <asp:DynamicDataManager ID="DynamicDataManager1" runat="server"
        AutoLoadForeignKeys="true" />
        
      <asp:ValidationSummary ID="ValidationSummary1" runat="server" EnableClientScript="true" 
        HeaderText="List of validation errors"  />
      <asp:DynamicValidator runat="server" ID="DynamicValidator1"
        ControlToValidate="CustomersGridView" Display="None" />
        
      <asp:GridView ID="CustomersGridView" runat="server"
        AutoGenerateColumns="false"
        AutoGenerateEditButton="true"
        AutoGenerateDeleteButton="true"
        DataSourceID="CustomersDataSource"
        AllowPaging="true"
        AllowSorting="true"
        CssClass="gridview">
        <Columns>
          <asp:DynamicField DataField="CustomerID" />
          <asp:DynamicField DataField="FirstName" />
          <asp:DynamicField DataField="LastName" />
        </Columns>        
      </asp:GridView>

      <!-- This example uses Microsoft SQL Server and connects   -->
      <!-- to the AdventureWorksLT sample database.              -->
      <asp:LinqDataSource ID="CustomersDataSource" runat="server" 
        TableName="Customers"
        ContextTypeName="AdventureWorksLTDataContext"
        EnableUpdate="true"
        EnableDelete="true" >
      </asp:LinqDataSource>
      
    </div>
  </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">

<script runat="server">
  
  Protected Sub Page_Init(ByVal sender As Object, ByVal e As System.EventArgs)    
    DynamicDataManager1.RegisterControl(CustomersGridView)
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
  <title>DynamicField Sample</title>
  <link href="~/Site.css" rel="stylesheet" type="text/css" />
</head>
<body>
  <form id="form1" runat="server">
    <div>
    
      <h2><%= CustomersDataSource.TableName%> Table</h2>
      
      <asp:DynamicDataManager ID="DynamicDataManager1" runat="server"
        AutoLoadForeignKeys="true" />
        
      <asp:ValidationSummary ID="ValidationSummary1" runat="server" EnableClientScript="true" 
        HeaderText="List of validation errors"  />
      <asp:DynamicValidator runat="server" ID="DynamicValidator1"
        ControlToValidate="CustomersGridView" Display="None" />
        
      <asp:GridView ID="CustomersGridView" runat="server"
        AutoGenerateColumns="false"
        AutoGenerateEditButton="true"
        AutoGenerateDeleteButton="true"
        DataSourceID="CustomersDataSource"
        AllowPaging="true"
        AllowSorting="true"
        CssClass="gridview">
        <Columns>
          <asp:DynamicField DataField="CustomerID" />
          <asp:DynamicField DataField="FirstName" />
          <asp:DynamicField DataField="LastName" />
        </Columns>        
      </asp:GridView>

      <!-- This example uses Microsoft SQL Server and connects   -->
      <!-- to the AdventureWorksLT sample database.              -->
      <asp:LinqDataSource ID="CustomersDataSource" runat="server" 
        TableName="Customers"
        ContextTypeName="AdventureWorksLTDataContext"
        EnableUpdate="true"
        EnableDelete="true" >
      </asp:LinqDataSource>
      
    </div>
  </form>
</body>
</html>

설명

항목 내용

소개

클래스 DynamicField 는 사용자 지정 페이지에서 ASP.NET 동적 데이터 기능을 사용하는 필드 값을 표시하기 위해 데이터 바인딩된 컨트롤(DetailsView예: GridView 컨트롤)에서 사용됩니다.

클래스는 DynamicField 클래스와 BoundField 유사한 기능을 제공합니다. 그러나 때문에 DynamicField Dynamic Data 애플리케이션에서 개체를 사용 하는, 다음 Dynamic Data 기능 활용을 걸릴 수 있습니다.

  • 데이터 형식에 따라 자동으로 필드 템플릿을 사용 하 여 필드에 대 한 적절 한 컨트롤을 렌더링 합니다. 필드 템플릿이 전체 애플리케이션에 대 한 전역적으로 수정할 수 있습니다.

  • 데이터베이스 스키마를 기반으로 하는 기본 제공 데이터 유효성 검사를 제공 합니다. 데이터 모델을 사용자 지정 하 여 유효성 검사 형식을 추가할 수도 있습니다.

  • 데이터 모델의 특성을 사용 하거나 사용 하 여 개별 필드에 대 한 데이터 렌더링을 사용자 지정을 UIHint 속성입니다.

개체는 DynamicField 컨트롤을 사용하여 DynamicControl 각 필드를 렌더링합니다. 개체에 표시 DynamicField 할 데이터 필드를 지정하려면 속성을 필드 이름으로 설정합니다 DataField . 설정 하 여 필드 값을 사용자 지정 서식 문자열을 적용할 수 있습니다는 DataFormatString 속성입니다. 기본적으로 데이터 바인딩된 컨트롤이 읽기 전용 모드인 경우에만 필드 값에 서식 문자열이 적용됩니다. 서식 문자열에 데이터 바인딩된 컨트롤이 편집 모드에 있는 동안 표시 되는 값을 적용 하려면 설정 합니다 ApplyFormatInEditMode 속성을 true입니다. 필드 값이 null를 설정 하 여 사용자 지정 캡션을 표시할 수 있습니다는 NullDisplayText 속성입니다. 합니다 DynamicField 개체에는 빈 문자열도 자동 변환할 수 있습니다 ("") 값을 null 값으로 설정 하 여 필드를 ConvertEmptyStringToNull 속성을 true입니다.

선언 구문

<asp:DynamicField
    AccessibleHeaderText="string"
    ApplyFormatInEditMode="true|false"
    ControlStyle-BackColor="color name|#dddddd"
    ControlStyle-BorderColor="color name|#dddddd"
    ControlStyle-BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|
       Ridge|Inset|Outset"
    ControlStyle-BorderWidth="size"
    ControlStyle-CssClass="string"
    ControlStyle-Font-Bold="true|false"
    ControlStyle-Font-Italic="true|false"
    ControlStyle-Font-Names="string"
    ControlStyle-Font-Overline="true|false"
    ControlStyle-Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
       Large|X-Large|XX-Large"
    ControlStyle-Font-Strikeout="true|false"
    ControlStyle-Font-Underline="true|false"
    ControlStyle-ForeColor="color name|#dddddd"
    ControlStyle-Height="size"
    ControlStyle-Width="size"
    ConvertEmptyStringToNull="true|false"
    DataField="string"
    DataFormatString="string"
    FooterStyle-BackColor="color name|#dddddd"
    FooterStyle-BorderColor="color name|#dddddd"
    FooterStyle-BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|
       Ridge|Inset|Outset"
    FooterStyle-BorderWidth="size"
    FooterStyle-CssClass="string"
    FooterStyle-Font-Bold="true|false"
    FooterStyle-Font-Italic="true|false"
    FooterStyle-Font-Names="string"
    FooterStyle-Font-Overline="true|false"
    FooterStyle-Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
       Large|X-Large|XX-Large"
    FooterStyle-Font-Strikeout="true|false"
    FooterStyle-Font-Underline="true|false"
    FooterStyle-ForeColor="color name|#dddddd"
    FooterStyle-Height="size"
    FooterStyle-Width="size"
    FooterStyle-HorizontalAlign="Center|Justify|Left|NotSet|Right"
    FooterStyle-VerticalAlign="Bottom|Middle|NotSet|Top"
    FooterStyle-Wrap="true|false"
    HeaderImageUrl="uri"
    HeaderStyle-BackColor="color name|#dddddd"
    HeaderStyle-BorderColor="color name|#dddddd"
    HeaderStyle-BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|
       Ridge|Inset|Outset"
    HeaderStyle-BorderWidth="size"
    HeaderStyle-CssClass="string"
    HeaderStyle-Font-Bold="true|false"
    HeaderStyle-Font-Italic="true|false"
    HeaderStyle-Font-Names="string"
    HeaderStyle-Font-Overline="true|false"
    HeaderStyle-Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
       Large|X-Large|XX-Large"
    HeaderStyle-Font-Strikeout="true|false"
    HeaderStyle-Font-Underline="true|false"
    HeaderStyle-ForeColor="color name|#dddddd"
    HeaderStyle-Height="size"
    HeaderStyle-Width="size"
    HeaderStyle-HorizontalAlign="Center|Justify|Left|NotSet|Right"
    HeaderStyle-VerticalAlign="Bottom|Middle|NotSet|Top"
    HeaderStyle-Wrap="true|false"
    HeaderText="string"
    InsertVisible="true|false"
    ItemStyle-BackColor="color name|#dddddd"
    ItemStyle-BorderColor="color name|#dddddd"
    ItemStyle-BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|
       Ridge|Inset|Outset"
    ItemStyle-BorderWidth="size"
    ItemStyle-CssClass="string"
    ItemStyle-Font-Bold="true|false"
    ItemStyle-Font-Italic="true|false"
    ItemStyle-Font-Names="string"
    ItemStyle-Font-Overline="true|false"
    ItemStyle-Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
       Large|X-Large|XX-Large"
    ItemStyle-Font-Strikeout="true|false"
    ItemStyle-Font-Underline="true|false"
    ItemStyle-ForeColor="color name|#dddddd"
    ItemStyle-Height="size"
    ItemStyle-Width="size"
    ItemStyle-HorizontalAlign="Center|Justify|Left|NotSet|Right"
    ItemStyle-VerticalAlign="Bottom|Middle|NotSet|Top"
    ItemStyle-Wrap="true|false"
    NullDisplayText="string"
    ReadOnly="true|false"
    ShowHeader="true|false"
    SortExpression="string"
    UIHint="string"
    ValidationGroup="string"
    Visible="true|false"
    />
<asp:DynamicField />

생성자

DynamicField()

DynamicField 클래스의 새 인스턴스를 초기화합니다.

속성

AccessibleHeaderText

일부 컨트롤에서 AbbreviatedText 속성 값으로 렌더링되는 텍스트를 가져오거나 설정합니다.

(다음에서 상속됨 DataControlField)
ApplyFormatInEditMode

데이터 필드가 편집 모드에 있을 때 DataFormatString 속성에서 지정하는 서식 문자열이 필드 값에 적용되는지 여부를 나타내는 값을 가져오거나 설정합니다.

Column

MetaColumn 개체가 연결된 DynamicField 개체를 가져옵니다.

Control

DataControlField 개체가 연결된 데이터 컨트롤에 대한 참조를 가져옵니다.

(다음에서 상속됨 DataControlField)
ControlStyle

DataControlField 개체에 포함된 웹 서버 컨트롤의 스타일을 가져옵니다.

(다음에서 상속됨 DataControlField)
ConvertEmptyStringToNull

데이터 소스에서 데이터 필드가 업데이트되는 경우 빈 문자열 값("")이 자동으로 null 값으로 변환되는지 여부를 나타내는 값을 가져오거나 설정합니다.

DataField

DynamicField 개체를 바인딩할 데이터 필드의 이름을 가져오거나 설정합니다.

DataFormatString

데이터 필드 값의 표시 형식을 지정하는 문자열을 가져오거나 설정합니다.

DesignMode

데이터 컨트롤 필드가 현재 디자인 타임 환경에서 표시되는지 여부를 나타내는 값을 가져옵니다.

(다음에서 상속됨 DataControlField)
FooterStyle

데이터 컨트롤 필드의 바닥글 스타일을 가져오거나 설정합니다.

(다음에서 상속됨 DataControlField)
FooterText

데이터 컨트롤 필드의 바닥글 항목에 표시되는 텍스트를 가져오거나 설정합니다.

(다음에서 상속됨 DataControlField)
HeaderImageUrl

데이터 컨트롤 필드의 머리글 항목에 표시되는 이미지의 URL을 가져오거나 설정합니다.

(다음에서 상속됨 DataControlField)
HeaderStyle

데이터 컨트롤 필드의 머리글 스타일을 가져오거나 설정합니다.

(다음에서 상속됨 DataControlField)
HeaderText

DynamicField 개체를 포함하는 데이터 바인딩된 컨트롤의 머리글에 표시되는 텍스트를 가져오거나 설정합니다.

HtmlEncode

데이터 필드 값이 DynamicField 개체에 표시되기 전에 HTML로 인코딩되는지 여부를 나타내는 값을 가져오거나 설정합니다.

InsertVisible

데이터 바인딩된 부모 컨트롤이 삽입 모드에 있는 경우 DataControlField 개체가 표시되는지 여부를 나타내는 값을 가져옵니다.

(다음에서 상속됨 DataControlField)
IsTrackingViewState

DataControlField 개체가 해당 뷰 상태의 변경 내용을 저장하는지 여부를 나타내는 값을 가져옵니다.

(다음에서 상속됨 DataControlField)
ItemStyle

데이터 컨트롤 필드에 표시되는 텍스트 기반 내용의 스타일을 가져옵니다.

(다음에서 상속됨 DataControlField)
NullDisplayText

필드 값이 null인 경우 데이터 필드에 대해 표시되는 캡션을 가져오거나 설정합니다.

ReadOnly

동적 필드의 읽기 전용 상태를 가져옵니다.

ShowHeader

데이터 컨트롤 필드의 머리글 항목이 렌더링되는지 여부를 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 DataControlField)
SortExpression

데이터 필드를 사용하여 데이터 소스를 정렬할 때 사용되는 정렬 식을 가져오거나 설정합니다.

UIHint

데이터 필드를 표시하기 위해 사용할 필드 템플릿을 가져오거나 설정합니다.

ValidateRequestMode

컨트롤이 클라이언트 입력의 유효성을 검사하는지 여부를 지정하는 값을 가져오거나 설정합니다.

ValidateRequestMode

컨트롤이 클라이언트 입력의 유효성을 검사하는지 여부를 지정하는 값을 가져오거나 설정합니다.

(다음에서 상속됨 DataControlField)
ValidationGroup

ValidationGroup 개체가 연결된 DynamicField 개체를 가져옵니다.

ViewState

같은 페이지에 대한 여러 개의 요청 전반에 DataControlField 개체의 뷰 상태를 저장하고 복원하는 데 사용할 수 있는 상태 정보 사전을 가져옵니다.

(다음에서 상속됨 DataControlField)
Visible

데이터 컨트롤 필드가 렌더링되는지 여부를 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 DataControlField)

메서드

CloneField()

현재 DataControlField에서 파생된 개체의 복사본을 만듭니다.

(다음에서 상속됨 DataControlField)
ConfigureDynamicControl(DynamicControl)

DynamicControl 메서드에 의해 만들어진 InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) 개체를 수정하는 메커니즘을 제공합니다.

CopyProperties(DataControlField)

현재 DynamicField 개체의 속성을 지정된 DataControlField 개체로 복사합니다.

CreateDynamicControl()

DynamicField에서 파생되는 클래스에 대한 메커니즘을 제공하여 DynamicControl 개체가 만들어지는 방법을 재정의합니다.

CreateField()

DynamicField 클래스의 새 인스턴스를 만들어 반환합니다.

Equals(Object)

지정된 개체가 현재 개체와 같은지 확인합니다.

(다음에서 상속됨 Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

표 셀에서 데이터 필드의 값을 추출하여 지정된 사전에 추가합니다.

GetAttribute(String)

지정된 특성 값을 검색합니다.

GetHashCode()

기본 해시 함수로 작동합니다.

(다음에서 상속됨 Object)
GetType()

현재 인스턴스의 Type을 가져옵니다.

(다음에서 상속됨 Object)
Initialize(Boolean, Control)

데이터 컨트롤 필드에 대한 기본 인스턴스 초기화를 수행합니다.

(다음에서 상속됨 DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

지정된 셀에 텍스트 또는 컨트롤을 추가합니다.

LoadViewState(Object)

데이터 소스 뷰를 이전에 저장된 뷰 상태로 복원합니다.

(다음에서 상속됨 DataControlField)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.

(다음에서 상속됨 Object)
OnFieldChanged()

FieldChanged 이벤트를 발생시킵니다.

(다음에서 상속됨 DataControlField)
SaveViewState()

페이지가 서버에 포스트백된 이후의 DataControlField 뷰 상태 변경 내용을 저장합니다.

(다음에서 상속됨 DataControlField)
SetAttribute(String, String)

DynamicField 개체에 연결된 특성을 설정합니다.

ToString()

DataControlField 개체를 나타내는 문자열을 반환합니다.

(다음에서 상속됨 DataControlField)
TrackViewState()

DataControlField 개체가 뷰 상태의 변경 내용을 추적하도록 합니다. 이렇게 하면 해당 뷰 상태의 변경 내용을 컨트롤의 ViewState 속성에 저장하여 같은 페이지에 대한 여러 요청에서 일관되게 유지할 수 있습니다.

(다음에서 상속됨 DataControlField)
ValidateSupportsCallback()

파생 클래스에서 재정의될 때 필드에 포함된 컨트롤에서 콜백이 지원되는지를 알립니다.

(다음에서 상속됨 DataControlField)

명시적 인터페이스 구현

IDataSourceViewSchemaAccessor.DataSourceViewSchema

DataControlField 개체에 연결된 스키마를 가져오거나 설정합니다.

(다음에서 상속됨 DataControlField)
IStateManager.IsTrackingViewState

DataControlField 개체가 해당 뷰 상태의 변경 내용을 저장하는지 여부를 나타내는 값을 가져옵니다.

(다음에서 상속됨 DataControlField)
IStateManager.LoadViewState(Object)

데이터 컨트롤 필드를 이전에 저장된 뷰 상태로 복원합니다.

(다음에서 상속됨 DataControlField)
IStateManager.SaveViewState()

페이지가 서버에 포스트백된 이후의 DataControlField 뷰 상태 변경 내용을 저장합니다.

(다음에서 상속됨 DataControlField)
IStateManager.TrackViewState()

DataControlField 개체가 뷰 상태의 변경 내용을 추적하도록 합니다. 이렇게 하면 해당 뷰 상태의 변경 내용을 컨트롤의 ViewState 속성에 저장하여 같은 페이지에 대한 여러 요청에서 일관되게 유지할 수 있습니다.

(다음에서 상속됨 DataControlField)

확장 메서드

ConvertEditedValue(IFieldFormattingOptions, String)

유효성을 검사할 컨트롤에 대해 사용자가 제공한 값을 반환합니다.

FormatEditValue(IFieldFormattingOptions, Object)

지정된 서식 옵션을 사용하여 지정된 필드 값의 서식을 지정합니다.

FormatValue(IFieldFormattingOptions, Object)

지정된 서식 옵션을 사용하여 지정된 필드 값의 서식을 지정합니다.

적용 대상

추가 정보