ImageField Classe

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.dll

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.

Rappresenta un campo visualizzato come immagine in un controllo associato a dati.

public ref class ImageField : System::Web::UI::WebControls::DataControlField

public class ImageField : System.Web.UI.WebControls.DataControlField

type ImageField = class
    inherit DataControlField

Public Class ImageField
Inherits DataControlField

Ereditarietà: Object

DataControlField
ImageField

Esempio

Nell'esempio seguente viene illustrato come usare un ImageField oggetto in un GridView controllo per visualizzare un'immagine.


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

Commenti

La ImageField classe viene usata dai controlli associati a dati (ad esempio GridView e DetailsView) per visualizzare un'immagine per ogni record visualizzato. L'oggetto ImageField viene visualizzato in modo diverso a seconda del controllo associato a dati in cui viene utilizzato. Ad esempio, il GridView controllo visualizza un ImageField oggetto come colonna, mentre il DetailsView controllo lo visualizza come riga.

Per visualizzare le immagini, è necessario associare un ImageField oggetto a un campo da un'origine dati contenente l'URL di un'immagine. Questa operazione viene eseguita impostando la DataImageUrlField proprietà . Il valore URL può essere formattato usando la DataImageUrlFormatString proprietà . A ogni immagine può essere associato anche testo alternativo. Questo testo viene visualizzato quando un'immagine non può essere caricata o non è disponibile. I browser che supportano la funzionalità Descrizioni comando visualizzano anche questo testo come descrizione comando. È possibile specificare il testo alternativo per un'immagine visualizzata usando uno dei metodi seguenti:

Usare la AlternateText proprietà per specificare testo alternativo applicabile a tutte le immagini.
Utilizzare la DataAlternateTextField proprietà per associare un campo da un'origine dati alla AlternateText proprietà di ogni immagine. In questo modo è possibile avere testo alternativo diverso per ogni immagine visualizzata. Quando si associano dati, è possibile formattare facoltativamente il testo alternativo usando la DataAlternateTextFormatString proprietà .

Quando il valore URL per un'immagine è null, non è possibile visualizzare un'immagine. È possibile visualizzare un'immagine alternativa per null i valori dei campi impostando la NullImageUrl proprietà . Anziché un'immagine alternativa, è possibile visualizzare testo alternativo impostando la NullDisplayText proprietà .

Per impostazione predefinita, tutti i campi dichiarati vengono visualizzati in un controllo associato a dati. È possibile nascondere un ImageField oggetto in un controllo associato a dati impostando la Visible proprietà su false.

È possibile personalizzare le sezioni intestazione e piè di pagina di un ImageField oggetto . Per visualizzare una didascalia nella sezione intestazione o piè di pagina, impostare rispettivamente le HeaderText proprietà o FooterText . Per visualizzare un'immagine nella sezione intestazione anziché testo, impostare la HeaderImageUrl proprietà . La sezione intestazione può essere nascosta nell'oggetto ImageField impostando la ShowHeader proprietà su false.

Annotazioni

Alcuni controlli associati a dati,ad esempio il GridView controllo, possono mostrare o nascondere solo l'intera sezione di intestazione del controllo. Questi controlli associati a dati non supportano la ShowHeader proprietà per un singolo campo associato a dati. Per visualizzare o nascondere l'intera sezione dell'intestazione di un controllo associato a dati, utilizzare la proprietà del ShowHeader controllo , se disponibile.

È anche possibile personalizzare l'aspetto dell'oggetto ImageField (colore del carattere, colore di sfondo e così via) impostando le proprietà di stile per le diverse parti del campo. Nella tabella seguente sono elencate le diverse proprietà di stile.

Proprietà Style	Descrizione
ControlStyle	Impostazioni di stile per i controlli server Web figlio dell'oggetto ImageField .
FooterStyle	Impostazioni di stile per la sezione piè di pagina dell'oggetto ImageField .
HeaderStyle	Impostazioni di stile per la sezione intestazione dell'oggetto ImageField .
ItemStyle	Impostazioni di stile per gli elementi di dati nell'oggetto ImageField .

