Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Classe ImageField

 

Data di pubblicazione: novembre 2016

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

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

System.Object
  System.Web.UI.WebControls.DataControlField
    System.Web.UI.WebControls.ImageField

public class ImageField : DataControlField

NomeDescrizione
System_CAPS_pubmethodImageField()

Inizializza una nuova istanza della classe ImageField.

NomeDescrizione
System_CAPS_pubpropertyAccessibleHeaderText

Ottiene o imposta il testo che viene eseguito il rendering come il AbbreviatedText valore della proprietà in alcuni controlli.(Ereditato da DataControlField.)

System_CAPS_pubpropertyAlternateText

Ottiene o imposta il testo alternativo visualizzato per l'immagine di ImageField oggetto.

System_CAPS_protpropertyControl

Ottiene un riferimento al controllo dati che il DataControlField associato all'oggetto.(Ereditato da DataControlField.)

System_CAPS_pubpropertyControlStyle

Ottiene lo stile dei controlli server Web contenuta la DataControlField oggetto.(Ereditato da DataControlField.)

System_CAPS_pubpropertyConvertEmptyStringToNull

Ottiene o imposta un valore che indica se una stringa vuota ("") vengono convertiti in null quando vengono restituiti i valori dei campi dall'origine dati.

System_CAPS_pubpropertyDataAlternateTextField

Ottiene o imposta il nome del campo dall'origine dati che contiene i valori da associare il AlternateText proprietà di ogni immagine in un ImageField oggetto.

System_CAPS_pubpropertyDataAlternateTextFormatString

Ottiene o imposta la stringa che specifica il formato in cui il testo alternativo per ogni immagine in un ImageField oggetto viene eseguito il rendering.

System_CAPS_pubpropertyDataImageUrlField

Ottiene o imposta il nome del campo dall'origine dati che contiene i valori da associare il ImageUrl proprietà di ogni immagine in un ImageField oggetto.

System_CAPS_pubpropertyDataImageUrlFormatString

Ottiene o imposta la stringa che specifica il formato in cui l'URL per ogni immagine in un ImageField oggetto viene eseguito il rendering.

System_CAPS_protpropertyDesignMode

Ottiene un valore che indica se un campo di controllo di dati è attualmente visualizzato in un ambiente di progettazione.(Ereditato da DataControlField.)

System_CAPS_pubpropertyFooterStyle

Ottiene o imposta lo stile del piè di pagina del campo dati di controllo.(Ereditato da DataControlField.)

System_CAPS_pubpropertyFooterText

Ottiene o imposta il testo che viene visualizzato nell'elemento di piè di pagina di un campo di controllo di dati.(Ereditato da DataControlField.)

System_CAPS_pubpropertyHeaderImageUrl

Ottiene o imposta l'URL di un'immagine che viene visualizzata nell'elemento dell'intestazione di un campo di controllo di dati.(Ereditato da DataControlField.)

System_CAPS_pubpropertyHeaderStyle

Ottiene o imposta lo stile dell'intestazione del campo dati di controllo.(Ereditato da DataControlField.)

System_CAPS_pubpropertyHeaderText

Ottiene o imposta il testo che viene visualizzato nell'elemento dell'intestazione di un campo di controllo di dati.(Ereditato da DataControlField.)

System_CAPS_pubpropertyInsertVisible

Ottiene un valore che indica se il DataControlField oggetto è visibile quando il controllo con associazione a dati padre si trova in modalità di inserimento.(Ereditato da DataControlField.)

System_CAPS_protpropertyIsTrackingViewState

Ottiene un valore che indica se il DataControlField oggetto Salva le modifiche apportate al relativo stato di visualizzazione.(Ereditato da DataControlField.)

System_CAPS_pubpropertyItemStyle

Ottiene lo stile del contenuto basato su testo visualizzato da un campo di controllo di dati.(Ereditato da DataControlField.)

System_CAPS_pubpropertyNullDisplayText

Ottiene o imposta il testo da visualizzare un ImageField dell'oggetto quando il valore del campo specificato per il DataImageUrlField proprietà è null.

System_CAPS_pubpropertyNullImageUrl

Ottiene o imposta l'URL di un'immagine alternativa visualizzata un ImageField dell'oggetto quando il valore del campo specificato per il DataImageUrlField proprietà è null.

System_CAPS_pubpropertyReadOnly

Ottiene o imposta un valore che indica se i valori del campo specificato per il DataImageUrlField proprietà può essere modificata in modalità di modifica.

System_CAPS_pubpropertyShowHeader

Ottiene o imposta un valore che indica se viene eseguito il rendering dell'elemento di intestazione di un campo di controllo di dati.(Ereditato da DataControlField.)

System_CAPS_pubpropertySortExpression

Ottiene o imposta un'espressione di ordinamento utilizzato per ordinare i dati da un controllo origine dati.(Ereditato da DataControlField.)

System_CAPS_protpropertyValidateRequestMode

Ottiene o imposta un valore che specifica se il controllo convalida l'input per il client.(Ereditato da DataControlField.)

System_CAPS_protpropertyViewState

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

System_CAPS_pubpropertyVisible

Ottiene o imposta un valore che indica se viene eseguito il rendering di un campo di controllo di dati.(Ereditato da DataControlField.)

NomeDescrizione
System_CAPS_protmethodCloneField()

Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Crea una copia duplicata dell'oggetto corrente DataControlField-oggetto derivato.(Ereditato da DataControlField.)

System_CAPS_protmethodCopyProperties(DataControlField)

