DataGridTextBoxColumn 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.
Attenzione
DataGrid is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use DataGridView instead.
Ospita un TextBox controllo in una cella di un DataGridColumnStyle oggetto per la modifica di stringhe.
public ref class DataGridTextBoxColumn : System::Windows::Forms::DataGridColumnStyle
public class DataGridTextBoxColumn : System.Windows.Forms.DataGridColumnStyle
[System.ComponentModel.Browsable(false)]
[System.Obsolete("`DataGrid` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `DataGridView` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public class DataGridTextBoxColumn : System.Windows.Forms.DataGridColumnStyle
type DataGridTextBoxColumn = class
inherit DataGridColumnStyle
[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`DataGrid` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `DataGridView` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type DataGridTextBoxColumn = class
inherit DataGridColumnStyle
Public Class DataGridTextBoxColumn
Inherits DataGridColumnStyle
- Ereditarietà
- Attributi
Esempio
Nell'esempio seguente viene creato un DataGridTextBoxColumn oggetto e viene aggiunto all'oggetto GridColumnStylesCollection di un oggetto DataGrid. Per eseguire questo esempio di codice, incollarlo in un modulo con un DataGrid nome dataGrid1 e chiamarlo dal costruttore di Form.
private:
void AddColumn()
{
DataTable^ myTable = gcnew DataTable;
// Add a new DataColumn to the DataTable.
DataColumn^ myColumn = gcnew DataColumn( "myTextBoxColumn" );
myColumn->DataType = System::Type::GetType( "System::String" );
myColumn->DefaultValue = "default string";
myTable->Columns->Add( myColumn );
// Get the CurrencyManager for the DataTable.
CurrencyManager^ cm = dynamic_cast<CurrencyManager^>(this->BindingContext[ myTable ]);
// Use the CurrencyManager to get the PropertyDescriptor for the new column.
System::ComponentModel::PropertyDescriptor^ pd = cm->GetItemProperties()[ "myTextBoxColumn" ];
DataGridTextBoxColumn^ myColumnTextColumn;
// Create the DataGridTextBoxColumn with the PropertyDescriptor.
myColumnTextColumn = gcnew DataGridTextBoxColumn( pd );
// Add the new DataGridColumn to the GridColumnsCollection.
dataGrid1->DataSource = myTable;
dataGrid1->TableStyles->Add( gcnew DataGridTableStyle );
dataGrid1->TableStyles[ 0 ]->GridColumnStyles->Add( myColumnTextColumn );
}
private void AddColumn()
{
DataTable myTable= new DataTable();
// Add a new DataColumn to the DataTable.
DataColumn myColumn = new DataColumn("myTextBoxColumn");
myColumn.DataType = System.Type.GetType("System.String");
myColumn.DefaultValue="default string";
myTable.Columns.Add(myColumn);
// Get the CurrencyManager for the DataTable.
CurrencyManager cm = (CurrencyManager)this.BindingContext[myTable];
// Use the CurrencyManager to get the PropertyDescriptor for the new column.
PropertyDescriptor pd = cm.GetItemProperties()["myTextBoxColumn"];
DataGridTextBoxColumn myColumnTextColumn;
// Create the DataGridTextBoxColumn with the PropertyDescriptor.
myColumnTextColumn = new DataGridTextBoxColumn(pd);
// Add the new DataGridColumn to the GridColumnsCollection.
dataGrid1.DataSource= myTable;
dataGrid1.TableStyles.Add(new DataGridTableStyle());
dataGrid1.TableStyles[0].GridColumnStyles.Add(myColumnTextColumn);
}
Private Sub AddColumn()
Dim myTable As New DataTable()
' Add a new DataColumn to the DataTable.
Dim myColumn As New DataColumn("myTextBoxColumn")
myColumn.DataType = System.Type.GetType("System.String")
myColumn.DefaultValue = "default string"
myTable.Columns.Add(myColumn)
' Get the CurrencyManager for the DataTable.
Dim cm As CurrencyManager = CType(Me.BindingContext(myTable), CurrencyManager)
' Use the CurrencyManager to get the PropertyDescriptor for the new column.
Dim pd As PropertyDescriptor = cm.GetItemProperties()("myTextBoxColumn")
Dim myColumnTextColumn As DataGridTextBoxColumn
' Create the DataGridTextBoxColumn with the PropertyDescriptor.
myColumnTextColumn = New DataGridTextBoxColumn(pd)
' Add the new DataGridColumn to the GridColumnsCollection.
dataGrid1.DataSource = myTable
dataGrid1.TableStyles.Add(New DataGridTableStyle())
dataGrid1.TableStyles(0).GridColumnStyles.Add(myColumnTextColumn)
End Sub
Commenti
La DataGridTextBoxColumn classe deriva dalla abstract classe DataGridColumnStyle. In fase di esecuzione, ospita DataGridTextBoxColumn un DataGridTextBox controllo che consente agli utenti di modificare il testo.
Le proprietà speciali aggiunte alla classe includono Formate HideEditBox. Queste proprietà consentono di accedere al controllo ospitato DataGridTextBox e ai relativi attributi e impostare il formato per la visualizzazione dei valori.
Se l'origine dati è un DataTable oggetto contenitore DataColumn , la DataType proprietà di DataColumn deve essere impostata su un tipo di dati che può essere modificato logicamente in un controllo casella di testo. I tipi di dati seguenti vengono associati automaticamente a un DataGridTextBoxColumn oggetto : Byte, DecimalDateTime, Double, Int32UInt16Int16UInt32UInt64Int64Singlee .String
Annotazioni
I tipi seguenti non sono completamente supportati da Visual Basic: DateTime, UInt32UInt16UInt64, , e TimeSpan. Gli operatori non sono consentiti.
Costruttori
| Nome | Descrizione |
|---|---|
| DataGridTextBoxColumn() |
Obsoleti.
Inizializza una nuova istanza della classe DataGridTextBoxColumn. |
| DataGridTextBoxColumn(PropertyDescriptor, Boolean) |
Obsoleti.
Inizializza una nuova istanza della DataGridTextBoxColumn classe utilizzando l'oggetto specificato PropertyDescriptor. Specifica se è DataGridTextBoxColumn una colonna predefinita. |
| DataGridTextBoxColumn(PropertyDescriptor, String, Boolean) |
Obsoleti.
Inizializza una nuova istanza della DataGridTextBoxColumn classe con un formato e specificato PropertyDescriptor . Specifica se la colonna è la colonna predefinita. |
| DataGridTextBoxColumn(PropertyDescriptor, String) |
Obsoleti.
Inizializza una nuova istanza della DataGridTextBoxColumn classe con il formato e specificato PropertyDescriptor . |
| DataGridTextBoxColumn(PropertyDescriptor) |
Obsoleti.
Inizializza una nuova istanza della DataGridTextBoxColumn classe con un oggetto specificato PropertyDescriptor. |
Proprietà
| Nome | Descrizione |
|---|---|
| Alignment |
Obsoleti.
Ottiene o imposta l'allineamento del testo in una colonna. (Ereditato da DataGridColumnStyle) |
| CanRaiseEvents |
Obsoleti.
Ottiene un valore che indica se il componente può generare un evento. (Ereditato da Component) |
| Container |
Obsoleti.
Ottiene l'oggetto IContainer contenente l'oggetto Component. (Ereditato da Component) |
| DataGridTableStyle |
Obsoleti.
Ottiene l'oggetto DataGridTableStyle per la colonna. (Ereditato da DataGridColumnStyle) |
| DesignMode |
Obsoleti.
Ottiene un valore che indica se è Component attualmente in modalità progettazione. (Ereditato da Component) |
| Events |
Obsoleti.
Ottiene l'elenco dei gestori eventi associati a questo Componentoggetto . (Ereditato da Component) |
| FontHeight |
Obsoleti.
Ottiene l'altezza del tipo di carattere della colonna. (Ereditato da DataGridColumnStyle) |
| Format |
Obsoleti.
Ottiene o imposta i caratteri che specificano la modalità di formattazione del testo. |
| FormatInfo |
Obsoleti.
Ottiene o imposta le informazioni specifiche delle impostazioni cultura utilizzate per determinare la formattazione dei valori. |
| HeaderAccessibleObject |
Obsoleti.
Ottiene l'oggetto AccessibleObject per la colonna. (Ereditato da DataGridColumnStyle) |
| HeaderText |
Obsoleti.
Ottiene o imposta il testo dell'intestazione di colonna. (Ereditato da DataGridColumnStyle) |
| MappingName |
Obsoleti.
Ottiene o imposta il nome del membro dati in cui eseguire il mapping dello stile della colonna. (Ereditato da DataGridColumnStyle) |
| NullText |
Obsoleti.
Ottiene o imposta il testo visualizzato quando la colonna contiene |
| PropertyDescriptor |
Obsoleti.
Ottiene o imposta l'oggetto PropertyDescriptor per l'oggetto DataGridTextBoxColumn. |
| ReadOnly |
Obsoleti.
Imposta un valore che indica se la colonna della casella di testo è di sola lettura. |
| ReadOnly |
Obsoleti.
Ottiene o imposta un valore che indica se i dati nella colonna possono essere modificati. (Ereditato da DataGridColumnStyle) |
| Site |
Obsoleti.
Ottiene o imposta l'oggetto ISite dell'oggetto Component. (Ereditato da Component) |
| TextBox |
Obsoleti.
Ottiene il controllo ospitato TextBox . |
| Width |
Obsoleti.
Ottiene o imposta la larghezza della colonna. (Ereditato da DataGridColumnStyle) |
Metodi
| Nome | Descrizione |
|---|---|
| Abort(Int32) |
Obsoleti.
Avvia una richiesta per interrompere una procedura di modifica. |
| BeginUpdate() |
Obsoleti.
Sospende il disegno della colonna fino a quando non viene chiamato il EndUpdate() metodo . (Ereditato da DataGridColumnStyle) |
| CheckValidDataSource(CurrencyManager) |
Obsoleti.
Genera un'eccezione se l'oggetto non dispone di un'origine DataGrid dati valida o se questa colonna non è mappata a una proprietà valida nell'origine dati. (Ereditato da DataGridColumnStyle) |
| ColumnStartedEditing(Control) |
Obsoleti.
Informa che DataGrid l'utente ha iniziato a modificare la colonna. (Ereditato da DataGridColumnStyle) |
| Commit(CurrencyManager, Int32) |
Obsoleti.
Avvia una richiesta per completare una procedura di modifica. |
| ConcedeFocus() |
Obsoleti.
Indica alla colonna che lo stato attivo viene concesso. |
| ConcedeFocus() |
Obsoleti.
Notifica a una colonna che deve rinunciare allo stato attivo per il controllo che ospita. (Ereditato da DataGridColumnStyle) |
| CreateHeaderAccessibleObject() |
Obsoleti.
Ottiene l'oggetto AccessibleObject per la colonna. (Ereditato da DataGridColumnStyle) |
| CreateObjRef(Type) |
Obsoleti.
Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare con un oggetto remoto. (Ereditato da MarshalByRefObject) |
| Dispose() |
Obsoleti.
Rilascia tutte le risorse usate da Component. (Ereditato da Component) |
| Dispose(Boolean) |
Obsoleti.
Rilascia le risorse non gestite usate da Component e, facoltativamente, rilascia le risorse gestite. (Ereditato da Component) |
| Edit(CurrencyManager, Int32, Rectangle, Boolean, String, Boolean) |
Obsoleti.
Prepara una cella per la modifica. |
| Edit(CurrencyManager, Int32, Rectangle, Boolean, String) |
Obsoleti.
Prepara la cella per la modifica usando i parametri , il numero di riga e Rectangle i parametri specificatiCurrencyManager. (Ereditato da DataGridColumnStyle) |
| Edit(CurrencyManager, Int32, Rectangle, Boolean) |
Obsoleti.
Prepara una cella per la modifica. (Ereditato da DataGridColumnStyle) |
| EndEdit() |
Obsoleti.
Termina un'operazione di modifica su DataGridColumnStyle. |
| EndUpdate() |
Obsoleti.
Riprende il disegno delle colonne sospese chiamando il BeginUpdate() metodo . (Ereditato da DataGridColumnStyle) |
| EnterNullValue() |
Obsoleti.
Immette un oggetto Value nella colonna . |
| EnterNullValue() |
Obsoleti.
Inserisce un oggetto Value nella colonna . (Ereditato da DataGridColumnStyle) |
| Equals(Object) |
Obsoleti.
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| GetColumnValueAtRow(CurrencyManager, Int32) |
Obsoleti.
Ottiene il valore nella riga specificata dall'oggetto specificato CurrencyManager. (Ereditato da DataGridColumnStyle) |
| GetHashCode() |
Obsoleti.
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetLifetimeService() |
Obsoleti.
Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject) |
| GetMinimumHeight() |
Obsoleti.
Ottiene l'altezza di una cella in un oggetto DataGridColumnStyle. |
| GetPreferredHeight(Graphics, Object) |
Obsoleti.
Ottiene l'altezza da utilizzare per il ridimensionamento automatico delle colonne. |
| GetPreferredSize(Graphics, Object) |
Obsoleti.
Restituisce la larghezza e l'altezza ottimali della cella in una riga specificata rispetto al valore specificato. |
| GetService(Type) |
Obsoleti.
Restituisce un oggetto che rappresenta un servizio fornito da Component o da Container. (Ereditato da Component) |
| GetType() |
Obsoleti.
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| HideEditBox() |
Obsoleti.
Nasconde il DataGridTextBox controllo e sposta lo stato attivo sul DataGrid controllo. |
| InitializeLifetimeService() |
Obsoleti.
Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject) |
| Invalidate() |
Obsoleti.
Ridisegna la colonna e fa sì che un messaggio di disegno venga inviato al controllo. (Ereditato da DataGridColumnStyle) |
| MemberwiseClone() |
Obsoleti.
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| MemberwiseClone(Boolean) |
Obsoleti.
Crea una copia superficiale dell'oggetto corrente MarshalByRefObject . (Ereditato da MarshalByRefObject) |
| Paint(Graphics, Rectangle, CurrencyManager, Int32, Boolean) |
Obsoleti.
Disegna un DataGridColumnStyle oggetto con l'oggetto , Rectangle, CurrencyManager, il numero di riga e l'allineamento specificatiGraphics. |
| Paint(Graphics, Rectangle, CurrencyManager, Int32, Brush, Brush, Boolean) |
Obsoleti.
Disegna un DataGridColumnStyle oggetto con il Graphicscolore di primo piano , Rectangle, CurrencyManager, Brushspecificato. |
| Paint(Graphics, Rectangle, CurrencyManager, Int32, Brush, Brush, Boolean) |
Obsoleti.
Disegna un DataGridColumnStyle oggetto con il numero di riga , Rectangle, CurrencyManager, , il colore di sfondo, il colore di primo piano e l'allineamento specificatiGraphics. (Ereditato da DataGridColumnStyle) |
| Paint(Graphics, Rectangle, CurrencyManager, Int32) |
Obsoleti.
Disegna l'oggetto con DataGridColumnStyle il numero di riga , RectangleCurrencyManager, e specificatoGraphics. |
| PaintText(Graphics, Rectangle, String, Boolean) |
Obsoleti.
Disegna il testo e il rettangolo nella posizione specificata con l'allineamento specificato. |
| PaintText(Graphics, Rectangle, String, Brush, Brush, Boolean) |
Obsoleti.
Disegna il testo e il rettangolo nella posizione specificata con i colori e l'allineamento specificati. |
| ReleaseHostedControl() |
Obsoleti.
Rimuove il riferimento contenuto nel DataGrid controllo utilizzato per modificare i dati. |
| ReleaseHostedControl() |
Obsoleti.
Consente alla colonna di liberare risorse quando il controllo che ospita non è necessario. (Ereditato da DataGridColumnStyle) |
| ResetHeaderText() |
Obsoleti.
Reimposta l'oggetto sul HeaderText relativo valore predefinito, |
| SetColumnValueAtRow(CurrencyManager, Int32, Object) |
Obsoleti.
Imposta il valore in una riga specificata con il valore di un oggetto specificato CurrencyManager. (Ereditato da DataGridColumnStyle) |
| SetDataGrid(DataGrid) |
Obsoleti.
Imposta il DataGrid controllo a cui appartiene questa colonna. (Ereditato da DataGridColumnStyle) |
| SetDataGridInColumn(DataGrid) |
Obsoleti.
Aggiunge un TextBox controllo all'oggetto DataGrid del Control.ControlCollectioncontrollo . |
| SetDataGridInColumn(DataGrid) |
Obsoleti.
Imposta l'oggetto DataGrid per la colonna. (Ereditato da DataGridColumnStyle) |
| ToString() |
Obsoleti.
Restituisce un oggetto String contenente il nome dell'oggetto Component, se presente. Questo metodo non deve essere sottoposto a override. (Ereditato da Component) |
| UpdateUI(CurrencyManager, Int32, String) |
Obsoleti.
Aggiorna l'interfaccia utente. |
| UpdateUI(CurrencyManager, Int32, String) |
Obsoleti.
Aggiorna il valore di una riga specificata con il testo specificato. (Ereditato da DataGridColumnStyle) |
Eventi
| Nome | Descrizione |
|---|---|
| AlignmentChanged |
Obsoleti.
Si verifica quando il valore della Alignment proprietà cambia. (Ereditato da DataGridColumnStyle) |
| Disposed |
Obsoleti.
Si verifica quando il componente viene eliminato da una chiamata al Dispose() metodo . (Ereditato da Component) |
| FontChanged |
Obsoleti.
Si verifica quando cambia il tipo di carattere della colonna. (Ereditato da DataGridColumnStyle) |
| HeaderTextChanged |
Obsoleti.
Si verifica quando il valore della HeaderText proprietà cambia. (Ereditato da DataGridColumnStyle) |
| MappingNameChanged |
Obsoleti.
Si verifica quando il MappingName valore cambia. (Ereditato da DataGridColumnStyle) |
| NullTextChanged |
Obsoleti.
Si verifica quando il NullText valore cambia. (Ereditato da DataGridColumnStyle) |
| PropertyDescriptorChanged |
Obsoleti.
Si verifica quando il valore della PropertyDescriptor proprietà cambia. (Ereditato da DataGridColumnStyle) |
| ReadOnlyChanged |
Obsoleti.
Si verifica quando il valore della ReadOnly proprietà cambia. (Ereditato da DataGridColumnStyle) |
| WidthChanged |
Obsoleti.
Si verifica quando il valore della Width proprietà cambia. (Ereditato da DataGridColumnStyle) |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| IDataGridColumnStyleEditingNotificationService.ColumnStartedEditing(Control) |
Obsoleti.
Informa il DataGrid controllo che l'utente ha iniziato a modificare la colonna. (Ereditato da DataGridColumnStyle) |