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 DataBoundLiteralControl

.NET Framework (current version)

Altre versioni

Data di pubblicazione: ottobre 2016

Mantiene le espressioni di data binding e il testo letterale statico. La classe non può essere ereditata.

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

Gerarchia di ereditarietà

System.Object
System.Web.UI.Control
System.Web.UI.DataBoundLiteralControl

Sintassi

C++

public sealed class DataBoundLiteralControl : Control, ITextControl

Costruttori

	Nome	Descrizione
	DataBoundLiteralControl(Int32, Int32)	Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Inizializza una nuova istanza della classe DataBoundLiteralControl.

Proprietà

	Nome	Descrizione
	AppRelativeTemplateSourceDirectory	Ottiene o imposta la directory virtuale relativa all'applicazione di Page o UserControl oggetto che contiene questo controllo.(Ereditato da Control.)
	BindingContainer	Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Ottiene il controllo che contiene l'associazione di dati del controllo.(Ereditato da Control.)
	ClientID	Ottiene l'ID di controllo per il markup HTML generato da ASP.NET.(Ereditato da Control.)
	ClientIDMode	Ottiene o imposta l'algoritmo utilizzato per generare il valore di ClientID proprietà.(Ereditato da Control.)
	Context	Ottiene il HttpContext oggetto associato al controllo server per la richiesta Web corrente.(Ereditato da Control.)
	Controls	Ottiene un oggetto ControlCollection che rappresenta i controlli figlio per un controllo server specificato nella gerarchia dell'interfaccia utente.(Ereditato da Control.)
	DataItemContainer	Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataItemContainer.(Ereditato da Control.)
	DataKeysContainer	Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataKeysControl.(Ereditato da Control.)
	DesignMode	Ottiene un valore che indica se un controllo viene utilizzato in un'area di progettazione.(Ereditato da Control.)
	EnableTheming	Ottiene o imposta un valore che indica se i temi si applicano a questo controllo.(Ereditato da Control.)
	EnableViewState	Ottiene o imposta un valore che indica se lo stato di visualizzazione del controllo server deve essere persistente e lo stato di visualizzazione dei controlli figlio contenuti, per il client richiedente.(Ereditato da Control.)
	ID	Ottiene o imposta l'identificatore a livello di codice assegnato al controllo del server.(Ereditato da Control.)
	IsChildControlStateCleared	Ottiene un valore che indica se i controlli contenuti all'interno di questo controllo lo stato del controllo.(Ereditato da Control.)
	IsViewStateEnabled	Ottiene un valore che indica se lo stato di visualizzazione è abilitato per questo controllo.(Ereditato da Control.)
	NamingContainer	Ottiene un riferimento al controllo del server dei nomi del contenitore, che consente di creare uno spazio dei nomi univoco per distinguere i controlli server con lo stesso Control.ID valore della proprietà.(Ereditato da Control.)
	Page	Ottiene un riferimento di Page istanza che contiene il controllo del server.(Ereditato da Control.)
	Parent	Ottiene un riferimento al controllo padre del controllo server nella gerarchia dei controlli della pagina.(Ereditato da Control.)
	RenderingCompatibility	Ottiene un valore che specifica la versione ASP.NET che viene eseguito il rendering HTML sarà compatibile con.(Ereditato da Control.)
	Site	Ottiene informazioni sul contenitore che ospita il controllo corrente quando viene eseguito il rendering nell'area di progettazione.(Ereditato da Control.)
	SkinID	Ottiene o imposta l'interfaccia personalizzata da applicare al controllo.(Ereditato da Control.)
	TemplateControl	Ottiene o imposta un riferimento a un modello che contiene questo controllo.(Ereditato da Control.)
	TemplateSourceDirectory	Ottiene la directory virtuale del Page o UserControl che contiene il controllo del server corrente.(Ereditato da Control.)
	Text	Ottiene il contenuto di testo di DataBoundLiteralControl oggetto.
	UniqueID	Ottiene l'identificatore univoco qualificato gerarchicamente per il controllo server.(Ereditato da Control.)
	ValidateRequestMode	Ottiene o imposta un valore che indica se il controllo verifica l'input per il client dal browser per valori potenzialmente pericolosi.(Ereditato da Control.)
	ViewStateMode	Ottiene o imposta la modalità di stato di visualizzazione di questo controllo.(Ereditato da Control.)
	Visible	Ottiene o imposta un valore che indica se viene eseguito il rendering di un controllo server come interfaccia utente nella pagina.(Ereditato da Control.)

