DataColumn Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Data

Zestaw:: System.Data.Common.dll

Zestaw:: System.Data.dll

Zestaw:: netstandard.dll

Źródło:: DataColumn.cs

Źródło:: DataColumn.cs

Źródło:: DataColumn.cs

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Reprezentuje schemat kolumny w obiekcie DataTable.

public ref class DataColumn : System::ComponentModel::MarshalByValueComponent

public class DataColumn : System.ComponentModel.MarshalByValueComponent

type DataColumn = class
    inherit MarshalByValueComponent

Public Class DataColumn
Inherits MarshalByValueComponent

Dziedziczenie: Object

MarshalByValueComponent
DataColumn

Przykłady

Poniższy przykład tworzy obiekt z kilkoma DataTable DataColumn obiektami.

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

Uwagi

Jest DataColumn to podstawowy blok konstrukcyjny do tworzenia schematu elementu DataTable. Schemat jest kompilowany przez dodanie co najmniej jednego DataColumn obiektu do obiektu DataColumnCollection. Aby uzyskać więcej informacji, zobacz Dodawanie kolumn do tabeli danych.

Każda z nich DataColumn ma DataType właściwość określającą rodzaj danych DataColumn , które zawierają. Można na przykład ograniczyć typ danych do liczb całkowitych lub ciągów lub znaków dziesiętnych. Ponieważ dane zawarte w obiekcie DataTable są zwykle scalane z powrotem do oryginalnego źródła danych, należy dopasować typy danych do tych w źródle danych. Aby uzyskać więcej informacji, zobacz Mapowania typów danych w ADO.NET.

Właściwości takie jak AllowDBNull, Uniquei ReadOnly nakładają ograniczenia dotyczące wprowadzania i aktualizowania danych, co pomaga zagwarantować integralność danych. Można również użyć właściwości , AutoIncrementSeedi AutoIncrementStep do kontrolowania AutoIncrementautomatycznego generowania danych. Aby uzyskać więcej informacji na temat AutoIncrement kolumn, zobacz Tworzenie kolumn autoinkrementu. Aby uzyskać więcej informacji, zobacz Definiowanie kluczy podstawowych.

Możesz również upewnić się, że wartości w obiekcie DataColumn są unikatowe, tworząc element UniqueConstraint i dodając go do ConstraintCollection DataTable elementu, do którego DataColumn należy. Aby uzyskać więcej informacji, zobacz Ograniczenia tabeli danych.

Aby utworzyć relację między obiektami DataColumn , utwórz DataRelation obiekt i dodaj go do DataRelationCollection obiektu DataSet.

Możesz użyć Expression właściwości DataColumn obiektu, aby obliczyć wartości w kolumnie lub utworzyć kolumnę zagregowaną. Aby uzyskać więcej informacji, zobacz Tworzenie kolumn wyrażeń.

Konstruktory

DataColumn()	Inicjuje DataColumn nowe wystąpienie klasy jako ciąg typu.
DataColumn(String)	Inicjuje DataColumn nowe wystąpienie klasy jako ciąg typu przy użyciu określonej nazwy kolumny.
DataColumn(String, Type)	Inicjuje DataColumn nowe wystąpienie klasy przy użyciu określonej nazwy kolumny i typu danych.
DataColumn(String, Type, String)	Inicjuje DataColumn nowe wystąpienie klasy przy użyciu określonej nazwy, typu danych i wyrażenia.
DataColumn(String, Type, String, MappingType)	Inicjuje DataColumn nowe wystąpienie klasy przy użyciu określonej nazwy, typu danych, wyrażenia i wartości, która określa, czy kolumna jest atrybutem.

Właściwości

