Udostępnij za pośrednictwem


DataColumn Klasa

Definicja

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

Przykłady

Poniższy przykład tworzy obiekt z kilkoma DataTableDataColumn 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 ConstraintCollectionDataTable 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 truewartość . 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)

Metody rozszerzania

GetKeyedService<T>(IServiceProvider, Object)

Pobiera usługę typu T z elementu IServiceProvider.

GetKeyedServices(IServiceProvider, Type, Object)

Pobiera wyliczenie usług typu serviceType z klasy IServiceProvider.

GetKeyedServices<T>(IServiceProvider, Object)

Pobiera wyliczenie usług typu T z klasy IServiceProvider.

GetRequiredKeyedService(IServiceProvider, Type, Object)

Pobiera usługę typu serviceType z elementu IServiceProvider.

GetRequiredKeyedService<T>(IServiceProvider, Object)

Pobiera usługę typu T z elementu IServiceProvider.

CreateAsyncScope(IServiceProvider)

Tworzy nową AsyncServiceScope , która może służyć do rozwiązywania problemów z usługami o określonym zakresie.

CreateScope(IServiceProvider)

Tworzy nową IServiceScope , która może służyć do rozwiązywania problemów z usługami o określonym zakresie.

GetRequiredService(IServiceProvider, Type)

Pobierz usługę typu serviceType z elementu IServiceProvider.

GetRequiredService<T>(IServiceProvider)

Pobierz usługę typu T z elementu IServiceProvider.

GetService<T>(IServiceProvider)

Pobierz usługę typu T z elementu IServiceProvider.

GetServices(IServiceProvider, Type)

Pobierz wyliczenie usług typu serviceType z klasy IServiceProvider.

GetServices<T>(IServiceProvider)

Pobierz wyliczenie usług typu T z klasy IServiceProvider.

GetFakeLogCollector(IServiceProvider)

Pobiera obiekt zbierający rekordy dziennika wysyłane do fałszywego rejestratora.

GetFakeRedactionCollector(IServiceProvider)

Pobiera fałszywe wystąpienie modułu zbierającego redactor z kontenera wstrzykiwania zależności.

Dotyczy

Bezpieczeństwo wątkowe

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

Zobacz też