Metodi

	Nome	Descrizione
	AddedControl(Control, Int32)	Chiamato dopo l'aggiunta di un controllo figlio per il Controls insieme il Control oggetto.(Ereditato da Control.)
	ApplyStyleSheetSkin(Page)	Applica le proprietà di stile definite nel foglio di stile della pagina al controllo.(Ereditato da Control.)
	CreateChildControls()	Viene chiamato dal framework della pagina ASP.NET per notificare ai controlli server che usano un'implementazione basata sulla composizione di creare gli eventuali controlli figlio in essi contenuti in preparazione per il postback o il rendering.(Ereditato da Control.)
	DataBind()	Associa un'origine dati al controllo server richiamato e a tutti i controlli figlio.(Ereditato da Control.)
	Dispose()	Consente a un controllo server eseguire pulitura finale prima che venga rilasciato dalla memoria.(Ereditato da Control.)
	Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente.(Ereditato da Object.)
	FindControl(String)	Cerca nel contenitore di denominazione corrente per un controllo server con l'oggetto specificato id parametro.(Ereditato da Control.)
	Focus()	Imposta lo stato attivo a un controllo.(Ereditato da Control.)
	GetHashCode()	Funge da funzione hash predefinita.(Ereditato da Object.)
	GetRouteUrl(Object)	Ottiene l'URL che corrisponde a un set di parametri di route.(Ereditato da Control.)
	GetRouteUrl(RouteValueDictionary)	Ottiene l'URL che corrisponde a un set di parametri di route.(Ereditato da Control.)
	GetRouteUrl(String, Object)	Ottiene l'URL che corrisponde a un set di parametri di route e un nome di route.(Ereditato da Control.)
	GetRouteUrl(String, RouteValueDictionary)	Ottiene l'URL che corrisponde a un set di parametri di route e un nome di route.(Ereditato da Control.)
	GetType()	Ottiene l'oggetto Type dell'istanza corrente.(Ereditato da Object.)
	GetUniqueIDRelativeTo(Control)	Restituisce la parte del prefissata di UniqueID proprietà del controllo specificato.(Ereditato da Control.)
	HasControls()	Determina se il controllo del server contiene eventuali controlli figlio.(Ereditato da Control.)
	LoadControlState(Object)	Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente è stato salvato tramite il SaveControlState metodo.(Ereditato da Control.)
	MapPathSecure(String)	Recupera il percorso fisico che esegue il mapping a un percorso virtuale, assoluto o relativo.(Ereditato da Control.)
	OnInit(EventArgs)	Genera l'evento Init.(Ereditato da Control.)
	OnLoad(EventArgs)	Genera l'evento Load.(Ereditato da Control.)
	OnPreRender(EventArgs)	Genera l'evento PreRender.(Ereditato da Control.)
	OnUnload(EventArgs)	Genera l'evento Unload.(Ereditato da Control.)
	OpenFile(String)	Ottiene un Stream utilizzata per leggere un file.(Ereditato da Control.)
	RemovedControl(Control)	Chiamato dopo la rimozione di un controllo figlio dal Controls insieme il Control oggetto.(Ereditato da Control.)
	Render(HtmlTextWriter)	Invia il contenuto del controllo server a un oggetto HtmlTextWriter specificato che scrive il contenuto di cui eseguire il rendering nel client.(Ereditato da Control.)
	RenderChildren(HtmlTextWriter)	Restituisce il contenuto di elementi figlio di un controllo server a un oggetto fornito HtmlTextWriter oggetto, che scrive il contenuto da sottoporre a rendering sul client.(Ereditato da Control.)
	RenderControl(HtmlTextWriter)	Restituisce il contenuto del controllo a un oggetto fornito HtmlTextWriter dell'oggetto e vengono archiviate le informazioni sul controllo se è attivata.(Ereditato da Control.)
	ResolveClientUrl(String)	Ottiene un URL che può essere utilizzato dal browser.(Ereditato da Control.)
	ResolveUrl(String)	Converte un URL in un formato utilizzabile dal client richiedente.(Ereditato da Control.)
	SaveControlState()	Salva tutte le modifiche dello stato di un controllo server apportate dopo il postback della pagina nel server.(Ereditato da Control.)
	SetDataBoundString(Int32, String)	Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Assegna un valore stringa a una matrice contenente i valori associati a dati.
	SetRenderMethodDelegate(RenderMethod)	Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Assegna un delegato del gestore eventi per eseguire il rendering del controllo server e il relativo contenuto nel relativo controllo padre.(Ereditato da Control.)
	SetStaticString(Int32, String)	Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Assegna un valore stringa a una matrice contenente valori statici.
	SetTraceData(Object, Object)	Set di dati per analisi dei dati di rendering, utilizzando la chiave di dati di traccia e il valore di dati di traccia di in fase di progettazione di traccia.(Ereditato da Control.)
	SetTraceData(Object, Object, Object)	Set di dati per analisi dei dati di rendering, utilizzando l'oggetto tracciato, la chiave di dati di traccia e il valore di dati di traccia di in fase di progettazione di traccia.(Ereditato da Control.)
	ToString()	Restituisce una stringa che rappresenta l'oggetto corrente.(Ereditato da Object.)

