다음을 통해 공유


ImageField 클래스

정의

데이터 바인딩된 컨트롤에 이미지로 표시되는 필드를 나타냅니다.

public ref class ImageField : System::Web::UI::WebControls::DataControlField
public class ImageField : System.Web.UI.WebControls.DataControlField
type ImageField = class
    inherit DataControlField
Public Class ImageField
Inherits DataControlField
상속

예제

다음 예제에 사용 하는 방법을 보여 줍니다.는 ImageField 개체는 GridView 이미지를 표시 하는 컨트롤입니다.


<%@ 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>ImageField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>ImageField Example</h3>
                       
      <asp:gridview id="EmployeesGrid"
        autogeneratecolumns="false"
        datasourceid="EmployeeSource"  
        runat="server">
      
        <columns>

          <asp:imagefield dataimageurlfield="PhotoPath"
            alternatetext="Employee Photo"
            nulldisplaytext="No image on file."
            headertext="Photo"  
            readonly="true"/>
          <asp:boundfield datafield="FirstName"
            headertext="First Name"/>
          <asp:boundfield datafield="LastName"
            headertext="Last Name"/>
        
        </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="EmployeeSource"
        selectcommand="Select [EmployeeID], [LastName], [FirstName], [PhotoPath] From [Employees]"
        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>ImageField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>ImageField Example</h3>
                       
      <asp:gridview id="EmployeesGrid"
        autogeneratecolumns="false"
        datasourceid="EmployeeSource"  
        runat="server">
      
        <columns>

          <asp:imagefield dataimageurlfield="PhotoPath"
            alternatetext="Employee Photo"
            nulldisplaytext="No image on file."
            headertext="Photo"  
            readonly="true"/>
          <asp:boundfield datafield="FirstName"
            headertext="First Name"/>
          <asp:boundfield datafield="LastName"
            headertext="Last Name"/>
        
        </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="EmployeeSource"
        selectcommand="Select [EmployeeID], [LastName], [FirstName], [PhotoPath] From [Employees]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
            
    </form>
  </body>
</html>

설명

합니다 ImageField 클래스는 데이터 바인딩된 컨트롤에서 사용 됩니다 (같은 GridViewDetailsView) 표시 되는 각 레코드에 대 한 이미지를 표시 하려면. ImageField 개체가 사용 되는 데이터 바인딩된 컨트롤에 따라 다르게 표시 됩니다. 예를 들어 합니다 GridView 컨트롤이 표시는 ImageField 열을 개체로 하는 동안는 DetailsView 컨트롤 행으로 표시 합니다.

이미지를 표시 하려면 바인딩해야는 ImageField 이미지의 URL이 포함 된 데이터 원본의 필드 개체입니다. 설정 하 여 이렇게는 DataImageUrlField 속성입니다. URL 값을 사용 하 여 서식을 지정할 수는 DataImageUrlFormatString 속성입니다. 각 이미지 대체 텍스트를 연결할 수도 있습니다. 이 텍스트는 이미지를 로드할 수 없습니다 또는 사용할 수 없는 경우에 표시 됩니다. 도구 설명 기능을 지 원하는 브라우저 도구 설명으로이 텍스트를 표시할 수도 있습니다. 다음 방법 중 하나를 사용 하 여 표시 된 이미지에 대 한 대체 텍스트를 지정할 수 있습니다.

  • 사용 된 AlternateText 모든 이미지에 적용 되는 대체 텍스트를 지정 하는 속성입니다.

  • 사용 하 여는 DataAlternateTextField 필드를 데이터 소스에서 바인딩할 속성을 AlternateText 각 이미지의 속성입니다. 이 방법으로 표시 되는 각 이미지에 대 한 다양 한 대체 텍스트를 할 수 있습니다. 대체 텍스트를 사용 하 여 필요에 따라 서식을 지정할 수 데이터를 바인딩하는 경우는 DataAlternateTextFormatString 속성입니다.

이미지에 대 한 URL 값이 null, 이미지를 표시할 수 없습니다. 대체 이미지를 표시할 수 있습니다 null 값을 설정 하 여 필드를 NullImageUrl 속성입니다. 대체 이미지 대신 설정 하 여 대체 텍스트를 표시 합니다 NullDisplayText 속성입니다.

기본적으로 선언 된 모든 필드는 데이터 바인딩된 컨트롤에 표시 됩니다. 숨길 수 있습니다는 ImageField 설정 하 여 데이터 바인딩된 컨트롤에 개체를 Visible 속성을 false입니다.

머리글 및 바닥글 섹션을 사용자 지정할 수는 ImageField 개체입니다. 캡션을 머리글 또는 바닥글 구역에 표시할 설정 합니다 HeaderText 또는 FooterText 속성을 각각. 텍스트 대신 헤더 섹션에는 이미지를 표시 하려면 설정의 HeaderImageUrl 속성입니다. 헤더 섹션에 숨겨져 있을 수는 ImageField 설정 하 여 개체를 ShowHeader 속성을 false입니다.

참고

일부 데이터 바인딩된 컨트롤 (같은 GridView 컨트롤) 표시 하거나 컨트롤의 전체 헤더 섹션을 숨길 수 있습니다. 이러한 데이터 바인딩된 컨트롤을 지원 하지 않습니다는 ShowHeader 개별 데이터 바인딩된 필드의 속성입니다. 컨트롤의 사용을 표시 하거나 숨기려면 데이터 바인딩된 컨트롤의 전체 헤더 섹션 하 여 ShowHeader 속성 (있는 경우).

