DataColumn Klasse

Definition

Stellt das Schema einer Spalte in einer Datentabelle (DataTable) dar.Represents the schema of a column in a DataTable.

public ref class DataColumn : System::ComponentModel::MarshalByValueComponent
public class DataColumn : System.ComponentModel.MarshalByValueComponent
type DataColumn = class
    inherit MarshalByValueComponent
Public Class DataColumn
Inherits MarshalByValueComponent
Vererbung

Beispiele

Im folgenden Beispiel wird ein DataTable mit mehreren DataColumn -Objekten erstellt.The following example creates a DataTable with several DataColumn objects.

private void MakeTable()
{ 
    // Create a DataTable. 
    DataTable table = new DataTable("Product");

    // Create a DataColumn and set various properties. 
    DataColumn column = new DataColumn(); 
    column.DataType = System.Type.GetType("System.Decimal"); 
    column.AllowDBNull = false; 
    column.Caption = "Price"; 
    column.ColumnName = "Price"; 
    column.DefaultValue = 25; 

    // Add the column to the table. 
    table.Columns.Add(column); 

    // Add 10 rows and set values. 
    DataRow row; 
    for(int i = 0; i < 10; i++)
    { 
        row = table.NewRow(); 
        row["Price"] = i + 1; 

        // Be sure to add the new row to the 
        // DataRowCollection. 
        table.Rows.Add(row); 
    } 
}
Private Sub MakeTable()
    ' Create a DataTable. 
    Dim table As New DataTable("Product")

    ' Create a DataColumn and set various properties. 
    Dim column As New DataColumn()
    column.DataType = System.Type.GetType("System.Decimal") 
    column.AllowDBNull = False 
    column.Caption = "Price"  
    column.ColumnName = "Price" 
    column.DefaultValue = 25 

    ' Add the column to the table. 
    table.Columns.Add(column) 

    ' Add 10 rows and set values. 
    Dim row As DataRow 
    Dim i As Integer  
    For i = 0 to 9 
        row = table.NewRow() 
        row("Price") = i + 1 

        ' Be sure to add the new row to 
        ' the DataRowCollection. 
        table.Rows.Add(row) 
    Next i 
End Sub

Hinweise

Der DataColumn ist der grundlegende Baustein zum Erstellen des Schemas einer DataTable.The DataColumn is the fundamental building block for creating the schema of a DataTable. Sie erstellen das Schema DataColumn DataColumnCollection, indem Sie ein oder mehrere-Objekte hinzufügen.You build the schema by adding one or more DataColumn objects to the DataColumnCollection. Weitere Informationen finden Sie unter Hinzufügen von Spalten zu einer DatenTabelle.For more information, see Adding Columns to a DataTable.

Jede DataColumn verfügt über DataType eine-Eigenschaft, die DataColumn die Art der in enthaltenen Daten bestimmt.Each DataColumn has a DataType property that determines the kind of data the DataColumn contains. Beispielsweise können Sie den Datentyp auf ganze Zahlen, Zeichen folgen oder Dezimalzahlen beschränken.For example, you can restrict the data type to integers, or strings, or decimals. Da in enthaltene DataTable Daten in der Regel wieder in die ursprüngliche Datenquelle zusammengeführt werden, müssen Sie die Datentypen mit den Datentypen in der Datenquelle vergleichen.Because data that is contained by the DataTable is typically merged back into its original data source, you must match the data types to those in the data source. Weitere Informationen finden Sie unter Datentyp Zuordnungen in ADO.net.For more information, see Data Type Mappings in ADO.NET.

Eigenschaften wie AllowDBNull, Uniqueund ReadOnly setzen Einschränkungen für den Eintrag und die Aktualisierung von Daten ein, um die Datenintegrität zu gewährleisten.Properties such as AllowDBNull, Unique, and ReadOnly put restrictions on the entry and updating of data, thereby helping to guarantee data integrity. Sie können auch die Eigenschaften AutoIncrement, AutoIncrementSeedund AutoIncrementStep verwenden, um die automatische Datengenerierung zu steuern.You can also use the AutoIncrement, AutoIncrementSeed, and AutoIncrementStep properties to control automatic data generation. Weitere Informationen zu AutoIncrement Spalten finden Sie unter Erstellen von AutoIncrement-Spalten.For more information about AutoIncrement columns, see Creating AutoIncrement Columns. Weitere Informationen finden Sie unter Definieren von primär Schlüsseln.For more information, see Defining Primary Keys.

