Porady: dodawanie kolumn do DataTable

Tworzenie pojedynczych kolumn (DataColumn), które tworzą tabele danych (DataTable) przez dodanie ich do DataColumnCollection dla tabeli danych.Można dodać kolumny do tabel danych wizualnie przy pomocy Projektanta obiektów Dataset, lub jednego z kreatorów danych.Aby uzyskać więcej informacji dotyczących sposobu dodawania kolumn danych do tabel danych programowo, zobacz Adding Columns to a DataTable.

Po dodaniu kolumny, można skonfigurować je zgodnie ze swoimi wymaganiami.Na przykład można określić wartość domyślną lub ograniczenie unikatowości dla kolumny.Można również określić, czy kolumna powinna wyświetlić obliczone wartości, zamiast wartości odczytywanych bezpośrednio z bazy danych.

[!UWAGA]

Polecenia menu i okien dialogowych mogą różnić się od tych opisanych w Pomocy, w zależności od ustawień aktywnych lub wydania.Aby zmienić swoje ustawienia, wybierz Importuj i eksportuj ustawienia w menu Narzędzia.Aby uzyskać więcej informacji, zobacz Dostosowywanie ustawień środowiska deweloperskiego w Visual Studio.

Typowe zadania

Dodawanie kolumn do tabeli danych

Przed rozpoczęciem konfigurowania elementu DataColumn, należy najpierw dodać go do elementu DataTable.Można to zrobić za pomocą jednej z poniższych procedur.

Aby dodać kolumnę do tabeli DataTable przy użyciu Projektanta obiektów Dataset.

1. Otwórz zestaw danych w Projektancie obiektów Dataset.Aby uzyskać więcej informacji, zobacz Porady: otwieranie zestawu w narzędziu Projektant obiektów Dataset.

2. Kliknij prawym przyciskiem myszy element DataTable, aby dodać kolumnę.Wskaż Dodaj, a następnie kliknij przycisk Kolumna.

3. Jeżeli to konieczne zamień domyślną nazwę kolumny wybierając nazwę kolumny w tabeli danych i edytuj tekst.

4. Ustaw właściwości DataType w oknie Właściwości,

Aby dodać kolumnę do tabeli DataTable przy użyciu Kreatora konfiguracji źródła danych

1. W oknie Źródła Danych, kliknij prawym przyciskiem myszy Źródło Danych, a następnie kliknij Konfigurowanie DataSet przy użyciu Kreatora.

2. Rozwiń tabelę, w której chcesz dodać kolumnę.

3. Wybierz kolumny do dodania do tabeli.

4. Kliknij Zakończ.

Aby dodać kolumnę do tabeli DataTable przy użyciu Kreatora konfiguracji TableAdapter.

1. Otwórz zestaw danych w Projektancie obiektów Dataset.Aby uzyskać więcej informacji, zobacz Porady: otwieranie zestawu w narzędziu Projektant obiektów Dataset.

2. Kliknij prawym przyciskiem myszy tabelę danych, a następnie kliknij przycisk Konfiguracja.

3. Dodaj kolumnę do instrukcji SELECT.

4. Kliknij Zakończ.

Konfigurowanie elementów DataColumns

Po dodaniu elementu DataColumn, należy określić zachowanie tego elementu DataColumn.Na przykład, można zmienić typ danych lub ograniczyć jego zawartość tylko do unikatowych wartości.Można użyć dowolnej z poniższych procedur do modyfikowania zachowania elementu DataColumn.

• Ustawienie typu danych elementu DataColumn

• Określanie podpisu elementu DataColumn

• Określanie czy element DataColumn zawiera numery generowane automatycznie

• Przypisanie wartości domyślnej do elementu DataColumn

• Ograniczanie elementów DataColumn aby zawierały wartości unikatowe

• Ustawianie elementu DataColumn jako klucz podstawowy elementu DataTable

• Określanie wartości zwracanej kiedy wartość elementu DataColumn ma wartość null.

Ustawienie typu danych elementu DataColumn

Kolumny danych (DataColumn) są tworzone za pomocą domyślnego typu danych String.Aby zmienić typ danych kolumny, ustaw właściwość DataType w oknie Właściwości.

Aby ustawić typ danych elementu DataColumn

1. Otwórz zestaw danych w Projektancie obiektów Dataset.

2. Wybierz kolumnę, dla której chcesz ustawić typ danych.

3. W oknie Właściwości, wybierz żądane typy danych z listy DataType.