AllowDBNull	Pobiera lub ustawia wartość wskazującą, czy wartości null są dozwolone w tej kolumnie dla wierszy należących do tabeli.
AutoIncrement	Pobiera lub ustawia wartość wskazującą, czy kolumna automatycznie zwiększa wartość kolumny dla nowych wierszy dodanych do tabeli.
AutoIncrementSeed	Pobiera lub ustawia wartość początkową dla kolumny, która ma właściwość AutoIncrement ustawioną na `true`wartość . Wartość domyślna to 0.
AutoIncrementStep	Pobiera lub ustawia przyrost używany przez kolumnę z jej AutoIncrement właściwością ustawioną na `true`.
Caption	Pobiera lub ustawia podpis dla kolumny.
ColumnMapping	Pobiera lub ustawia MappingType kolumnę.
ColumnName	Pobiera lub ustawia nazwę kolumny w elemecie DataColumnCollection.
Container	Pobiera kontener dla składnika. (Odziedziczone po MarshalByValueComponent)
DataType	Pobiera lub ustawia typ danych przechowywanych w kolumnie.
DateTimeMode	Pobiera lub ustawia `DateTimeMode` wartość dla kolumny.
DefaultValue	Pobiera lub ustawia wartość domyślną kolumny podczas tworzenia nowych wierszy.
DesignMode	Pobiera wartość wskazującą, czy składnik jest obecnie w trybie projektowania. (Odziedziczone po MarshalByValueComponent)
Events	Pobiera listę programów obsługi zdarzeń dołączonych do tego składnika. (Odziedziczone po MarshalByValueComponent)
Expression	Pobiera lub ustawia wyrażenie używane do filtrowania wierszy, obliczenie wartości w kolumnie lub utworzenie kolumny agregującej.
ExtendedProperties	Pobiera kolekcję niestandardowych informacji o użytkowniku skojarzonych z elementem DataColumn.
MaxLength	Pobiera lub ustawia maksymalną długość kolumny tekstowej.
Namespace	Pobiera lub ustawia przestrzeń nazw elementu DataColumn.
Ordinal	Pobiera pozycję (opartą na zerowej) kolumnie w kolekcji DataColumnCollection .
Prefix	Pobiera lub ustawia prefiks XML, który aliasuje przestrzeń nazw elementu DataTable.
ReadOnly	Pobiera lub ustawia wartość wskazującą, czy kolumna zezwala na zmiany zaraz po dodaniu wiersza do tabeli.
Site	Pobiera lub ustawia lokację składnika. (Odziedziczone po MarshalByValueComponent)
Table	Pobiera element DataTable , do którego należy kolumna.
Unique	Pobiera lub ustawia wartość wskazującą, czy wartości w każdym wierszu kolumny muszą być unikatowe.

Metody

CheckNotAllowNull()	Ten element członkowski obsługuje infrastrukturę platformy .NET i nie jest przeznaczony do użycia bezpośrednio z kodu.
CheckUnique()	Ten element członkowski obsługuje infrastrukturę platformy .NET i nie jest przeznaczony do użycia bezpośrednio z kodu.
Dispose()	Zwalnia wszelkie zasoby używane przez element MarshalByValueComponent. (Odziedziczone po MarshalByValueComponent)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element MarshalByValueComponent i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po MarshalByValueComponent)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetService(Type)	Pobiera implementator obiektu IServiceProvider. (Odziedziczone po MarshalByValueComponent)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnPropertyChanging(PropertyChangedEventArgs)	Ten element członkowski obsługuje infrastrukturę platformy .NET i nie jest przeznaczony do użycia bezpośrednio z kodu.
RaisePropertyChanging(String)	Ten element członkowski obsługuje infrastrukturę platformy .NET i nie jest przeznaczony do użycia bezpośrednio z kodu.
SetOrdinal(Int32)	Zmienia położenie DataColumn porządkowe lub porządkowe określonego lub porządkowego.
ToString()	Expression Pobiera kolumnę, jeśli istnieje.

Zdarzenia

Disposed

Dodaje procedurę obsługi zdarzeń do nasłuchiwania Disposed zdarzenia w składniku.

(Odziedziczone po MarshalByValueComponent)

Dotyczy

Bezpieczeństwo wątkowe

Ten typ jest bezpieczny dla operacji odczytu wielowątkowego. Należy zsynchronizować wszystkie operacje zapisu.