Sie können auch sicherstellen, dass die Werte DataColumn in einem eindeutig sind, UniqueConstraint indem Sie einen erstellen und ConstraintCollection DataTable ihn dem des hinzufügen DataColumn , zu dem gehört.You can also make sure that values in a DataColumn are unique by creating a UniqueConstraint and adding it to the ConstraintCollection of the DataTable to which the DataColumn belongs. Weitere Informationen finden Sie unter databel-Einschränkungen.For more information, see DataTable Constraints.

Um DataColumn eine Beziehung zwischen Objekten zu erstellen, erstellen DataRelation DataSetSie ein-Objekt, und DataRelationCollection fügen Sie es dem eines hinzu.To create a relation between DataColumn objects, create a DataRelation object and add it to the DataRelationCollection of a DataSet.

Sie können die- Expression Eigenschaft DataColumn des-Objekts verwenden, um die Werte in einer Spalte zu berechnen, oder eine Aggregat Spalte erstellen.You can use the Expression property of the DataColumn object to calculate the values in a column, or create an aggregate column. Weitere Informationen finden Sie unter Erstellen von Ausdrucks Spalten.For more information, see Creating Expression Columns.

Konstruktoren

DataColumn()

Initialisiert eine neue Instanz einer DataColumn-Klasse als type-Zeichenfolge.Initializes a new instance of a DataColumn class as type string.

DataColumn(String)

Initialisiert eine neue Instanz der DataColumn-Klasse als type-Zeichenfolge und unter Verwendung des angegebenen Spaltennamens.Initializes a new instance of the DataColumn class, as type string, using the specified column name.

DataColumn(String, Type)

Initialisiert eine neue Instanz der DataColumn-Klasse unter Verwendung des angegebenen Spaltennamens und Datentyps.Initializes a new instance of the DataColumn class using the specified column name and data type.

DataColumn(String, Type, String)

Initialisiert eine neue Instanz der DataColumn-Klasse unter Verwendung des angegebenen Namens, Datentyps und Ausdrucks.Initializes a new instance of the DataColumn class using the specified name, data type, and expression.

DataColumn(String, Type, String, MappingType)

Initialisiert eine neue Instanz der DataColumn-Klasse unter Verwendung des angegebenen Namens, Datentyps, Ausdrucks und des Werts, der bestimmt, ob es sich bei der Spalte um ein Attribut handelt.Initializes a new instance of the DataColumn class using the specified name, data type, expression, and value that determines whether the column is an attribute.

Eigenschaften

AllowDBNull

Ruft einen Wert ab, der angibt, ob in dieser Spalte für die zur Tabelle gehörenden Zeilen NULL-Werte zulässig sind, oder legt diesen fest.Gets or sets a value that indicates whether null values are allowed in this column for rows that belong to the table.

AutoIncrement

Ruft einen Wert ab, der angibt, ob der Wert der Spalte für neu zur Tabelle hinzugefügte Zeilen in der Spalte automatisch erhöht wird, oder legt diesen fest.Gets or sets a value that indicates whether the column automatically increments the value of the column for new rows added to the table.

AutoIncrementSeed

Ruft den Anfangswert für eine Spalte ab, deren AutoIncrement-Eigenschaft auf true festgelegt ist, oder legt diesen fest.Gets or sets the starting value for a column that has its AutoIncrement property set to true. Der Standard ist 0.The default is 0.

AutoIncrementStep

Ruft die Schrittweite ab, die von einer Spalte verwendet wird, deren AutoIncrement-Eigenschaft auf true festgelegt ist, oder legt diese fest.Gets or sets the increment used by a column with its AutoIncrement property set to true.

Caption

Ruft die Beschriftung für die Spalte ab, oder legt diese fest.Gets or sets the caption for the column.

ColumnMapping

Ruft den MappingType der Spalte ab oder legt diesen fest.Gets or sets the MappingType of the column.

ColumnName

Ruft den Namen der Spalte in der DataColumnCollection ab oder legt diesen fest.Gets or sets the name of the column in the DataColumnCollection.

Container

Ruft den Container für die Komponente ab.Gets the container for the component.

(Geerbt von MarshalByValueComponent)
DataType

Ruft den Typ der in der Spalte gespeicherten Daten ab oder legt diesen fest.Gets or sets the type of data stored in the column.

DateTimeMode

Ruft den DateTimeMode für die Spalte ab oder legt diesen fest.Gets or sets the DateTimeMode for the column.

DefaultValue

