DataColumn Constructors
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Initialiseert een nieuw exemplaar van de DataColumn klasse.
Overloads
| Name | Description |
|---|---|
| DataColumn() |
Initialiseert een nieuw exemplaar van de DataColumn klasse als typetekenreeks. |
| DataColumn(String) |
Initialiseert een nieuw exemplaar van de DataColumn klasse, als typetekenreeks, met behulp van de opgegeven kolomnaam. |
| DataColumn(String, Type) |
Initialiseert een nieuw exemplaar van de DataColumn klasse met behulp van de opgegeven kolomnaam en het opgegeven gegevenstype. |
| DataColumn(String, Type, String) |
Initialiseert een nieuw exemplaar van de DataColumn klasse met behulp van de opgegeven naam, het gegevenstype en de expressie. |
| DataColumn(String, Type, String, MappingType) |
Initialiseert een nieuw exemplaar van de DataColumn klasse met behulp van de opgegeven naam, het gegevenstype, de expressie en de waarde die bepaalt of de kolom een kenmerk is. |
DataColumn()
Initialiseert een nieuw exemplaar van de DataColumn klasse als typetekenreeks.
public:
DataColumn();
public DataColumn();
Public Sub New ()
Voorbeelden
In het volgende voorbeeld wordt een nieuwe DataColumngemaakt, worden verschillende eigenschappen ingesteld en toegevoegd aan een DataColumnCollection voor het DataTable object.
private void AddDataColumn(DataTable table)
{
DataColumn column = new DataColumn();
// Set various properties.
column.ColumnName = "id";
column.DataType = System.Type.GetType("System.Int32");
column.AutoIncrement = true;
column.AutoIncrementSeed = 1;
column.AutoIncrementStep = 1;
column.ReadOnly = true;
// Add to Columns collection.
table.Columns.Add(column);
}
Private Sub AddDataColumn(ByVal table As DataTable)
Dim column As New DataColumn()
' Set various properties.
With column
.ColumnName = "id"
.DataType = System.Type.GetType("System.Int32")
.AutoIncrement = True
.AutoIncrementSeed = 1
.AutoIncrementStep = 1
.ReadOnly = True
End With
' Add to Columns collection.
table.Columns.Add(column)
End Sub
Opmerkingen
Bij het maken heeft een DataColumn object geen standaardwaarde ColumnName of Caption. Wanneer u deze toevoegt aan een DataColumnCollection, wordt er een standaardnaam ('Kolom1', 'Kolom2' enzovoort) gegenereerd als er geen naam is toegewezen aan de ColumnName.
Zie ook
Van toepassing op
DataColumn(String)
Initialiseert een nieuw exemplaar van de DataColumn klasse, als typetekenreeks, met behulp van de opgegeven kolomnaam.
public:
DataColumn(System::String ^ columnName);
public DataColumn(string columnName);
new System.Data.DataColumn : string -> System.Data.DataColumn
Public Sub New (columnName As String)
Parameters
- columnName
- String
Een tekenreeks die de naam van de kolom vertegenwoordigt die moet worden gemaakt. Als deze is ingesteld op null of een lege tekenreeks (""), wordt een standaardnaam opgegeven wanneer deze wordt toegevoegd aan de verzameling kolommen.
Voorbeelden
In het volgende voorbeeld wordt een nieuwe DataColumn gemaakt met een opgegeven ColumnName.
private void AddDataColumn(DataTable table)
{
DataColumn column = new DataColumn("id");
// Set various properties.
column.DataType = System.Type.GetType("System.Int32");
column.AutoIncrement = true;
column.AutoIncrementSeed = 1;
column.AutoIncrementStep = 1;
column.ReadOnly = true;
// Add to Columns collection.
table.Columns.Add(column);
}
Private Sub AddDataColumn(ByVal table As DataTable)
Dim column As DataColumn
column = New DataColumn("id")
' Set various properties.
With column
.DataType = System.Type.GetType("System.Int32")
.AutoIncrement = True
.AutoIncrementSeed = 1
.AutoIncrementStep = 1
.ReadOnly = True
End With
' Add to Columns collection.
table.Columns.Add(column)
End Sub
Opmerkingen
De naam die specifiek is voor een kolom, wordt standaard de Caption eigenschapswaarde.
Zie ook
Van toepassing op
DataColumn(String, Type)
Initialiseert een nieuw exemplaar van de DataColumn klasse met behulp van de opgegeven kolomnaam en het opgegeven gegevenstype.
public:
DataColumn(System::String ^ columnName, Type ^ dataType);
public DataColumn(string columnName, Type dataType);
new System.Data.DataColumn : string * Type -> System.Data.DataColumn
Public Sub New (columnName As String, dataType As Type)
Parameters
- columnName
- String
Een tekenreeks die de naam van de kolom vertegenwoordigt die moet worden gemaakt. Als deze is ingesteld op null of een lege tekenreeks (""), wordt een standaardnaam opgegeven wanneer deze wordt toegevoegd aan de verzameling kolommen.
Uitzonderingen
Nee dataType is opgegeven.
Voorbeelden
In het volgende voorbeeld wordt een nieuwe DataColumn gemaakt met een opgegeven ColumnName en DataType.
private void AddDataColumn(DataTable table)
{
System.Type typeInt32 =
System.Type.GetType("System.Int32");
DataColumn column = new DataColumn("id", typeInt32);
// Set various properties.
column.AutoIncrement = true;
column.AutoIncrementSeed = 1;
column.AutoIncrementStep = 1;
column.ReadOnly = true;
// Add to Columns collection.
table.Columns.Add(column);
}
Private Sub AddDataColumn(ByVal table As DataTable)
Dim typeInt32 As System.Type = _
System.Type.GetType("System.Int32")
Dim column As DataColumn = _
New DataColumn("id", typeInt32)
' Set various properties.
With column
.AutoIncrement = True
.AutoIncrementSeed = 1
.AutoIncrementStep = 1
.ReadOnly = True
End With
' Add to Columns collection.
table.Columns.Add(column)
End Sub
Zie ook
Van toepassing op
DataColumn(String, Type, String)
Initialiseert een nieuw exemplaar van de DataColumn klasse met behulp van de opgegeven naam, het gegevenstype en de expressie.
public:
DataColumn(System::String ^ columnName, Type ^ dataType, System::String ^ expr);
public DataColumn(string columnName, Type dataType, string expr);
new System.Data.DataColumn : string * Type * string -> System.Data.DataColumn
Public Sub New (columnName As String, dataType As Type, expr As String)
Parameters
- columnName
- String
Een tekenreeks die de naam van de kolom vertegenwoordigt die moet worden gemaakt. Als deze is ingesteld op null of een lege tekenreeks (""), wordt een standaardnaam opgegeven wanneer deze wordt toegevoegd aan de verzameling kolommen.
- expr
- String
De expressie die wordt gebruikt om deze kolom te maken. Voor meer informatie, zie de eigenschap Expression.
Uitzonderingen
Nee dataType is opgegeven.
Voorbeelden
In het volgende voorbeeld wordt een berekende kolom gemaakt.
private void AddDataColumn(DataTable table)
{
System.Type decimalType;
decimalType = System.Type.GetType("System.Decimal");
// Create the column. The name is 'Tax,' with data type Decimal,and
// an expression ('UnitPrice * .0862) to calculate the tax.
DataColumn column = new DataColumn("Tax",
decimalType, "UnitPrice * .0862");
// Set various properties.
column.AutoIncrement = false;
column.ReadOnly = true;
// Add to Columns collection.;
table.Columns.Add(column);
}
Private Sub AddDataColumn(ByVal table As DataTable)
Dim column As DataColumn
Dim decimalType As System.Type
decimalType = System.Type.GetType("System.Decimal")
column = New DataColumn("Tax", decimalType, "UnitPrice * .0862")
' Set various properties.
With column
.AutoIncrement = False
.ReadOnly = True
End With
' Add to Columns collection.
table.Columns.Add(column)
End Sub
Zie ook
Van toepassing op
DataColumn(String, Type, String, MappingType)
Initialiseert een nieuw exemplaar van de DataColumn klasse met behulp van de opgegeven naam, het gegevenstype, de expressie en de waarde die bepaalt of de kolom een kenmerk is.
public:
DataColumn(System::String ^ columnName, Type ^ dataType, System::String ^ expr, System::Data::MappingType type);
public DataColumn(string columnName, Type dataType, string expr, System.Data.MappingType type);
new System.Data.DataColumn : string * Type * string * System.Data.MappingType -> System.Data.DataColumn
Public Sub New (columnName As String, dataType As Type, expr As String, type As MappingType)
Parameters
- columnName
- String
Een tekenreeks die de naam van de kolom vertegenwoordigt die moet worden gemaakt. Als deze is ingesteld op null of een lege tekenreeks (""), wordt een standaardnaam opgegeven wanneer deze wordt toegevoegd aan de verzameling kolommen.
- expr
- String
De expressie die wordt gebruikt om deze kolom te maken. Voor meer informatie, zie de eigenschap Expression.
- type
- MappingType
Een van de MappingType waarden.
Uitzonderingen
Nee dataType is opgegeven.
Voorbeelden
In het volgende voorbeeld wordt een berekende kolom samengesteld.
private void CreateComputedColumn(DataTable table)
{
System.Type myDataType =
System.Type.GetType("System.Decimal");
// The expression multiplies the "Price" column value
// by the "Quantity" to create the "Total" column.
string expression = "Price * Quantity";
// Create the column, setting the type to Attribute.
DataColumn column = new DataColumn("Total", myDataType,
expression, MappingType.Attribute);
// Set various properties.
column.AutoIncrement = false;
column.ReadOnly = true;
// Add the column to a DataTable object's to DataColumnCollection.
DataSet1.Tables["OrderDetails"].Columns.Add(column);
}
Private Sub CreateComputedColumn(ByVal table As DataTable)
Dim column As DataColumn
Dim decimalType As System.Type = _
System.Type.GetType("System.Decimal")
' The expression multiplies the "Price" column value by the
' "Quantity" to create the "Total" column.
Dim expression As String = "Price * Quantity"
' Create the column, setting the type to Attribute.
column = New DataColumn("Total", decimalType, _
expression, MappingType.Attribute)
' Set various properties.
column.AutoIncrement = False
column.ReadOnly = True
' Add the column to a DataTable object's DataColumnCollection.
DataSet1.Tables("OrderDetails").Columns.Add(column)
End Sub
Opmerkingen
Met type het argument wordt de ColumnMapping eigenschap ingesteld. De eigenschap geeft aan hoe een DataColumn toewijzing wordt toegewezen wanneer een DataSet wordt omgezet in een XML-document. Als de kolom bijvoorbeeld de naam 'fName' heeft en de waarde die deze bevat 'Bob' is en type is ingesteld MappingType.Attributeop, is het XML-element als volgt:
<Naam fName = 'Bob'/>
Zie de ColumnMapping eigenschap voor meer informatie over hoe kolommen worden toegewezen aan elementen of kenmerken.