Esporta (0) Stampa
Espandi tutto
Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.
Traduzione
Originale

Classe ImageField

Rappresenta un campo visualizzato come immagine in un controllo con associazione a dati.

Spazio dei nomi:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

public class ImageField : DataControlField

Il tipo ImageField espone i seguenti membri.

  NomeDescrizione
Metodo pubblicoImageFieldInizializza una nuova istanza della classe ImageField.
In alto

  NomeDescrizione
Proprietà pubblicaAccessibleHeaderTextOttiene o imposta il testo che viene sottoposto a rendering come valore della proprietà AbbreviatedText in alcuni controlli. (Ereditato da DataControlField)
Proprietà pubblicaAlternateTextOttiene o imposta il teso alternativo visualizzato per un'immagine nell'oggetto ImageField.
Proprietà protetta.ControlOttiene un riferimento al controllo dati a cui l'oggetto DataControlField è associato. (Ereditato da DataControlField)
Proprietà pubblicaControlStyleOttiene lo stile di tutti i controlli server Web contenuti nell'oggetto DataControlField. (Ereditato da DataControlField)
Proprietà pubblicaConvertEmptyStringToNullOttiene o imposta un valore che indica se i valori stringa vuota ("") devono essere convertiti in null quando i valori dei campi vengono restituiti dall'origine dati.
Proprietà pubblicaDataAlternateTextFieldOttiene o imposta il nome del campo dall'origine dati contenente i valori da associare alla proprietà AlternateText di ogni immagine in un oggetto ImageField.
Proprietà pubblicaDataAlternateTextFormatStringOttiene o imposta la stringa che specifica il formato per il rendering del testo alternativo di ciascuna immagine di un oggetto ImageField.
Proprietà pubblicaDataImageUrlFieldOttiene o imposta il nome del campo dall'origine dati contenente i valori da associare alla proprietà ImageUrl di ogni immagine in un oggetto ImageField.
Proprietà pubblicaDataImageUrlFormatStringOttiene o imposta la stringa che specifica il formato per il rendering dell'URL di ciascuna immagine di un oggetto ImageField.
Proprietà protetta.DesignModeOttiene un valore che indica se un campo di controllo dati è attualmente visualizzato in un ambiente di progettazione. (Ereditato da DataControlField)
Proprietà pubblicaFooterStyleOttiene o imposta lo stile del piè di pagina del campo di controllo dati. (Ereditato da DataControlField)
Proprietà pubblicaFooterTextOttiene o imposta il testo visualizzato nell'elemento del piè di pagina del campo di controllo dati. (Ereditato da DataControlField)
Proprietà pubblicaHeaderImageUrlOttiene o imposta l'URL di un'immagine che viene visualizzata nell'elemento di intestazione di un campo di controlli dati. (Ereditato da DataControlField)
Proprietà pubblicaHeaderStyleOttiene o imposta lo stile dell'intestazione del campo di controllo dati. (Ereditato da DataControlField)
Proprietà pubblicaHeaderTextOttiene o imposta il testo visualizzato nell'elemento dell'intestazione di un campo di controllo dati. (Ereditato da DataControlField)
Proprietà pubblicaInsertVisibleOttiene un valore che indica se l'oggetto DataControlField è visibile quando il controllo con associazione a dati padre si trova in modalità di inserimento. (Ereditato da DataControlField)
Proprietà protetta.IsTrackingViewStateOttiene un valore che indica se l'oggetto DataControlField salva le modifiche apportate al relativo stato di visualizzazione. (Ereditato da DataControlField)
Proprietà pubblicaItemStyleOttiene lo stile di tutti i contenuti basati sul testo visualizzati da un campo di controllo dati. (Ereditato da DataControlField)
Proprietà pubblicaNullDisplayTextOttiene o imposta il testo da visualizzare in un oggetto ImageField quando il valore del campo specificato dalla proprietà DataImageUrlField è null.
Proprietà pubblicaNullImageUrlOttiene o imposta l'URL di un'immagine alternativa visualizzata in un oggetto ImageField quando il valore del campo specificato dalla proprietà DataImageUrlField è null.
Proprietà pubblicaReadOnlyOttiene o imposta un valore che indica se il valore del campo specificato dalla proprietà DataImageUrlField può essere modificato in modalità di modifica.
Proprietà pubblicaShowHeaderOttiene o imposta un valore che indica se viene eseguito il rendering dell'elemento di intestazione di un campo di controllo dati. (Ereditato da DataControlField)
Proprietà pubblicaSortExpressionOttiene o imposta l'espressione di ordinamento che viene utilizzata da un controllo origine dati per ordinare i dati. (Ereditato da DataControlField)
Proprietà protetta.ValidateRequestModeOttiene o imposta un valore che specifica se il controllo convalida l'input del client. (Ereditato da DataControlField)
Proprietà protetta.ViewStateOttiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un oggetto DataControlField tra più richieste per la stessa pagina. (Ereditato da DataControlField)
Proprietà pubblicaVisibleOttiene o imposta un valore che indica se viene eseguito il rendering di un campo di controllo dati. (Ereditato da DataControlField)
In alto

  NomeDescrizione