Copia le proprietà dell'oggetto corrente ImageField all'oggetto specificato.(Esegue l'override di DataControlField.CopyProperties(DataControlField).)

System_CAPS_protmethodCreateField()

Restituisce una nuova istanza della classe ImageField.(Esegue l'override di DataControlField.CreateField().)

System_CAPS_pubmethodEquals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object.)

System_CAPS_pubmethodExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)
System_CAPS_protmethodFinalize()

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

System_CAPS_protmethodFormatImageUrlValue(Object)

Si applica il formato specificato tramite il DataImageUrlFormatString su un valore di campo.

System_CAPS_protmethodGetDesignTimeValue()

Recupera il valore utilizzato per il valore del campo per il rendering di ImageField oggetto in una finestra di progettazione.

System_CAPS_protmethodGetFormattedAlternateText(Control)

Si applica il formato specificato tramite la DataAlternateTextFormatString proprietà contenute nell'oggetto specificato sul valore di testo alternativo Control oggetto.

System_CAPS_pubmethodGetHashCode()

Funge da funzione hash predefinita.(Ereditato da Object.)

System_CAPS_pubmethodGetType()

Ottiene l'oggetto Type dell'istanza corrente.(Ereditato da Object.)

System_CAPS_protmethodGetValue(Control, String, PropertyDescriptor)

Recupera il valore del campo specificato dal controllo specificato.

System_CAPS_pubmethodInitialize(Boolean, Control)

Inizializza il ImageField oggetto.(Esegue l'override di DataControlField.Initialize(Boolean, Control).)

System_CAPS_pubmethodInitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Inizializza l'oggetto specificato DataControlFieldCell oggetto con il tipo di cella, lo stato di riga e l'indice di riga.(Esegue l'override di DataControlField.InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32).)

System_CAPS_protmethodInitializeDataCell(DataControlFieldCell, DataControlRowState)

Inizializza l'oggetto specificato DataControlFieldCell oggetto con lo stato della riga specificata.

System_CAPS_protmethodLoadViewState(Object)

Ripristina la vista origine dati precedentemente salvato lo stato di visualizzazione.(Ereditato da DataControlField.)

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.(Ereditato da Object.)

System_CAPS_protmethodOnDataBindField(Object, EventArgs)

Associa il valore di un campo per il ImageField oggetto.

System_CAPS_protmethodOnFieldChanged()

Genera l'evento FieldChanged.(Ereditato da DataControlField.)

System_CAPS_protmethodSaveViewState()

Salva le modifiche apportate al DataControlField lo stato di visualizzazione dal momento la pagina è stata eseguita nel server.(Ereditato da DataControlField.)

System_CAPS_pubmethodToString()

Restituisce una stringa che rappresenta questo DataControlField oggetto.(Ereditato da DataControlField.)

System_CAPS_protmethodTrackViewState()

Determina il DataControlField oggetto delle modifiche apportate al relativo stato di visualizzazione in modo che possano essere archiviate del controllo ViewState proprietà e mantenute nelle richieste della stessa pagina.(Ereditato da DataControlField.)

System_CAPS_pubmethodValidateSupportsCallback()

Determina se i controlli contenuti in un ImageField oggetto supportano i callback.(Esegue l'override di DataControlField.ValidateSupportsCallback().)

NomeDescrizione
System_CAPS_pubfieldSystem_CAPS_staticThisExpression

Rappresenta l'espressione "this".

NomeDescrizione
System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.LoadViewState(Object)

Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Ripristina lo stato di visualizzazione precedentemente salvato del controllo campo dati.(Ereditato da DataControlField.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.SaveViewState()

Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Salva le modifiche apportate al DataControlField lo stato di visualizzazione dal momento la pagina è stata eseguita nel server.(Ereditato da DataControlField.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.TrackViewState()

Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Determina il DataControlField oggetto delle modifiche apportate al relativo stato di visualizzazione in modo che possano essere archiviate del controllo ViewState proprietà e mantenute nelle richieste della stessa pagina.(Ereditato da DataControlField.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataSourceViewSchemaAccessor.DataSourceViewSchema

Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Ottiene o imposta lo schema associato all'oggetto DataControlField.(Ereditato da DataControlField.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIStateManager.IsTrackingViewState

Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Ottiene un valore che indica se il DataControlField oggetto Salva le modifiche apportate al relativo stato di visualizzazione.(Ereditato da DataControlField.)

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

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

  • Utilizzare la AlternateText proprietà per specificare il testo alternativo che si applica a tutte le immagini.

  • Utilizzare la DataAlternateTextField proprietà da associare a un campo da un'origine dati per il AlternateText proprietà di ogni immagine. In questo modo è possibile ottenere il testo alternativo diverso per ciascuna immagine visualizzata. Durante l'associazione dati, è facoltativamente possibile formattare il testo alternativo utilizzando il DataAlternateTextFormatString proprietà.

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

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

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

System_CAPS_noteNota

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

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

Proprietà di stile

Descrizione

ControlStyle

Le impostazioni di stile per i controlli server Web figlio di ImageField oggetto.

FooterStyle

Le impostazioni di stile per la sezione di piè di pagina di ImageField oggetto.

HeaderStyle

Le impostazioni di stile per la sezione dell'intestazione di ImageField oggetto.

ItemStyle

Le impostazioni di stile per gli elementi di dati di ImageField oggetto.

Nell'esempio seguente viene illustrato come utilizzare un ImageField dell'oggetto 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>

.NET Framework
Disponibile da 2.0

I membri statici pubblici ( Condiviso in Visual Basic) di questo tipo è thread safe. Non tutti i membri di istanza sono garantiti come thread safe.

Torna all'inizio
Mostra: