TreeNodeBinding.ImageToolTipField Eigenschaft

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Dient zum Abrufen oder Festlegen des Namens des Felds aus der Datenquelle, das an die ImageToolTip Eigenschaft eines TreeNode Objekts gebunden werden soll, auf das das TreeNodeBinding Objekt angewendet wird.

public:
 property System::String ^ ImageToolTipField { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string ImageToolTipField { get; set; }

[System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string ImageToolTipField { get; set; }

[<System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.ImageToolTipField : string with get, set

[<System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.ImageToolTipField : string with get, set

Public Property ImageToolTipField As String

Eigenschaftswert

String

Der Name des Felds, das an die ImageToolTip Eigenschaft eines TreeNode Objekts gebunden werden soll, auf das das TreeNodeBinding Objekt angewendet wird. Der Standardwert ist eine leere Zeichenfolge (""), die angibt, dass die ImageToolTipField Eigenschaft nicht festgelegt ist.

Attribute: TypeConverterAttribute

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele. Im ersten Codebeispiel wird veranschaulicht, wie die ImageToolTipField Eigenschaft verwendet wird, um anzugeben, welches Attribut eines XML-Elements an die ImageToolTip Eigenschaft eines TreeNode Objekts gebunden werden soll, auf das das TreeNodeBinding Objekt angewendet wird. Im zweiten Codebeispiel werden XML-Beispieldaten für das erste Codebeispiel bereitgestellt.

Im folgenden Beispiel wird veranschaulicht, wie die ImageToolTipField Eigenschaft verwendet wird, um anzugeben, welches Attribut eines XML-Elements an die ImageToolTip Eigenschaft eines TreeNode Objekts gebunden werden soll, auf das das TreeNodeBinding Objekt angewendet wird. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die XML-Beispieldaten, die nach diesem Codebeispiel bereitgestellt werden, in eine Datei mit dem Namen Booklist.xmlkopieren.


<%@ 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>TreeViewBinding Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeViewBinding Example</h3>
    
      <!-- Set the TextField, ImageUrlField, NavigateUrlField, -->
      <!-- ValueField, and ToolTipField properties of a    -->
      <!-- TreeNodeBinding object declaratively.         -->
      <asp:TreeView id="BookTreeView" 
        DataSourceID="BookXmlDataSource"
        Target="_blank" 
        runat="server">
          
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Books" 
            Depth="0" 
            TextField="Text"/>
          <asp:TreeNodeBinding DataMember="Book" 
            Depth="1" 
            TextField="Text" 
            ImageUrlField="Image"
            ImageToolTipField="ImageToolTip" 
            NavigateUrlField="Nav" 
            ValueField="Value" 
            ToolTipField="Tip"/>
          <asp:TreeNodeBinding DataMember="Description" 
            Depth="2" 
            TextField="Text"/>
          <asp:TreeNodeBinding DataMember="Price" 
            Depth="2" 
            TextField="Value"/>
        </DataBindings>
         
      </asp:TreeView>
      
      <asp:XmlDataSource id="BookXmlDataSource"  
        DataFile="Booklist.xml"
        runat="server">
      </asp:XmlDataSource>
    
    </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>TreeViewBinding Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeViewBinding Example</h3>
    
      <!-- Set the TextField, ImageUrlField, NavigateUrlField, -->
      <!-- ValueField, and ToolTipField properties of a    -->
      <!-- TreeNodeBinding object declaratively.         -->
      <asp:TreeView id="BookTreeView" 
        DataSourceID="BookXmlDataSource"
        Target="_blank" 
        runat="server">
          
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Books" 
            Depth="0" 
            TextField="Text"/>
          <asp:TreeNodeBinding DataMember="Book" 
            Depth="1" 
            TextField="Text" 
            ImageUrlField="Image"
            ImageToolTipField="ImageToolTip" 
            NavigateUrlField="Nav" 
            ValueField="Value" 
            ToolTipField="Tip"/>
          <asp:TreeNodeBinding DataMember="Description" 
            Depth="2" 
            TextField="Text"/>
          <asp:TreeNodeBinding DataMember="Price" 
            Depth="2" 
            TextField="Value"/>
        </DataBindings>
         
      </asp:TreeView>
      
      <asp:XmlDataSource id="BookXmlDataSource"  
        DataFile="Booklist.xml"
        runat="server">
      </asp:XmlDataSource>
    
    </form>
  </body>
</html>

Im folgenden Codebeispiel werden XML-Beispieldaten für das vorangehende Codebeispiel bereitgestellt.

<Books Text="Books List">
    <Book Text="Book Title One"
        Value="1"
        Image="Bookimage1.jpg"
        ImageToolTip="Book 1 Photo"
        Nav="http://www.microsoft.com"
        Tip="Book Title 1">
        <Description Text="Book Description">
        </Description>
        <Price Value="$1.99">
        </Price>
        <Author Text="Author Name"
            Value="LastName"
            Image="Authorimage1.jpg"
            Nav="http://www.microsoft.com"
            Tip="Author Name">
        </Author>
    </Book>
    <Book Text="Book Title Two"
        Value="2"
        Image="Bookimage2.jpg"
        ImageToolTip="Book 2 Photo"
        Nav="http://www.microsoft.com"
        Tip="Click Me">
        <Description Text="Book Description">
        </Description>
        <Price Value="$2.99">
        </Price>
        <Author Text="Author Name"
            Value="LastName"
            Image="Authorimage2.jpg"
            Nav="http://www.microsoft.com"
            Tip="Author Name">
        </Author>
    </Book>
</Books>

Hinweise

Wenn das TreeView Steuerelement an eine Datenquelle gebunden ist, verwenden Sie die ImageToolTipField Eigenschaft, um den Feldnamen anzugeben, der an die ImageToolTip Eigenschaft eines TreeNode Objekts gebunden werden soll. Der von Ihnen angegebene Text stellt Hilfstechnologiegeräte mit einer Beschreibung des Bilds bereit, das verwendet werden kann, um das Steuerelement barrierefreier zu gestalten.

Diese Bindungsbeziehung wirkt sich auf alle TreeNode Objekte aus, auf die das TreeNodeBinding Objekt angewendet wird. Wenn neben einem Knoten ein Bild angezeigt wird, wird der QuickInfo-Text angezeigt, wenn der Mauszeiger über dem Bild positioniert wird.

Hinweis

Sie können die ImageToolTipField Eigenschaft selektiv überschreiben, indem Sie die ImageToolTip Eigenschaft jedes Knotens direkt festlegen.

Anstatt die ImageToolTipField Eigenschaft zum Binden der ImageToolTip Eigenschaft TreeNode an ein Feld zu verwenden, können Sie die ImageToolTip Eigenschaft auf einen festen Wert festlegen, indem Sie die ImageToolTip Eigenschaft festlegen.

Hinweis

Wenn die Datenquelle mehrere Felder enthält, müssen Sie zuerst die Depth Eigenschaften oder DataMember eigenschaften festlegen, um eine Bindung an das entsprechende Feld zu erstellen.

Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?