Określanie podpisu elementu DataColumn

Kolumny danych często mają nazwy, które nie nadają się do wyświetlania w interfejsie użytkownika.Można zmienić podpis na bardziej odpowiednią nazwę, ustawiając właściwość Caption w oknie Właściwości.

[!UWAGA]

Szczególną uwagę należy zwrócić podczas przeciągania elementów z okna Źródła danych do formularza aplikacji systemu Windows: nazwy kolumn w etykiecie podpis są formatowane ponownie na ciąg bardziej czytelny, kiedy dwa lub więcej słów okaże się być ze sobą połączone.Aby uzyskać więcej informacji, zobacz Porady: dostosowywanie sposobu tworzenia przez Visual Studio podpisów dla formantów powiązanych z danymi.

Aby dokonać edycji podpisu kolumny danych

1. Otwórz zestaw danych w Projektancie obiektów Dataset.Aby uzyskać więcej informacji, zobacz Porady: otwieranie zestawu w narzędziu Projektant obiektów Dataset.

2. Wybierz kolumnę, której podpis chcesz edytować.

3. W oknie Właściwości, ustaw właściwość Caption.

Określanie czy element DataColumn zawiera numery generowane automatycznie

Kolumny danych (DataColumn) zawierają często automatycznie generowane kolejne liczby, na przykład klucze podstawowe i kolumny Identyfikatora.Można załadować automatyczne generowane liczb w kolumnach danych przez ustawienie właściwości AutoIncrement, AutoIncrementSeed, i AutoIncrementStep kolumny danych.

Podczas tworzenia kolumn danych za pomocą narzędzi projektowania programu Visual Studio, kolumny są automatycznie oznaczane jako AutoIncrement.Podczas aktualizacji tabeli w bazie danych, która zawiera kolumnę tożsamości, wartości utworzone za pomocą funkcji automatycznego numerowania nie są wysyłane do bazy danych.

Aby ustawić kolumnę danych, która zawiera liczby generowane automatycznie

1. Otwórz zestaw danych w Projektancie obiektów Dataset.

2. Wybierz kolumnę, którą chcesz wypełnić liczbami generowanymi automatycznie.

3. W oknie Właściwości, należy ustawić następujące właściwości:

   Właściwość	Ustawienie
   AutoIncrement	true
   AutoIncrementSeed	Jeśli chcesz rozpocząć od innej liczby niż wartość domyślna 0, wartość tę należy ustawić na numer początkowy dla tej kolumny.
   AutoIncrementStep	W każdym nowym wierszu, wartość kolumny jest zwiększana o tę wartość.

   [!UWAGA]

   Ustawienie automatycznego przyrostu do kolumny danych nie wyznacza automatycznie kolumny jako klucz podstawowy.

Przypisanie wartości domyślnej do elementu DataColumn

Kolumnom danych mogą być przypisane wartości domyślne.Wartość domyślna jest przypisywana kolumnie podczas tworzenia nowych wierszy (rekordów).

Aby przypisać domyślną wartość do kolumny danych

1. Otwórz zestaw danych w Projektancie obiektów Dataset.

2. Wybierz kolumnę, do której chcesz przypisać domyślną wartość.

3. W oknie Właściwości, należy ustawić właściwość DefaultValue, aby zażądać wartości domyślnej.

Ograniczanie elementów DataColumn aby zawierały wartości unikatowe

Można ustawić DataColumn, tak aby zawierała tylko wartości unikatowe, przez dodanie unikatowego ograniczenia do tabeli danych.Ograniczenia unikatowe są również nazywane kluczami.Oznaczenie kolumny jako klucz podstawowy w Projektancie obiektów Dataset spowoduje utworzenie unikatowego ograniczenia.

Aby ograniczyć zawartość kolumny do wartości unikatowych

1. Otwórz zestaw danych w Projektancie obiektów Dataset.

2. Kliknij prawym przyciskiem myszy kolumnę, którą chcesz ograniczyć do unikatowych wartości.Wskaż Dodaj, a następnie kliknij przycisk Klucz/.

3. W oknie dialogowym Ograniczenia unikatowe należy sprawdzić, czy wybrana kolumna jest poprawna.

4. W razie potrzeby należy zamienić domyślną nazwę ograniczenia na bardziej opisową nazwę.

Ustawianie elementu DataColumn jako klucz podstawowy elementu DataTable

