ButtonField Classe
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.
Rappresenta un campo visualizzato come pulsante in un controllo associato a dati.
public ref class ButtonField : System::Web::UI::WebControls::ButtonFieldBasepublic class ButtonField : System.Web.UI.WebControls.ButtonFieldBasetype ButtonField = class
inherit ButtonFieldBasePublic Class ButtonField
Inherits ButtonFieldBase- Ereditarietà
Esempio
Nell'esempio di codice seguente viene illustrato come usare un ButtonField oggetto per visualizzare una colonna di pulsanti di comando in un GridView controllo .
<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void CustomersGridView_RowCommand(Object sender, GridViewCommandEventArgs e)
{
// If multiple ButtonField column fields are used, use the
// CommandName property to determine which button was clicked.
if(e.CommandName=="Select")
{
// Convert the row index stored in the CommandArgument
// property to an Integer.
int index = Convert.ToInt32(e.CommandArgument);
// Get the last name of the selected author from the appropriate
// cell in the GridView control.
GridViewRow selectedRow = CustomersGridView.Rows[index];
TableCell contactName = selectedRow.Cells[1];
string contact = contactName.Text;
// Display the selected author.
Message.Text = "You selected " + contact + ".";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ButtonField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>ButtonField Example</h3>
<asp:label id="Message"
forecolor="Red"
runat="server"
AssociatedControlID="CustomersGridView"/>
<!-- Populate the Columns collection declaratively. -->
<asp:gridview id="CustomersGridView"
datasourceid="CustomersSqlDataSource"
autogeneratecolumns="false"
onrowcommand="CustomersGridView_RowCommand"
runat="server">
<columns>
<asp:buttonfield buttontype="Button"
commandname="Select"
headertext="Select Customer"
text="Select"/>
<asp:boundfield datafield="CompanyName"
headertext="Company Name"/>
<asp:boundfield datafield="ContactName"
headertext="Contact Name"/>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:sqldatasource id="CustomersSqlDataSource"
selectcommand="Select [CustomerID], [CompanyName], [ContactName], [ContactTitle] From [Customers]"
connectionstring="<%$ ConnectionStrings:NorthWindConnection%>"
runat="server">
</asp:sqldatasource>
</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">
<script runat="server">
Sub CustomersGridView_RowCommand(ByVal sender As Object, ByVal e As GridViewCommandEventArgs)
' If multiple ButtonField column fields are used, use the
' CommandName property to determine which button was clicked.
If e.CommandName = "Select" Then
' Convert the row index stored in the CommandArgument
' property to an Integer.
Dim index As Integer = Convert.ToInt32(e.CommandArgument)
' Get the last name of the selected author from the appropriate
' cell in the GridView control.
Dim selectedRow As GridViewRow = CustomersGridView.Rows(index)
Dim contactCell As TableCell = selectedRow.Cells(1)
Dim contact As String = contactCell.Text
' Display the selected author.
Message.Text = "You selected " & contact & "."
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ButtonField Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>ButtonField Example</h3>
<asp:label id="Message"
forecolor="Red"
runat="server"
AssociatedControlID="CustomersGridView"/>
<!-- Populate the Columns collection declaratively. -->
<asp:gridview id="CustomersGridView"
datasourceid="CustomersSqlDataSource"
autogeneratecolumns="false"
onrowcommand="CustomersGridView_RowCommand"
runat="server">
<columns>
<asp:buttonfield buttontype="Button"
commandname="Select"
headertext="Select Customer"
text="Select"/>
<asp:boundfield datafield="CompanyName"
headertext="Company Name"/>
<asp:boundfield datafield="ContactName"
headertext="Contact Name"/>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:sqldatasource id="CustomersSqlDataSource"
selectcommand="Select [CustomerID], [CompanyName], [ContactName], [ContactTitle] From [Customers]"
connectionstring="<%$ ConnectionStrings:NorthWindConnection%>"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
Commenti
La ButtonField classe viene utilizzata dai controlli associati a dati (ad esempio GridView e DetailsView) per visualizzare un pulsante per ogni record visualizzato. L'oggetto ButtonField viene visualizzato in modo diverso a seconda del controllo associato a dati in cui viene utilizzato. Ad esempio, il GridView controllo visualizza un ButtonField oggetto come colonna, mentre il DetailsView controllo lo visualizza come riga.
Facendo clic su un pulsante in un campo pulsante viene generato l'evento di comando del controllo associato a dati padre. È possibile fornire una routine personalizzata da eseguire quando si fa clic su un pulsante di comando specificando un gestore eventi per l'evento di comando.
Annotazioni
Il GridView controllo genera l'evento RowCommand , mentre il DetailsView controllo genera l'evento ItemCommand .
Per determinare l'indice del record che genera l'evento di comando, utilizzare la CommandArgument proprietà dell'argomento evento passato all'evento di comando per il controllo associato a dati. La ButtonField classe popola automaticamente la CommandArgument proprietà con il valore di indice appropriato.
Per specificare il tipo di pulsante da visualizzare, utilizzare la ButtonType proprietà . Quando si visualizza un collegamento o un pulsante di comando, usare la Text proprietà per specificare la didascalia da visualizzare nei pulsanti.
Annotazioni
Se si imposta la Text proprietà , tutti i pulsanti in una ButtonField condivisione condividono la stessa didascalia.
In alternativa, è possibile associare l'oggetto a un campo in un'origine ButtonField dati. In questo modo è possibile visualizzare didascalie diverse per i pulsanti nell'oggetto ButtonField . I valori presenti nel campo specificato vengono utilizzati per le didascalie di testo dei pulsanti. Impostare la DataTextField proprietà per associare un ButtonField oggetto a un campo in un'origine dati.
Quando si visualizza un pulsante immagine, usare la ImageUrl proprietà per specificare l'immagine da visualizzare per i pulsanti nell'oggetto ButtonField .
Annotazioni
Tutti i pulsanti in un ButtonField oggetto condividono la stessa immagine.
È possibile nascondere un ButtonField oggetto in un controllo associato a dati impostando la Visible proprietà su false.
L'oggetto ButtonField consente di personalizzare le relative sezioni di intestazione e piè di pagina. Per visualizzare una didascalia nella sezione intestazione o piè di pagina, impostare rispettivamente le HeaderText proprietà o FooterText . Anziché visualizzare il testo nella sezione intestazione, è possibile visualizzare un'immagine impostando la HeaderImageUrl proprietà . Per nascondere la sezione dell'intestazione in un ButtonField oggetto , impostare 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 pulsante. Per visualizzare o nascondere l'intera sezione di intestazione di un controllo associato a dati ,se disponibile, utilizzare la ShowHeader proprietà per il controllo .
È anche possibile personalizzare l'aspetto dell'oggetto ButtonField (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 | Impostazioni di stile per |
|---|---|
| ControlStyle | Controlli server Web figlio dell'oggetto ButtonField. |
| FooterStyle | Sezione piè di pagina dell'oggetto ButtonField. |
| HeaderStyle | Sezione dell'intestazione ButtonFielddi . |
| ItemStyle | Elementi di dati in ButtonField. |
Costruttori
| Nome | Descrizione |
|---|---|
| ButtonField() |
Inizializza una nuova istanza della classe ButtonField. |
Proprietà
| Nome | Descrizione |
|---|---|
| AccessibleHeaderText |
Ottiene o imposta il testo di cui viene eseguito il rendering come valore della |
| ButtonType |
Ottiene o imposta il tipo di pulsante da visualizzare nel campo del pulsante. (Ereditato da ButtonFieldBase) |
| CausesValidation |
Ottiene o imposta un valore che indica se viene eseguita la convalida quando si fa clic su un pulsante in un ButtonFieldBase oggetto . (Ereditato da ButtonFieldBase) |
| CommandName |
Ottiene o imposta una stringa che rappresenta l'azione da eseguire quando si fa clic su un pulsante in un ButtonField oggetto . |
| 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) |
| DataTextField |
Ottiene o imposta il nome del campo dati per il quale il valore è associato alla Text proprietà del Button controllo di cui viene eseguito il rendering dall'oggetto ButtonField . |
| DataTextFormatString |
Ottiene o imposta la stringa che specifica il formato di visualizzazione per il valore del campo. |
| 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) |
| ImageUrl |
Ottiene o imposta l'immagine da visualizzare per ogni pulsante nell'oggetto ButtonField . |
| 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) |
| ShowHeader |
Ottiene o imposta un valore che indica se la sezione dell'intestazione viene visualizzata in un ButtonFieldBase oggetto . (Ereditato da ButtonFieldBase) |
| SortExpression |
Ottiene o imposta un'espressione di ordinamento utilizzata da un controllo origine dati per ordinare i dati. (Ereditato da DataControlField) |
| Text |
Ottiene o imposta la didascalia statica visualizzata per ogni pulsante nell'oggetto ButtonField . |
| ValidateRequestMode |
Ottiene o imposta un valore che specifica se il controllo convalida l'input client. (Ereditato da DataControlField) |
| ValidationGroup |
Ottiene o imposta il nome del gruppo di controlli di convalida da convalidare quando si fa clic su un pulsante in un ButtonFieldBase oggetto . (Ereditato da ButtonFieldBase) |
| 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 ButtonField nell'oggetto specificato DataControlField . |
| CreateField() |
Crea e restituisce una nuova istanza della ButtonField classe . |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) |
Estrae il valore del campo del controllo dati dalla cella della tabella corrente e aggiunge il valore alla raccolta specificata IDictionary . (Ereditato da DataControlField) |
| FormatDataTextValue(Object) |
Formatta il valore del campo specificato per una cella nell'oggetto ButtonField . |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| Initialize(Boolean, Control) |
Inizializza l'oggetto corrente ButtonField . |
| InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) |
Inizializza l'oggetto specificato DataControlFieldCell nello 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) |
| OnFieldChanged() |
Genera l'evento |
| 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 ButtonField 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) |