Costruttori

Nome	Descrizione
ImageField()	Inizializza una nuova istanza della classe ImageField.

Campi

Nome	Descrizione
ThisExpression	Rappresenta l'espressione "this".

Proprietà

Nome	Descrizione
AccessibleHeaderText	Ottiene o imposta il testo di cui viene eseguito il rendering come valore della `AbbreviatedText` proprietà in alcuni controlli. (Ereditato da DataControlField)
AlternateText	Ottiene o imposta il testo alternativo visualizzato per un'immagine nell'oggetto ImageField .
Control	Ottiene un riferimento al controllo dati a cui è associato l'oggetto DataControlField . (Ereditato da DataControlField)
ControlStyle	Ottiene lo stile di tutti i controlli server Web contenuti nell'oggetto DataControlField . (Ereditato da DataControlField)
ConvertEmptyStringToNull	Ottiene o imposta un valore che indica se i valori stringa vuota ("") vengono convertiti in `null` quando i valori dei campi vengono restituiti dall'origine dati.
DataAlternateTextField	Ottiene o imposta il nome del campo dall'origine dati che contiene i valori da associare alla AlternateText proprietà di ogni immagine in un ImageField oggetto .
DataAlternateTextFormatString	Ottiene o imposta la stringa che specifica il formato in cui viene eseguito il rendering del testo alternativo per ogni immagine in un ImageField oggetto .
DataImageUrlField	Ottiene o imposta il nome del campo dall'origine dati che contiene i valori da associare alla ImageUrl proprietà di ogni immagine in un ImageField oggetto .
DataImageUrlFormatString	Ottiene o imposta la stringa che specifica il formato in cui viene eseguito il rendering dell'URL per ogni immagine in un ImageField oggetto .
DesignMode	Ottiene un valore che indica se un campo di controllo dati è attualmente visualizzato in un ambiente in fase di progettazione. (Ereditato da DataControlField)
FooterStyle	Ottiene o imposta lo stile del piè di pagina del campo del controllo dati. (Ereditato da DataControlField)
FooterText	Ottiene o imposta il testo visualizzato nell'elemento piè di pagina di un campo del controllo dati. (Ereditato da DataControlField)
HeaderImageUrl	Ottiene o imposta l'URL di un'immagine visualizzata nell'elemento di intestazione di un campo di controllo dati. (Ereditato da DataControlField)
HeaderStyle	Ottiene o imposta lo stile dell'intestazione del campo del controllo dati. (Ereditato da DataControlField)
HeaderText	Ottiene o imposta il testo visualizzato nell'elemento di intestazione di un campo del controllo dati. (Ereditato da DataControlField)
InsertVisible	Ottiene un valore che indica se l'oggetto è visibile quando il DataControlField controllo associato a dati padre è in modalità di inserimento. (Ereditato da DataControlField)
IsTrackingViewState	Ottiene un valore che indica se l'oggetto DataControlField sta salvando le modifiche apportate allo stato di visualizzazione. (Ereditato da DataControlField)
ItemStyle	Ottiene lo stile di qualsiasi contenuto basato su testo visualizzato da un campo di controllo dati. (Ereditato da DataControlField)
NullDisplayText	Ottiene o imposta il testo da visualizzare in un ImageField oggetto quando il valore del campo specificato dalla DataImageUrlField proprietà è `null`.
NullImageUrl	Ottiene o imposta l'URL di un'immagine alternativa visualizzata in un ImageField oggetto quando il valore del campo specificato dalla DataImageUrlField proprietà è `null`.
ReadOnly	Ottiene o imposta un valore che indica se i valori del campo specificato dalla DataImageUrlField proprietà possono essere modificati in modalità di modifica.
ShowHeader	Ottiene o imposta un valore che indica se viene eseguito il rendering dell'elemento di intestazione di un campo del controllo dati. (Ereditato da DataControlField)
SortExpression	Ottiene o imposta un'espressione di ordinamento utilizzata da un controllo origine dati per ordinare i dati. (Ereditato da DataControlField)
ValidateRequestMode	Ottiene o imposta un valore che specifica se il controllo convalida l'input client. (Ereditato da DataControlField)
ViewState	Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un DataControlField oggetto in più richieste per la stessa pagina. (Ereditato da DataControlField)
Visible	Ottiene o imposta un valore che indica se viene eseguito il rendering di un campo di controllo dati. (Ereditato da DataControlField)

