TreeNodeBinding.ImageUrlField Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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.
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, setPublic Property ImageUrlField As StringValore della proprietà
Nome del campo da associare alla proprietà ImageUrl di un oggetto TreeNode a cui è applicato l'oggetto TreeNodeBinding. Il valore predefinito è una stringa vuota (""), che indica che la proprietà ImageUrlField non è impostata.
- Attributi
Esempio
In questa sezione sono riportati due esempi di codice. Il primo esempio di codice illustra come usare la proprietà per specificare l'attributo ImageUrlField di un elemento XML da associare alla ImageUrl proprietà di un TreeNode oggetto a cui viene applicato l'oggetto TreeNodeBinding . Il secondo esempio di codice fornisce dati XML di esempio per il primo esempio di codice.
Nell'esempio di codice seguente viene illustrato come usare la ImageUrlField proprietà per specificare l'attributo di un elemento XML da associare alla ImageUrl proprietà di un TreeNode oggetto a cui viene applicato l'oggetto TreeNodeBinding . 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.
<%@ 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 seguente vengono forniti dati XML di esempio per l'esempio precedente.
<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 per associare alla ImageUrl proprietà di un TreeNode oggetto. Questa relazione di associazione influisce su tutti gli TreeNode oggetti a cui viene applicato l'oggetto TreeNodeBinding . 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.
Nota
È possibile eseguire l'override dell'immagine per un singolo nodo impostandone direttamente la ImageUrl proprietà.
Anziché usare questa proprietà per associare la proprietà di un oggetto a un TreeNode campo, è possibile impostare la ImageUrl proprietà su un valore fisso impostando la ImageUrl ImageUrl proprietà.
Nota
Se l'origine dati contiene più campi, è necessario impostare prima la proprietà o DataMember o entrambe le proprietà per eseguire l'associazione Depth al campo appropriato.
Quando si visualizza un'immagine accanto a un nodo con la ImageUrlField proprietà, è anche consigliabile impostare la ImageToolTipField proprietà. Il testo della descrizione comando specificato fornisce dispositivi Assistive Technology con una descrizione dell'immagine che può essere usata per rendere il controllo più accessibile.
Il valore di questa proprietà viene archiviato nello stato di visualizzazione.