Ruft beim Erstellen neuer Zeilen den Standardwert für die Spalte ab oder legt diesen fest.Gets or sets the default value for the column when you are creating new rows.

DesignMode

Ruft einen Wert ab, der angibt, ob sich die Komponente gegenwärtig im Entwurfsmodus befindet.Gets a value indicating whether the component is currently in design mode.

(Geerbt von MarshalByValueComponent)
Events

Ruft die Liste der an diese Komponente angefügten Ereignishandler ab.Gets the list of event handlers that are attached to this component.

(Geerbt von MarshalByValueComponent)
Expression

Ruft den Ausdruck ab, mit dem Zeilen gefiltert, die Werte in einer Spalte berechnet oder eine Aggregatspalte erstellt werden, oder legt diesen fest.Gets or sets the expression used to filter rows, calculate the values in a column, or create an aggregate column.

ExtendedProperties

Ruft die Auflistung der benutzerdefinierten Benutzerinformationen ab, die einer DataColumn zugeordnet ist.Gets the collection of custom user information associated with a DataColumn.

MaxLength

Ruft die maximale Länge einer Textspalte ab oder legt diese fest.Gets or sets the maximum length of a text column.

Namespace

Ruft den Namespace der DataColumn ab oder legt diesen fest.Gets or sets the namespace of the DataColumn.

Ordinal

Ruft die nullbasierte Position der Spalte in der DataColumnCollection Auflistung ab.Gets the (zero-based) position of the column in the DataColumnCollection collection.

Prefix

Ruft ein XML-Präfix ab, das als Alias für den Namespace der DataTable fungiert, oder legt dieses fest.Gets or sets an XML prefix that aliases the namespace of the DataTable.

ReadOnly

Ruft einen Wert ab, der angibt, ob die Spalte nach dem Hinzufügen einer Zeile zur Tabelle Änderungen zulässt, oder legt diesen fest.Gets or sets a value that indicates whether the column allows for changes as soon as a row has been added to the table.

Site

Ruft die Site der Komponente ab oder legt diese fest.Gets or sets the site of the component.

(Geerbt von MarshalByValueComponent)
Table

Ruft die DataTable ab, zu der die Spalte gehört.Gets the DataTable to which the column belongs to.

Unique

Ruft einen Wert ab, der angibt, ob die Werte in allen Zeilen der Spalte eindeutig sein müssen, oder legt diesen fest.Gets or sets a value that indicates whether the values in each row of the column must be unique.

Methoden

CheckNotAllowNull()

Dieser Member unterstützt die .NET Framework-Infrastruktur und ist nicht für die direkte Verwendung in Code vorgesehen.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

CheckUnique()

Dieser Member unterstützt die .NET Framework-Infrastruktur und ist nicht für die direkte Verwendung in Code vorgesehen.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

Dispose()

Gibt alle vom MarshalByValueComponent verwendeten Ressourcen frei.Releases all resources used by the MarshalByValueComponent.

(Geerbt von MarshalByValueComponent)
Dispose(Boolean)

Gibt die von MarshalByValueComponent verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the MarshalByValueComponent and optionally releases the managed resources.

(Geerbt von MarshalByValueComponent)
Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetService(Type)

Ruft die Implementierung von IServiceProvider ab.Gets the implementer of the IServiceProvider.

(Geerbt von MarshalByValueComponent)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
OnPropertyChanging(PropertyChangedEventArgs)

Dieser Member unterstützt die .NET Framework-Infrastruktur und ist nicht für die direkte Verwendung in Code vorgesehen.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

RaisePropertyChanging(String)

Dieser Member unterstützt die .NET Framework-Infrastruktur und ist nicht für die direkte Verwendung in Code vorgesehen.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

SetOrdinal(Int32)

Ändert die Ordnungszahl oder Position der DataColumn in die angegebene Ordnungszahl oder Position.Changes the ordinal or position of the DataColumn to the specified ordinal or position.

ToString()

Ruft den Expression der Spalte ab, sofern ein solcher vorhanden ist.Gets the Expression of the column, if one exists.

Ereignisse

Disposed

Fügt einen Ereignishandler hinzu, der das Disposed-Ereignis für die Komponente überwacht.Adds an event handler to listen to the Disposed event on the component.

(Geerbt von MarshalByValueComponent)

Gilt für:

Threadsicherheit

Dieser Typ ist für multithreadlesevorgänge sicher.This type is safe for multithreaded read operations. Sie müssen alle Schreibvorgänge synchronisieren.You must synchronize any write operations.

Siehe auch