TreeNodeBinding.ImageUrlField Proprietà

Definizione

Ottiene o imposta il nome del campo dall'origine dati per l'associazione alla proprietà ImageUrl di un oggetto TreeNode a cui è applicato l'oggetto TreeNodeBinding.Gets or sets the name of the field from the data source to bind to the ImageUrl property of a TreeNode object to which the TreeNodeBinding object is applied.

public:
 property System::String ^ ImageUrlField { 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 ImageUrlField { get; set; }
[System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string ImageUrlField { get; set; }
[<System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.ImageUrlField : 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.ImageUrlField : string with get, set
Public Property ImageUrlField As String

Valore della proprietà

String

Nome del campo da associare alla proprietà ImageUrl di un oggetto TreeNode a cui è applicato l'oggetto TreeNodeBinding.The name of the field to bind to the ImageUrl property of a TreeNode object to which the TreeNodeBinding object is applied. Il valore predefinito è una stringa vuota (""), che indica che la proprietà ImageUrlField non è impostata.The default is an empty string (""), which indicates that the ImageUrlField property is not set.

Attributi

Esempio

In questa sezione sono riportati due esempi di codice.This section contains two code examples. Nel primo esempio di codice viene illustrato come utilizzare la ImageUrlField proprietà per specificare l'attributo di un elemento XML da associare alla ImageUrl proprietà di un TreeNode oggetto a cui TreeNodeBinding viene applicato l'oggetto.The first code example demonstrates how to use the ImageUrlField property to specify which attribute of an XML element to bind to the ImageUrl property of a TreeNode object to which the TreeNodeBinding object is applied. Il secondo esempio di codice fornisce dati XML di esempio per il primo esempio di codice.The second code example provides sample XML data for the first code example.

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare la ImageUrlField proprietà per specificare l'attributo di un elemento XML da associare alla ImageUrl proprietà di un TreeNode oggetto a cui TreeNodeBinding viene applicato l'oggetto.The following code example demonstrates how to use the ImageUrlField property to specify which attribute of an XML element to bind to the ImageUrl property of a TreeNode object to which the TreeNodeBinding object is applied. Per il corretto funzionamento di questo esempio, è necessario copiare i dati XML di esempio, forniti dopo questo esempio di codice, in un file denominato Booklist.xml.For this example to work correctly, you must copy the sample XML data, provided after this code example, to a file named Booklist.xml.


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

Nell'esempio di codice riportato di seguito vengono forniti dati XML di esempio per l'esempio precedente.The following code example provides sample XML data for the preceding example.

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

Commenti

Quando il TreeView controllo è associato a un'origine dati, utilizzare la ImageUrlField proprietà per specificare il nome del campo da associare alla ImageUrl proprietà di un TreeNode oggetto.When the TreeView control is bound to a data source, use the ImageUrlField property to specify the name of the field to bind to the ImageUrl property of a TreeNode object. Questa relazione TreeNode di associazione ha effetto su tutti gli oggetti a cui TreeNodeBinding è applicato l'oggetto.This binding relationship affects all TreeNode objects to which the TreeNodeBinding object is applied. L'immagine viene visualizzata accanto a un nodo e può essere in qualsiasi formato di file (. jpg,. gif,. bmp e così via), purché il browser client supporti il formato.The image is displayed next to a node and can be in any file format (.jpg, .gif, .bmp, and so on), as long as the client browser supports the format.

Nota

È possibile eseguire l'override dell'immagine per un singolo nodo impostando ImageUrl direttamente la proprietà.You can override the image for an individual node by setting its ImageUrl property directly.

Anziché utilizzare questa proprietà per associare la ImageUrl proprietà di un TreeNode oggetto a un campo, è possibile impostare la proprietà ImageUrl su un valore fisso impostando la ImageUrl Proprietà.Instead of using this property to bind the ImageUrl property of a TreeNode object to a field, you can set the ImageUrl property to a fixed value by setting the ImageUrl property.

Nota

Se l'origine dati contiene più campi, è innanzitutto necessario impostare la Depth proprietà o oppure DataMember entrambe le proprietà per eseguire l'associazione al campo appropriato.If the data source contains multiple fields, you must first set the Depth or DataMember property, or both properties in order to bind to the appropriate field.

Quando si visualizza un'immagine accanto a un nodo con la ImageUrlField proprietà, è necessario considerare anche l'impostazione della ImageToolTipField Proprietà.When displaying an image next to a node with the ImageUrlField property, you should also consider setting the ImageToolTipField property. Il testo della descrizione comando specificato fornisce ai dispositivi di Assistive Technology una descrizione dell'immagine che può essere utilizzata per rendere il controllo più accessibile.The ToolTip text that you specify provides Assistive Technology devices with a description of the image that can be used to make the control more accessible.

Il valore di questa proprietà viene archiviato nello stato di visualizzazione.The value of this property is stored in view state.

Si applica a

Vedi anche