Eventi

	Nome	Descrizione
	DataBinding	Si verifica quando il controllo server viene associato a un'origine dati.(Ereditato da Control.)
	Disposed	Si verifica quando un controllo server viene rilasciato dalla memoria, ovvero l'ultima fase del ciclo di vita di controllo server quando viene richiesta una pagina ASP.NET.(Ereditato da Control.)
	Init	Si verifica quando viene inizializzato il controllo del server, ovvero il primo passaggio nel ciclo di vita.(Ereditato da Control.)
	Load	Si verifica quando il controllo server viene caricato il Page oggetto.(Ereditato da Control.)
	PreRender	Si verifica dopo il Control oggetto viene caricato, ma prima del rendering.(Ereditato da Control.)
	Unload	Si verifica quando il controllo server viene scaricato dalla memoria.(Ereditato da Control.)

Implementazioni esplicite dell'interfaccia

	Nome	Descrizione
	IControlDesignerAccessor.GetDesignModeState()	Per una descrizione di questo membro, vedere IControlDesignerAccessor.GetDesignModeState.(Ereditato da Control.)
	IControlDesignerAccessor.SetDesignModeState(IDictionary)	Per una descrizione di questo membro, vedere IControlDesignerAccessor.SetDesignModeState.(Ereditato da Control.)
	IControlDesignerAccessor.SetOwnerControl(Control)	Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Per una descrizione di questo membro, vedere IControlDesignerAccessor.SetOwnerControl.(Ereditato da Control.)
	IParserAccessor.AddParsedSubObject(Object)	Per una descrizione di questo membro, vedere IParserAccessor.AddParsedSubObject.(Ereditato da Control.)
	IControlBuilderAccessor.ControlBuilder	Per una descrizione di questo membro, vedere IControlBuilderAccessor.ControlBuilder.(Ereditato da Control.)
	IControlDesignerAccessor.UserData	Per una descrizione di questo membro, vedere IControlDesignerAccessor.UserData.(Ereditato da Control.)
	IDataBindingsAccessor.DataBindings	Per una descrizione di questo membro, vedere IDataBindingsAccessor.DataBindings.(Ereditato da Control.)
	IDataBindingsAccessor.HasDataBindings	Per una descrizione di questo membro, vedere IDataBindingsAccessor.HasDataBindings.(Ereditato da Control.)
	IExpressionsAccessor.Expressions	Per una descrizione di questo membro, vedere IExpressionsAccessor.Expressions.(Ereditato da Control.)
	IExpressionsAccessor.HasExpressions	Per una descrizione di questo membro, vedere IExpressionsAccessor.HasExpressions.(Ereditato da Control.)
	ITextControl.Text	Ottiene o imposta il contenuto di testo di DataBoundLiteralControl oggetto.

Metodi di estensione

	Nome	Descrizione
	FindDataSourceControl()	Restituisce l'origine dati che è associato al controllo di dati per il controllo specificato.(Definito da DynamicDataExtensions.)
	FindFieldTemplate(String)	Restituisce che il modello di campo per la colonna specificata nel controllo specificato del contenitore di denominazione.(Definito da DynamicDataExtensions.)
	FindMetaTable()	Restituisce l'oggetto metatabella per il controllo dati contenitore.(Definito da DynamicDataExtensions.)

Osservazioni

The T:System.Web.UI.DataBoundLiteralControl class persists the value of its P:System.Web.UI.DataBoundLiteralControl.Text property to view state.

Esempi

The following code example creates a class that obtains a T:System.Web.UI.DataBoundLiteralControl object and displays the P:System.Web.UI.DataBoundLiteralControl.Text property of the object.


using System;
using System.Web;
using System.Web.UI;

namespace Samples.AspNet.CS.Controls 
{

   public class MyControl : Control 
   {

    [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] 
    protected override void Render(HtmlTextWriter output) 
    {
      // Checks if a DataBoundLiteralControl object is present.
      if ( (HasControls()) && (Controls[0] is DataBoundLiteralControl) ) 
      {
        // Obtains the DataBoundLiteralControl instance.
        DataBoundLiteralControl boundLiteralControl = (DataBoundLiteralControl)Controls[0];
        // Retrieves the text in the boundLiteralControl object.
        String text = boundLiteralControl.Text;
        output.Write("<h4>Your Message: " +text+"</h4>");

      }
    }
   }    
}