Freigeben über

ImageField.AlternateText Eigenschaft

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Dient zum Abrufen oder Festlegen des alternativen Texts, der für ein Bild im ImageField Objekt angezeigt wird.

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

Eigenschaftswert

String

Der alternative Text für ein Bild, das ImageField im Objekt angezeigt wird. Der Standardwert ist eine leere Zeichenfolge (""), die angibt, dass diese Eigenschaft nicht festgelegt ist.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie AlternateText die Eigenschaft verwendet wird, um den alternativen Text für alle Bilder anzugeben, die in einem ImageField Objekt angezeigt werden.


<%@ 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>

Hinweise

Verwenden Sie die AlternateText Eigenschaft, um den alternativen Text für die bilder anzugeben, die in einem ImageField Objekt angezeigt werden. Der alternative Text wird angezeigt, wenn ein Bild nicht geladen oder nicht verfügbar ist. Browser, die das QuickInfo-Feature unterstützen, zeigen diesen Text auch als QuickInfo an.

Hinweis

Wenn diese Eigenschaft festgelegt ist, verwenden alle bilder, die in einem ImageField Objekt angezeigt werden, denselben Alternativtext. Alternativ können Sie den alternativen Text an ein Feld in einer Datenquelle binden, indem Sie die DataAlternateTextField Eigenschaft anstelle dieser Eigenschaft festlegen. Auf diese Weise können Sie für jedes angezeigte Bild unterschiedliche Alternativtexte verwenden. Wenn sowohl die Eigenschaften DataAlternateTextField als auch die AlternateText Eigenschaften festgelegt sind, hat die DataAlternateTextField Eigenschaft Vorrang.

Der Wert dieser Eigenschaft kann automatisch mithilfe eines Designertools in einer Ressourcendatei gespeichert werden. Weitere Informationen finden Sie unter LocalizableAttribute"Globalisierung und Lokalisierung".

Gilt für:

Weitere Informationen