다음을 통해 공유

ImageField.DataAlternateTextFormatString 속성

  • 참조

정의

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

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

public:
 virtual property System::String ^ DataAlternateTextFormatString { System::String ^ get(); void set(System::String ^ value); };
public virtual string DataAlternateTextFormatString { get; set; }
member this.DataAlternateTextFormatString : string with get, set
Public Overridable Property DataAlternateTextFormatString As String

속성 값

String

ImageField 개체의 각 이미지에 대한 대체 텍스트가 렌더링되는 형식을 지정하는 문자열입니다. 기본값은 빈 문자열("")로, 특수 형식이 대체 텍스트에 현재 적용됨을 나타냅니다.

예제

다음 코드 예제를 사용 하는 방법에 설명 합니다 DataAlternateTextFormatString 사용자 지정 형식에 있는 이미지에 대 한 대체 텍스트 값에 적용할 속성은 ImageField 개체입니다.


<%@ 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"
            dataalternatetextfield="LastName"
            dataalternatetextformatstring="Photo: {0}" 
            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"
            dataalternatetextfield="LastName"
            dataalternatetextformatstring="Photo: {0}" 
            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>

설명

사용 하 여 합니다 DataAlternateTextFormatString 속성에 표시 되는 이미지의 대체 텍스트 값에 대 한 사용자 지정 형식을 지정 하는 ImageField 개체입니다.

참고

형식 문자열이 적용 되 경우에만 DataAlternateTextField 속성을 설정 합니다. 있지 경우 적용를 AlternateText 속성을 설정 합니다.

이 필드에 포함 된 원래 값을 수정 해야 하는 경우에 유용 합니다. 경우는 DataAlternateTextFormatString 속성이 설정 되지 않은, 특수 형식이 대체 텍스트 값을 가져오지 못합니다.

형식 문자열 리터럴 문자열일 수 있습니다 및 일반적으로 필드의 값에 대 한 자리 표시자를 포함 합니다. 예를 들어 형식 문자열에서에서 "항목 값: {0}","{0}" 자리 표시자에서 지정 된 필드의 값으로 대체 됩니다는 DataAlternateTextField 속성입니다. 형식 문자열의 나머지 부분 리터럴 텍스트로 표시 됩니다.

참고

형식 문자열에 자리 표시 자가 포함 되어 있지 않으면, 데이터 원본에서 필드의 값 최종 표시 텍스트에 포함 되지 않습니다.

자리 표시자 콜론으로 구분 하는 두 부분으로 구성 됩니다 (":") 고 중괄호 ("{}"), 형태로 {A:Bxx}합니다. 콜론 앞 값 (A 예:에서) 필드 값의 인덱스 0부터 시작 하는 매개 변수 목록을 지정 합니다.

참고

이 매개 변수는 서식 구문의 일부입니다. 각 셀에서 필드를 하나만 값 이기 때문에이 값을 0으로 설정할 수만 있습니다.

콜론 및 콜론 뒤의 값은 선택적입니다. 콜론 문자 (B 예:에서) 값을 표시 하는 형식을 지정 합니다. 다음 표에서 일반 형식을 나열합니다.

형식 문자 Description
C 통화 형식으로 숫자 값을 표시합니다.
D 10 진수 형식의 숫자 값을 표시합니다.
E 과학적 (지 수)의 숫자 값을 표시합니다.
F 고정 형식으로 숫자 값을 표시합니다.
G 숫자 값을 표시 일반적 서식을 지정합니다.
N 숫자 형식의 숫자 값을 표시합니다.
X 16 진수 형식의 숫자 값을 표시합니다.

참고

형식 문자를 제외 하 고 대/소문자 없는 X, 16 진수 문자를 지정 하는 경우를 표시 합니다.

형식 문자 (예:에서 xx) 다음 값은 유효 자릿수 또는 소수 자릿수의 수를 지정 합니다. 예를 들어 형식 문자열 "{0:F2}" 소수 자릿수를 사용 하 여 고정 소수점 숫자를 표시 합니다.

서식 지정에 대 한 자세한 내용은 참조 하세요. 형식합니다.

적용 대상

추가 정보