또한 사용자 지정할 수 있습니다 모양의 ImageField 필드의 다른 부분에 대 한 스타일 속성을 설정 하 여 개체 (글꼴 색, 배경색 및 등). 다음 표에서 다양 한 스타일 속성을 나열합니다.

스타일 속성 Description
ControlStyle 자식 웹 서버 컨트롤에 대 한 스타일 설정을 ImageField 개체입니다.
FooterStyle 바닥글 구역에 대 한 스타일 설정을 ImageField 개체입니다.
HeaderStyle 머리글 구역에 대 한 스타일 설정을 ImageField 개체입니다.
ItemStyle 데이터 항목에 대 한 스타일 설정이 ImageField 개체입니다.

생성자

ImageField()

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

필드

ThisExpression

"이" 식을 나타냅니다.

속성

AccessibleHeaderText

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

(다음에서 상속됨 DataControlField)
AlternateText

ImageField 개체에 표시되는 이미지의 대체 텍스트를 가져오거나 설정합니다.

Control

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

(다음에서 상속됨 DataControlField)
ControlStyle

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

(다음에서 상속됨 DataControlField)
ConvertEmptyStringToNull

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

DataAlternateTextField

AlternateText 개체의 각 이미지에 대한 ImageField 속성에 바인딩할 값을 포함하는 데이터 소스의 필드 이름을 가져오거나 설정합니다.

DataAlternateTextFormatString

ImageField 개체의 각 이미지에 대한 대체 텍스트를 렌더링하는 데 사용할 형식을 지정하는 문자열을 가져오거나 설정합니다.

DataImageUrlField

ImageUrl 개체의 각 이미지에 대한 ImageField 속성에 바인딩할 값을 포함하는 데이터 소스의 필드 이름을 가져오거나 설정합니다.

DataImageUrlFormatString

ImageField 개체의 각 이미지에 대한 URL이 렌더링되는 형식을 지정하는 문자열을 가져오거나 설정합니다.

DesignMode

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

(다음에서 상속됨 DataControlField)
FooterStyle

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

(다음에서 상속됨 DataControlField)
FooterText

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

(다음에서 상속됨 DataControlField)
HeaderImageUrl

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

(다음에서 상속됨 DataControlField)
HeaderStyle

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

(다음에서 상속됨 DataControlField)
HeaderText

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

(다음에서 상속됨 DataControlField)
InsertVisible

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

(다음에서 상속됨 DataControlField)
IsTrackingViewState

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

(다음에서 상속됨 DataControlField)
ItemStyle

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

(다음에서 상속됨 DataControlField)
NullDisplayText

ImageField 속성에서 지정하는 필드의 값이 null인 경우 DataImageUrlField 개체에 표시할 텍스트를 가져오거나 설정합니다.

NullImageUrl

ImageField 속성에서 지정하는 필드의 값이 null인 경우 DataImageUrlField 개체에 표시되는 대체 이미지에 대한 URL을 가져오거나 설정합니다.

ReadOnly

DataImageUrlField 속성에서 지정하는 필드 값을 편집 모드에서 수정할 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다.

ShowHeader

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

(다음에서 상속됨 DataControlField)
SortExpression

데이터 소스 컨트롤에서 데이터를 정렬하는 데 사용되는 정렬 식을 가져오거나 설정합니다.

(다음에서 상속됨 DataControlField)
ValidateRequestMode

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

(다음에서 상속됨 DataControlField)
ViewState

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

(다음에서 상속됨 DataControlField)
Visible

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

(다음에서 상속됨 DataControlField)

메서드

CloneField()

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

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

현재 ImageField 개체의 속성을 지정된 개체에 복사합니다.

CreateField()

ImageField 클래스의 새 인스턴스를 반환합니다.

Equals(Object)

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

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

지정된 IOrderedDictionary 개체를 지정된 DataControlFieldCell 개체의 값으로 채웁니다.

FormatImageUrlValue(Object)

DataImageUrlFormatString 속성에서 지정하는 형식을 필드 값에 적용합니다.

GetDesignTimeValue()

디자이너에서 ImageField 개체를 렌더링하는 경우 필드 값에 사용되는 값을 검색합니다.

GetFormattedAlternateText(Control)

DataAlternateTextFormatString 속성에서 지정하는 형식을 지정된 Control 개체에 포함된 대체 텍스트 값에 적용합니다.

GetHashCode()

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

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

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

(다음에서 상속됨 Object)
GetValue(Control, String, PropertyDescriptor)

지정된 컨트롤에서 지정된 필드 값을 검색합니다.

Initialize(Boolean, Control)

초기화는 ImageField 개체입니다.

InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

지정된 DataControlFieldCell 개체를 지정된 셀 형식, 행 상태 및 행 인덱스로 초기화합니다.

InitializeDataCell(DataControlFieldCell, DataControlRowState)

지정된 DataControlFieldCell 개체를 지정된 행 상태로 초기화합니다.

LoadViewState(Object)

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

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

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

(다음에서 상속됨 Object)
OnDataBindField(Object, EventArgs)

필드 값을 ImageField 개체에 바인딩합니다.

OnFieldChanged()

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

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

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

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

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

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

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

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

ImageField 개체에 들어 있는 컨트롤에서 콜백이 지원되는지 여부를 확인합니다.

명시적 인터페이스 구현

IDataSourceViewSchemaAccessor.DataSourceViewSchema

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

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

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

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

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

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

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

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

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

(다음에서 상속됨 DataControlField)

적용 대상

추가 정보