DataColumnCollection Classe

Definizione

Spazio dei nomi:

System.Data

Assembly:

System.Data.Common.dll

Origine:

DataColumnCollection.cs

Rappresenta un insieme di oggetti DataColumn di un oggetto DataTable.

public ref class DataColumnCollection sealed : System::Data::InternalDataCollectionBase

public sealed class DataColumnCollection : System.Data.InternalDataCollectionBase

type DataColumnCollection = class
    inherit InternalDataCollectionBase

Public NotInheritable Class DataColumnCollection
Inherits InternalDataCollectionBase

Ereditarietà

Object

InternalDataCollectionBase

DataColumnCollection

Esempio

Nell'esempio seguente viene eseguita un'iterazione di una raccolta di DataColumn oggetti e vengono stampate varie proprietà di ogni colonna dell'insieme.

private void PrintDataTableColumnInfo(DataTable table)
{
    // Use a DataTable object's DataColumnCollection.
    DataColumnCollection columns = table.Columns;

    // Print the ColumnName and DataType for each column.
    foreach(DataColumn column in columns)
    {
        Console.WriteLine(column.ColumnName);
        Console.WriteLine(column.DataType);
    }
}

Private Sub PrintDataTableColumnInfo(table As DataTable)
    
    ' Use a DataTable object's DataColumnCollection.
    Dim columns As DataColumnCollection = table.Columns

    ' Print the ColumnName and DataType for each column.
    Dim column As DataColumn
    For Each column in columns
       Console.WriteLine(column.ColumnName)
       Console.WriteLine(column.DataType.ToString)
    Next
End Sub

Commenti

Definisce DataColumnCollection lo schema di un DataTableoggetto e determina il tipo di dati che ognuno DataColumn può contenere. È possibile accedere a DataColumnCollection tramite la Columns proprietà dell'oggetto DataTable .

DataColumnCollection utilizza i Add metodi e Remove per inserire ed eliminare DataColumn oggetti . Utilizzare la Count proprietà per determinare il numero DataColumn di oggetti presenti nell'insieme. Utilizzare il Contains metodo per verificare se nell'insieme esiste un nome di indice o di colonna specificato.

Proprietà

Count	Ottiene il numero totale di elementi in un insieme. (Ereditato da InternalDataCollectionBase)
IsReadOnly	Ottiene un valore che indica se InternalDataCollectionBase è di sola lettura. (Ereditato da InternalDataCollectionBase)
IsSynchronized	Ottiene un valore che indica se InternalDataCollectionBase è sincronizzato. (Ereditato da InternalDataCollectionBase)
Item[Int32]	Ottiene dall'insieme la classe DataColumn in corrispondenza dell'indice specificato.
Item[String]	Ottiene la classe DataColumn dall'insieme con il nome specificato.
List	Ottiene gli elementi dell'insieme sotto forma di elenco. (Ereditato da InternalDataCollectionBase)
SyncRoot	Ottiene un oggetto che può essere utilizzato per sincronizzare l'insieme. (Ereditato da InternalDataCollectionBase)

Metodi

Add()	Crea e aggiunge un oggetto DataColumn all'insieme DataColumnCollection.
Add(DataColumn)	Crea e aggiunge l'oggetto DataColumn specificato all'insieme DataColumnCollection.
Add(String)	Crea e aggiunge un oggetto DataColumn con il nome specificato alla classe DataColumnCollection.
Add(String, Type)	Crea e aggiunge un oggetto DataColumn con il nome e il tipo specificati alla classe DataColumnCollection.
Add(String, Type, String)	Crea e aggiunge un oggetto DataColumn con il nome, il tipo e l'espressione specificati alla classe DataColumnCollection.
AddRange(DataColumn[])	Copia gli elementi della matrice di oggetti DataColumn specificata alla fine dell'insieme.
CanRemove(DataColumn)	Verifica se una determinata colonna può essere rimossa dall'insieme.
Clear()	Elimina qualsiasi colonna dell'insieme.
Contains(String)	Verifica se l'insieme contiene una colonna con il nome specificato.
CopyTo(Array, Int32)	Copia tutti gli elementi dell'insieme InternalDataCollectionBase corrente in un oggetto Array unidimensionale, partendo dall'indice di InternalDataCollectionBase specificato. (Ereditato da InternalDataCollectionBase)
CopyTo(DataColumn[], Int32)	Copia l'intero insieme in una matrice esistente, a partire dall'indice specificato all'interno della matrice.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetEnumerator()	Ottiene un oggetto IEnumerator per l'insieme. (Ereditato da InternalDataCollectionBase)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IndexOf(DataColumn)	Ottiene l'indice di una colonna specificata in base al nome.
IndexOf(String)	Ottiene l'indice della colonna con il nome specificato (per il nome non viene effettuata alcuna distinzione tra maiuscole e minuscole).
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
Remove(DataColumn)	Rimuove l'oggetto DataColumn specificato dalla raccolta.
Remove(String)	Rimuove l'oggetto DataColumn con il nome specificato dall'insieme.
RemoveAt(Int32)	Rimuove la colonna dall'insieme in corrispondenza dell'indice specificato.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Eventi

CollectionChanged

Viene generato quando l'insieme delle colonne viene modificato mediante l'aggiunta o la rimozione di una colonna.

Metodi di estensione

Cast<TResult>(IEnumerable)	Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.
OfType<TResult>(IEnumerable)	Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.
AsParallel(IEnumerable)	Consente la parallelizzazione di una query.
AsQueryable(IEnumerable)	Converte un oggetto IEnumerable in un oggetto IQueryable.

Thread safety

Questo tipo è sicuro per le operazioni di lettura multithreading. È necessario sincronizzare tutte le operazioni di scrittura.

Vedi anche

• Columns
• DataColumn
• DataTable
• DataRelation
• DataRow
• DataSet