DataGridTextBoxColumn Klasse

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

DataGridTextBoxColumn.cs

Achtung

DataGrid is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use DataGridView instead.

Hostet ein TextBox Steuerelement in einer Zelle einer DataGridColumnStyle zum Bearbeiten von Zeichenfolgen.

public ref 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

[<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

Vererbung

Object

MarshalByRefObject

Component

DataGridColumnStyle

DataGridTextBoxColumn

Attribute

BrowsableAttribute ObsoleteAttribute

Beispiele

Im folgenden Beispiel wird ein DataGridTextBoxColumn Objekt erstellt und dem GridColumnStylesCollection Von - DataGridObjekt hinzugefügt. Zum Ausführen dieses Codebeispiels fügen Sie es in ein Formular ein, das einen DataGrid Benannten dataGrid1 hat, und rufen Sie es aus dem Konstruktor der .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

Hinweise

Die DataGridTextBoxColumn Klasse wird von der abstract Klasse DataGridColumnStyleabgeleitet. Zur Laufzeit hosten die Hosts ein DataGridTextBox Steuerelement, mit dem DataGridTextBoxColumn Benutzer Text bearbeiten können.

Spezielle Eigenschaften, die der Klasse hinzugefügt werden, enthalten Formatund HideEditBox. Mit diesen Eigenschaften können Sie auf das gehostete DataGridTextBox Steuerelement und dessen Attribute zugreifen und das Format für die Anzeige von Werten festlegen.

Wenn es sich bei der Datenquelle um objekte DataTable handelt DataColumn , sollte die DataType Eigenschaft des DataColumn Datentyps auf einen Datentyp festgelegt werden, der logisch in einem Textfeld-Steuerelement bearbeitet werden kann. Die folgenden Datentypen werden automatisch einem : , , , , Decimal, Double, Int16Int32, , Int64UInt64SingleUInt16UInt32und .StringDateTimeByteDataGridTextBoxColumn

Hinweis

Die folgenden Typen werden von Visual Basic nicht vollständig unterstützt: DateTime, , UInt16, , UInt32und TimeSpanUInt64. (Operatoren sind nicht zulässig.)

Konstruktoren

Name	Beschreibung
DataGridTextBoxColumn()	Veraltet. Initialisiert eine neue Instanz der DataGridTextBoxColumn-Klasse.
DataGridTextBoxColumn(PropertyDescriptor, Boolean)	Veraltet. Initialisiert eine neue Instanz der Klasse mithilfe des DataGridTextBoxColumn angegebenen PropertyDescriptor. Gibt an, ob es DataGridTextBoxColumn sich um eine Standardspalte handelt.
DataGridTextBoxColumn(PropertyDescriptor, String, Boolean)	Veraltet. Initialisiert eine neue Instanz der DataGridTextBoxColumn Klasse mit einem angegebenen PropertyDescriptor Und Format. Gibt an, ob die Spalte die Standardspalte ist.
DataGridTextBoxColumn(PropertyDescriptor, String)	Veraltet. Initialisiert eine neue Instanz der DataGridTextBoxColumn Klasse mit dem angegebenen PropertyDescriptor Und Format.
DataGridTextBoxColumn(PropertyDescriptor)	Veraltet. Initialisiert eine neue Instanz der DataGridTextBoxColumn Klasse mit einem angegebenen PropertyDescriptor.

Eigenschaften

Name	Beschreibung
Alignment	Veraltet. Ruft die Ausrichtung von Text in einer Spalte ab oder legt sie fest. (Geerbt von DataGridColumnStyle)
DataGridTableStyle	Veraltet. Ruft die DataGridTableStyle Spalte ab. (Geerbt von DataGridColumnStyle)
FontHeight	Veraltet. Ruft die Höhe der Schriftart der Spalte ab. (Geerbt von DataGridColumnStyle)
Format	Veraltet. Dient zum Abrufen oder Festlegen der Zeichen, die angeben, wie Text formatiert wird.
FormatInfo	Veraltet. Ruft die kulturspezifischen Informationen ab, die verwendet werden, um zu bestimmen, wie Werte formatiert werden, oder legt diese fest.
HeaderAccessibleObject	Veraltet. Ruft die AccessibleObject Spalte ab. (Geerbt von DataGridColumnStyle)
HeaderText	Veraltet. Dient zum Abrufen oder Festlegen des Texts der Spaltenüberschrift. (Geerbt von DataGridColumnStyle)
MappingName	Veraltet. Ruft den Namen des Datenelements ab, dem die Spaltenformatvorlage zugeordnet werden soll, oder legt diesen fest. (Geerbt von DataGridColumnStyle)
NullText	Veraltet. Ruft den Text ab, der angezeigt wird, wenn die Spalte enthält null, oder legt diesen fest. (Geerbt von DataGridColumnStyle)
PropertyDescriptor	Veraltet. Ruft ab oder legt den PropertyDescriptor für die DataGridTextBoxColumn.
ReadOnly	Veraltet. Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Daten in der Spalte bearbeitet werden können. (Geerbt von DataGridColumnStyle)
TextBox	Veraltet. Ruft das gehostete Steuerelement ab TextBox .
Width	Veraltet. Ruft die Breite der Spalte ab oder legt sie fest. (Geerbt von DataGridColumnStyle)

Methoden

Name	Beschreibung
Abort(Int32)	Veraltet. Initiiert eine Anforderung zum Unterbrechen einer Bearbeitungsprozedur.
BeginUpdate()	Veraltet. Hält das Malen der Spalte an, bis die EndUpdate() Methode aufgerufen wird. (Geerbt von DataGridColumnStyle)
CheckValidDataSource(CurrencyManager)	Veraltet. Löst eine Ausnahme aus, wenn die DataGrid Datenquelle nicht gültig ist oder diese Spalte keiner gültigen Eigenschaft in der Datenquelle zugeordnet ist. (Geerbt von DataGridColumnStyle)
ColumnStartedEditing(Control)	Veraltet. Informiert den DataGrid Benutzer darüber, dass der Benutzer mit der Bearbeitung der Spalte begonnen hat. (Geerbt von DataGridColumnStyle)
Commit(CurrencyManager, Int32)	Veraltet. Initiiert eine Anforderung zum Abschließen eines Bearbeitungsvorgangs.
ConcedeFocus()	Veraltet. Benachrichtigt eine Spalte, dass sie den Fokus auf das Steuerelement zurückgibt, das gehostet wird. (Geerbt von DataGridColumnStyle)
CreateHeaderAccessibleObject()	Veraltet. Ruft die AccessibleObject Spalte ab. (Geerbt von DataGridColumnStyle)
Edit(CurrencyManager, Int32, Rectangle, Boolean, String, Boolean)	Veraltet. Bereitet eine Zelle für die Bearbeitung vor.
Edit(CurrencyManager, Int32, Rectangle, Boolean, String)	Veraltet. Bereitet die Zelle für die Bearbeitung mithilfe der angegebenen CurrencyManagerZeilennummer und Rectangle parameter vor. (Geerbt von DataGridColumnStyle)
Edit(CurrencyManager, Int32, Rectangle, Boolean)	Veraltet. Bereitet eine Zelle für die Bearbeitung vor. (Geerbt von DataGridColumnStyle)
EndEdit()	Veraltet. Beendet einen Bearbeitungsvorgang für die DataGridColumnStyle.
EndUpdate()	Veraltet. Setzt das Zeichnen von Spalten fort, die durch Aufrufen der BeginUpdate() Methode angehalten werden. (Geerbt von DataGridColumnStyle)
EnterNullValue()	Veraltet. Gibt eine Value in die Spalte ein. (Geerbt von DataGridColumnStyle)
GetColumnValueAtRow(CurrencyManager, Int32)	Veraltet. Ruft den Wert in der angegebenen Zeile aus dem angegebenen CurrencyManagerab. (Geerbt von DataGridColumnStyle)
GetMinimumHeight()	Veraltet. Ruft die Höhe einer Zelle in einer DataGridColumnStyle.
GetPreferredHeight(Graphics, Object)	Veraltet. Ruft die Höhe ab, die zum automatischen Ändern der Größe von Spalten verwendet werden soll.
GetPreferredSize(Graphics, Object)	Veraltet. Gibt die optimale Breite und Höhe der Zelle in einer angegebenen Zeile relativ zum angegebenen Wert zurück.
HideEditBox()	Veraltet. Blendet das DataGridTextBox Steuerelement aus und verschiebt den Fokus auf das DataGrid Steuerelement.
Invalidate()	Veraltet. Zeichnet die Spalte neu aus und bewirkt, dass eine Paint-Nachricht an das Steuerelement gesendet wird. (Geerbt von DataGridColumnStyle)
Paint(Graphics, Rectangle, CurrencyManager, Int32, Boolean)	Veraltet. Zeichnet eine DataGridColumnStyle mit der angegebenen Graphics, , Rectangle, CurrencyManager, Zeilennummer und Ausrichtung.
Paint(Graphics, Rectangle, CurrencyManager, Int32, Brush, Brush, Boolean)	Veraltet. Zeichnet eine DataGridColumnStyle mit der angegebenen Graphics, , Rectangle, CurrencyManagerZeilennummer, Hintergrundfarbe, Vordergrundfarbe und Ausrichtung. (Geerbt von DataGridColumnStyle)
Paint(Graphics, Rectangle, CurrencyManager, Int32)	Veraltet. Zeichnet die a DataGridColumnStyle mit der angegebenen Graphics, Rectangle, , CurrencyManager, und Zeilennummer.
PaintText(Graphics, Rectangle, String, Boolean)	Veraltet. Zeichnet den Text und das Rechteck an der angegebenen Position mit der angegebenen Ausrichtung.
PaintText(Graphics, Rectangle, String, Brush, Brush, Boolean)	Veraltet. Zeichnet den Text und das Rechteck an der angegebenen Position mit den angegebenen Farben und ausrichtungen.
ReleaseHostedControl()	Veraltet. Ermöglicht der Spalte das Freigeben von Ressourcen, wenn das Steuerelement, auf dem es gehostet wird, nicht benötigt wird. (Geerbt von DataGridColumnStyle)
ResetHeaderText()	Veraltet. Setzt den HeaderText Standardwert zurück. null (Geerbt von DataGridColumnStyle)
SetColumnValueAtRow(CurrencyManager, Int32, Object)	Veraltet. Legt den Wert in einer angegebenen Zeile mit dem Wert eines angegebenen Werts fest CurrencyManager. (Geerbt von DataGridColumnStyle)
SetDataGrid(DataGrid)	Veraltet. Legt das DataGrid Steuerelement fest, zu dem diese Spalte gehört. (Geerbt von DataGridColumnStyle)
SetDataGridInColumn(DataGrid)	Veraltet. Legt den DataGrid Wert für die Spalte fest. (Geerbt von DataGridColumnStyle)
UpdateUI(CurrencyManager, Int32, String)	Veraltet. Aktualisiert den Wert einer angegebenen Zeile mit dem angegebenen Text. (Geerbt von DataGridColumnStyle)

Ereignisse

Name	Beschreibung
AlignmentChanged	Veraltet. Tritt auf, wenn sich der Alignment Eigenschaftswert ändert. (Geerbt von DataGridColumnStyle)
FontChanged	Veraltet. Tritt auf, wenn sich die Schriftart der Spalte ändert. (Geerbt von DataGridColumnStyle)
HeaderTextChanged	Veraltet. Tritt auf, wenn sich der HeaderText Eigenschaftswert ändert. (Geerbt von DataGridColumnStyle)
MappingNameChanged	Veraltet. Tritt auf, wenn sich der MappingName Wert ändert. (Geerbt von DataGridColumnStyle)
NullTextChanged	Veraltet. Tritt auf, wenn sich der NullText Wert ändert. (Geerbt von DataGridColumnStyle)
PropertyDescriptorChanged	Veraltet. Tritt auf, wenn sich der PropertyDescriptor Eigenschaftswert ändert. (Geerbt von DataGridColumnStyle)
ReadOnlyChanged	Veraltet. Tritt auf, wenn sich der ReadOnly Eigenschaftswert ändert. (Geerbt von DataGridColumnStyle)
WidthChanged	Veraltet. Tritt auf, wenn sich der Width Eigenschaftswert ändert. (Geerbt von DataGridColumnStyle)

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IDataGridColumnStyleEditingNotificationService.ColumnStartedEditing(Control)	Veraltet. Informiert das DataGrid Steuerelement, dass der Benutzer mit der Bearbeitung der Spalte begonnen hat. (Geerbt von DataGridColumnStyle)

Weitere Informationen

• DataGridBoolColumn
• DataGridColumnStyle
• DataColumn
• DataType
• DataGrid
• DataGridTextBox
• TextBox