Metodo protettoCloneFieldInfrastruttura. Crea una copia duplicata dell'oggetto corrente derivato da DataControlField. (Ereditato da DataControlField)
Metodo protettoCopyPropertiesCopia le proprietà dell'oggetto corrente ImageField nell'oggetto specificato. (Esegue l'override di DataControlField.CopyProperties(DataControlField)).
Metodo protettoCreateFieldRestituisce una nuova istanza della classe ImageField. (Esegue l'override di DataControlField.CreateField()).
Metodo pubblicoEquals(Object) Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Metodo pubblicoExtractValuesFromCellInserisce nell'oggetto IOrderedDictionary specificato i valori dell'oggetto DataControlFieldCell specificato. (Esegue l'override di DataControlField.ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)).
Metodo protettoFinalize Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che l'oggetto stesso venga reclamato dalla procedura di Garbage Collection. (Ereditato da Object)
Metodo protettoFormatImageUrlValueApplica il formato specificato dalla proprietà DataImageUrlFormatString a un valore di campo.
Metodo protettoGetDesignTimeValueRecupera il valore utilizzato per il valore di un campo quando si esegue il rendering dell'oggetto ImageField in una finestra di progettazione.
Metodo protettoGetFormattedAlternateTextApplica il formato specificato dalla proprietà DataAlternateTextFormatString al valore del testo alternativo contenuto nell'oggetto Control specificato.
Metodo pubblicoGetHashCode Funge da funzione hash per un particolare tipo. (Ereditato da Object)
Metodo pubblicoGetType Ottiene il Type dell'istanza corrente. (Ereditato da Object)
Metodo protettoGetValueRecupera il valore del campo specificato dal controllo specificato.
Metodo pubblicoInitializeInizializza l'oggetto ImageField. (Esegue l'override di DataControlField.Initialize(Boolean, Control)).
Metodo pubblicoInitializeCellInizializza l'oggetto DataControlFieldCell specificato con il tipo di cella, lo stato di riga e l'indice di riga specificato. (Esegue l'override di DataControlField.InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)).
Metodo protettoInitializeDataCellInizializza l'oggetto DataControlFieldCell specificato con lo stato della riga specificato.
Metodo protettoLoadViewStateRipristina lo stato di visualizzazione precedentemente salvato della visualizzazione origine dati. (Ereditato da DataControlField)
Metodo protettoMemberwiseClone Crea una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
Metodo protettoOnDataBindFieldAssocia il valore di un campo all'oggetto ImageField.
Metodo protettoOnFieldChangedGenera l'evento FieldChanged. (Ereditato da DataControlField)
Metodo protettoSaveViewStateSalva le modifiche apportate allo stato di visualizzazione DataControlField dal momento in cui è stato eseguito il postback della pagina al server. (Ereditato da DataControlField)
Metodo pubblicoToStringRestituisce una stringa che rappresenta questo oggetto DataControlField. (Ereditato da DataControlField)
Metodo protettoTrackViewStateMediante questo metodo l'oggetto DataControlField tiene traccia delle modifiche apportate al relativo stato di visualizzazione in modo che possano essere memorizzate nella proprietà ViewState del controllo e mantenute nelle richieste della stessa pagina. (Ereditato da DataControlField)
Metodo pubblicoValidateSupportsCallbackDetermina se i controlli contenuti in un oggetto ImageField supportano i callback. (Esegue l'override di DataControlField.ValidateSupportsCallback()).
In alto

  NomeDescrizione
Campo pubblicoMembro staticoThisExpressionRappresenta l'espressione "this".
In alto

  NomeDescrizione
Implementazione esplicita dell'interfacciaProprietà privataIDataSourceViewSchemaAccessor.DataSourceViewSchemaInfrastruttura. Ottiene o imposta lo schema associato con l'oggetto DataControlField. (Ereditato da DataControlField)
Implementazione esplicita dell'interfacciaProprietà privataIStateManager.IsTrackingViewStateInfrastruttura. Ottiene un valore che indica se l'oggetto DataControlField salva le modifiche apportate al relativo stato di visualizzazione. (Ereditato da DataControlField)
Implementazione esplicita dell'interfacciaMetodo privatoIStateManager.LoadViewStateInfrastruttura. Ripristina lo stato di visualizzazione del campo del controllo dati salvato in precedenza. (Ereditato da DataControlField)
Implementazione esplicita dell'interfacciaMetodo privatoIStateManager.SaveViewStateInfrastruttura. Salva le modifiche apportate allo stato di visualizzazione DataControlField dal momento in cui è stato eseguito il postback della pagina al server. (Ereditato da DataControlField)
Implementazione esplicita dell'interfacciaMetodo privatoIStateManager.TrackViewStateInfrastruttura. Mediante questo metodo l'oggetto DataControlField tiene traccia delle modifiche apportate al relativo stato di visualizzazione in modo che possano essere memorizzate nella proprietà ViewState del controllo e mantenute nelle richieste della stessa pagina. (Ereditato da DataControlField)
In alto

La classe ImageField è utilizzata da controlli con associazione a dati (ad esempio, GridView e DetailsView) per visualizzare un'immagine per ciascun record visualizzato. L'oggetto ImageField viene visualizzato in modo diverso a seconda del controllo con associazione a dati in cui viene utilizzato. Il controllo GridView, ad esempio, consente di visualizzare un oggetto ImageField come una colonna, mentre il controllo DetailsView lo visualizza come una riga.

Per visualizzare le immagini, è necessario associare un oggetto ImageField al campo di un'origine dati contenente l'URL di un'immagine. Questa operazione viene eseguita impostando la proprietà DataImageUrlField. È possibile formattare il valore URL utilizzando la proprietà DataImageUrlFormatString. A ciascuna immagine può inoltre essere associato del testo alternativo. Tale testo viene visualizzato quando un'immagine non può essere caricata o non è disponibile. Nei browser che supportano la funzione di descrizione comandi, il testo viene inoltre visualizzato come descrizione. È possibile specificare il testo alternativo di un'immagine visualizzata utilizzando uno dei seguenti metodi:

  • Utilizzare la proprietà AlternateText per specificare il testo alternativo per tutte le immagini.

  • Utilizzare la proprietà DataAlternateTextField per associare il campo di un'origine dati alla proprietà AlternateText di ogni immagine. In tal modo è possibile ottenere del testo alternativo diverso per ogni immagine visualizzata. Quando si associano dati, se si desidera è possibile formattare il testo alternativo impostando la proprietà DataAlternateTextFormatString.

Quando il valore URL di un'immagine è null, l'immagine non può essere visualizzata. È possibile visualizzare un'immagine alternativa per i valori del campo null impostando la proprietà NullImageUrl. Anziché un'immagine alternativa, è possibile visualizzare del testo alternativo impostando la proprietà NullDisplayText.

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

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

NotaNota

In alcuni controlli con associazione a dati, ad esempio il controllo GridView, è possibile mostrare o nascondere l'intera sezione di intestazione del controllo. Questi controlli con associazione a dati non supportano la proprietà ShowHeader per un singolo campo con associazione a dati. Per mostrare o nascondere l'intera sezione di intestazione di un controllo con associazione a dati, se disponibile, utilizzare la proprietà ShowHeader del controllo.

È 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 riportata di seguito sono elencate le diverse proprietà di stile.

Proprietà di stile

Descrizione

ControlStyle

Impostazioni di stile per i controlli figlio del server Web dell'oggetto ImageField.

FooterStyle

Impostazioni di stile della sezione del piè di pagina dell'oggetto ImageField.

HeaderStyle

Impostazioni di stile della sezione dell'intestazione dell'oggetto ImageField.

ItemStyle

Impostazioni di stile degli elementi dei dati nell'oggetto ImageField.

Nell'esempio riportato di seguito viene illustrato come utilizzare un oggetto ImageField in un controllo GridView 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>



.NET Framework

Supportato in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

Aggiunte alla community

AGGIUNGI
Microsoft sta conducendo un sondaggio in linea per comprendere l'opinione degli utenti in merito al sito Web di MSDN. Se si sceglie di partecipare, quando si lascia il sito Web di MSDN verrà visualizzato il sondaggio in linea.

Si desidera partecipare?
Mostra:
© 2014 Microsoft