Condividi tramite


DataGridTextBoxColumn Classe

Definizione

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

(Ereditato da DataGridColumnStyle)
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, null.

(Ereditato da DataGridColumnStyle)
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)

Si applica a

Vedi anche