Ustawianie kolumny danych jako klucz podstawowy gwarantuje, że każdy rekord zawiera unikatową wartość.Można przypisać tylko jeden klucz podstawowy do tabeli danych.Można utworzyć klucz podstawowy w tabeli danych za pomocą Projektanta zestawu danych.

Aby ustawić kolumnę danych jako klucz podstawowy tabeli danych

1. Otwórz zestaw danych w Projektancie obiektów Dataset.

2. Kliknij prawym przyciskiem myszy kolumnę, którą chcesz ustawić jako klucz podstawowy.Kliknij przycisk Ustaw klucz podstawowy.

   Ikona klucza pojawi się obok wybranych kolumn.

Określanie wartości zwracanej kiedy wartość elementu DataColumn ma wartość null.

W typizowanym zestawie danych, można kontrolować reprezentacje kolumn, które zawierają wartości null.To zachowanie jest dostępne tylko podczas pobierania wartości kolumny poprzez ich metody dostępu.Jeśli wartości są pobierane za pomocą indeksu wiersza lub kolumny tabeli, nie można ustawić wartości zwracanej.Wynika to z logiki, która jest wbudowana do właściwości metody ustawiającej określone dane kolumny w klasie wygenerowanego zestawu danych.

Aby ustawić wartość zwracaną, gdy element DataColumn ma wartość null

1. Należy otworzyć zestaw danych w Projektancie obiektów Dataset

2. Wybierz kolumnę w tabeli danych.

3. W oknie Właściwości wybierz właściwość NullValue.

4. Wykonaj jedną z następujących czynności:

   • Z listy rozwijanej wybierz odpowiednią wartość:

     Wartość	Opis
     (Pusty)	Zwraca wartości null String.Empty.
     (Nic)	Zwraca wartości null jako DBNull.
     (Zgłoś wyjątek)	Wartości null zgłaszają wyjątek Exception.

     -lub-

   • Ustaw właściwość na dowolną niestandardową wartość, prawidłową dla typu danych tej kolumny.Na przykład, jeśli zostanie określony pusty ciąg dla kolumn z danymi typu String, dla rekordów zawierających wartość null w tej kolumnie zostanie wyświetlone "Brak wartości".

Konfigurowanie elementu DataColumn do wyświetlenia wyrażenia.

Tabela danych w zestawie danych może zawierać kolumny, w których wartość jest obliczana zamiast odczytywana z bazy danych.Na przykład w rekordzie szczegółów zamówienia, może warto byłoby zdefiniować kolumnę ExtendedPrice, mnożąc cenę określoną liczbę razy, zamiast przechowywać całość w rekordzie.Kolumny obliczeniowe można dodawać lub obliczyć wartość rekordów podrzędnych i odfiltrować inne rekordy.Można zdefiniować kolumny obliczeniowe przy pomocy wyrażeń.

Składnia wyrażenia składa się z standardowych operatorów.Można odwoływać się do wartości danych przy użyciu nazwy kolumny (tak jak w instrukcji SQL) i zawierać funkcję agregujące, takie jak Count.

Na przykład, wyrażeniem dla kolumny ExtendedPrice, na podstawie UnitPrice razy Quantity kolumny bieżącego rekordu może być:

UnitPrice * Quantity

Aby odwołać się do kolumn w tabelach podrzędnych, można użyć zastrzeżonego słowa Child, a następnie nazwy kolumny.Na przykład, poniższe wyrażenie zwraca średnią wartość kolumny Price we wszystkich powiązanych rekordach podrzędnych:

Avg(Child.Price)

Aby uzyskać więcej informacji, zobacz omówienie właściwości Expression.

Można utworzyć wyrażenie kolumn w Projektancie obiektów Dataset.Aby uzyskać więcej informacji dotyczących tworzeniu kolumn, zobacz Porady: dodawanie kolumn do DataTable.

Aby utworzyć wyrażenia kolumn w Projektancie obiektów Dataset

1. Otwórz zestaw danych w Projektancie obiektów Dataset.Aby uzyskać więcej informacji, zobacz Porady: otwieranie zestawu w narzędziu Projektant obiektów Dataset.

2. W tabeli danych wybierz kolumnę, do której chcesz dodać wyrażenie lub dodaj nową kolumnę do tabeli.Aby uzyskać więcej informacji, zobacz Porady: dodawanie kolumn do DataTable.

3. W oknie Właściwości, wprowadź wyrażenie w właściwości Expression.

Tematy pokrewne