Metodi

Nome	Descrizione
CloneField()	Crea una copia duplicata dell'oggetto derivato da corrente DataControlField. (Ereditato da DataControlField)
CopyProperties(DataControlField)	Copia le proprietà dell'oggetto corrente ImageField nell'oggetto specificato.
CreateField()	Restituisce una nuova istanza della ImageField classe .
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Riempie l'oggetto specificato IOrderedDictionary con i valori dell'oggetto specificato DataControlFieldCell .
FormatImageUrlValue(Object)	Applica il formato specificato dalla DataImageUrlFormatString proprietà a un valore di campo.
GetDesignTimeValue()	Recupera il valore utilizzato per il valore di un campo durante il rendering dell'oggetto ImageField in una finestra di progettazione.
GetFormattedAlternateText(Control)	Applica il formato specificato dalla DataAlternateTextFormatString proprietà al valore di testo alternativo contenuto nell'oggetto specificato Control .
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
GetValue(Control, String, PropertyDescriptor)	Recupera il valore del campo specificato dal controllo specificato.
Initialize(Boolean, Control)	Inizializza l'oggetto ImageField.
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Inizializza l'oggetto specificato DataControlFieldCell con il tipo di cella, lo stato della riga e l'indice di riga specificati.
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Inizializza l'oggetto specificato DataControlFieldCell con lo stato di riga specificato.
LoadViewState(Object)	Ripristina lo stato di visualizzazione salvata in precedenza della vista origine dati. (Ereditato da DataControlField)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
OnDataBindField(Object, EventArgs)	Associa il valore di un campo all'oggetto ImageField .
OnFieldChanged()	Genera l'evento `FieldChanged`. (Ereditato da DataControlField)
SaveViewState()	Salva le modifiche apportate allo stato di DataControlField visualizzazione dal momento in cui la pagina è stata pubblicata nel server. (Ereditato da DataControlField)
ToString()	Restituisce una stringa che rappresenta questo DataControlField oggetto. (Ereditato da DataControlField)
TrackViewState()	Fa in modo che l'oggetto DataControlField possa tenere traccia delle modifiche apportate allo stato di visualizzazione in modo che possano essere archiviate nella proprietà del ViewState controllo e mantenute tra le richieste per la stessa pagina. (Ereditato da DataControlField)
ValidateSupportsCallback()	Determina se i controlli contenuti in un ImageField oggetto supportano i callback.

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Ottiene o imposta lo schema associato a questo DataControlField oggetto. (Ereditato da DataControlField)
IStateManager.IsTrackingViewState	Ottiene un valore che indica se l'oggetto DataControlField sta salvando le modifiche apportate allo stato di visualizzazione. (Ereditato da DataControlField)
IStateManager.LoadViewState(Object)	Ripristina lo stato di visualizzazione salvato in precedenza del campo del controllo dati. (Ereditato da DataControlField)
IStateManager.SaveViewState()	Salva le modifiche apportate allo stato di DataControlField visualizzazione dal momento in cui la pagina è stata pubblicata nel server. (Ereditato da DataControlField)
IStateManager.TrackViewState()	Fa in modo che l'oggetto DataControlField possa tenere traccia delle modifiche apportate allo stato di visualizzazione in modo che possano essere archiviate nella proprietà del ViewState controllo e mantenute tra le richieste per la stessa pagina. (Ereditato da DataControlField)

Si applica a

Vedi anche

Commenti e suggerimenti

Questa pagina è stata utile?