OleDbDataReader.GetSchemaTable Metodo

Definizione

Spazio dei nomi:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Pacchetto:

System.Data.OleDb v9.0.0-rc.2.24473.5

Restituisce un oggetto DataTable che descrive i metadati della colonna di OleDbDataReader.

public:
 override System::Data::DataTable ^ GetSchemaTable();

public override System.Data.DataTable? GetSchemaTable ();

override this.GetSchemaTable : unit -> System.Data.DataTable

Public Overrides Function GetSchemaTable () As DataTable

Restituisce

DataTable

Oggetto DataTable che descrive i metadati della colonna.

Eccezioni

InvalidOperationException

OleDbDataReader è chiuso.

Commenti

Il GetSchemaTable metodo esegue il mapping al metodo OLE DB IColumnsRowset::GetColumnsRowset e restituisce i metadati relativi a ogni colonna nell'ordine seguente:

Colonna DataReader	ID colonna OLE DB	Descrizione
ColumnName	DBCOLUMN_NAME	Nome della colonna; potrebbe non essere univoco. Se non può essere determinata, viene restituito un valore Null. Questo nome riflette sempre la ridenominazione più recente della colonna nella vista o nel testo del comando corrente.
ColumnOrdinal	DBCOLUMN_NUMBER	Ordinale in base zero della colonna. Questa colonna non può contenere un valore Null.
ColumnSize	DBCOLUMN_COLUMNSIZE	Lunghezza massima possibile di un valore nella colonna. Per le colonne che usano un tipo di dati a lunghezza fissa, si tratta della dimensione del tipo di dati.
NumericPrecision	DBCOLUMN_PRECISION	Se DbType è un tipo di dati numerico, si tratta della precisione massima della colonna. La precisione delle colonne con un tipo di dati di DBTYPE_DECIMAL o DBTYPE_NUMERIC dipende dalla definizione della colonna. Se DbType non è un tipo di dati numerico, si tratta di un valore Null.
NumericScale	DBCOLUMN_SCALE	Se DbType è DBTYPE_DECIMAL o DBTYPE_NUMERIC, si tratta del numero di cifre a destra del punto decimale. In caso contrario, si tratta di un valore Null.
DataType	nessuno	Esegue il mapping al tipo .NET Framework della colonna.
ProviderType	DBCOLUMN_TYPE	Indicatore del tipo di dati della colonna. Se il tipo di dati della colonna varia da riga a riga, è necessario DBTYPE_VARIANT. Questa colonna non può contenere un valore Null.
IsLong	DBCOLUMNFLAGS_ISLONG	Il provider imposta DBCOLUMNFLAGS_ISLONG se la colonna contiene un BLOB (Binary Long Object) che contiene dati molto lunghi. La definizione di dati molto lunghi è specifica del provider. L'impostazione di questo flag corrisponde al valore della colonna IS_LONG nel set di righe PROVIDER_TYPES per il tipo di dati.
AllowDBNull	DBCOLUMNFLAGS_ISNULLABLE	Il provider imposta DBCOLUMNFLAGS_ISNULLABLE se il consumer può impostare la colonna su un valore Null o se il provider non può determinare se il consumer può impostare la colonna su un valore Null. Una colonna può contenere valori Null, anche se non può essere impostata su questo tipo di valore.
IsReadOnly	DBCOLUMNFLAGS_WRITE	true se la colonna non può essere modificata; altrimenti false. Si presuppone che la colonna sia scrivibile se il provider ha impostato il flag DBCOLUMNFLAGS_WRITE o DBCOLUMNFLAGS_WRITEUNKNOWN.
IsRowVersion	DBCOLUMNFLAGS_ISROWID	Il provider imposta DBCOLUMNFLAGS_ISROWID se la colonna contiene un identificatore di riga persistente che non può essere scritto in e non ha alcun valore significativo, ad eccezione dell'identità della riga.
IsUnique	DBCOLUMN_ISUNIQUE	VARIANT_TRUE: nessuna due righe nella tabella di base restituita in BaseTableName può avere lo stesso valore in questa colonna. IsUnique è garantito VARIANT_TRUE se la colonna rappresenta una chiave stessa o se è presente un vincolo di tipo UNIQUE che si applica solo a questa colonna. VARIANT_FALSE: la colonna può contenere valori duplicati nella tabella di base. L'impostazione predefinita di questa colonna è VARIANT_FALSE.
IsKey	DBCOLUMN_KEYCOLUMN	VARIANT_TRUE: la colonna è una di un set di colonne nel set di righe che, insieme, identificano in modo univoco la riga. Il set di colonne con IsKey impostato su VARIANT_TRUE deve identificare in modo univoco una riga nel set di righe. Non è necessario che questo set di colonne sia un set minimo di colonne. Questo set di colonne può essere generato da una chiave primaria della tabella di base, un vincolo UNIQUE o un indice univoco. VARIANT_FALSE: la colonna non è necessaria per identificare in modo univoco la riga.
IsAutoIncrement	DBCOLUMN_ISAUTOINCREMENT	VARIANT_TRUE: la colonna assegna valori alle nuove righe in incrementi fissi. VARIANT_FALSE: la colonna non assegna valori alle nuove righe in incrementi fissi. L'impostazione predefinita di questa colonna è VARIANT_FALSE.
BaseSchemaName	DBCOLUMN_BASESCHEMANAME	Nome dello schema nell'archivio dati contenente la colonna. Valore Null se il nome dello schema di base non può essere determinato. Il valore predefinito di questa colonna è un valore Null.
BaseCatalogName	DBCOLUMN_BASECATALOGNAME	Nome del catalogo nell'archivio dati contenente la colonna. Valore Null se il nome del catalogo di base non può essere determinato. Il valore predefinito di questa colonna è un valore Null.
BaseTableName	DBCOLUMN_BASETABLENAME	Nome della tabella o vista nell'archivio dati contenente la colonna. Valore Null se il nome della tabella di base non può essere determinato. Il valore predefinito di questa colonna è un valore Null.
BaseColumnName	DBCOLUMN_BASECOLUMNNAME	Nome della colonna nell'archivio dati. Questo potrebbe essere diverso dal nome della colonna restituito nella colonna ColumnName se è stato usato un alias. Valore Null se il nome della colonna di base non può essere determinato o se la colonna del set di righe è derivata, ma non identica a, una colonna nell'archivio dati. Il valore predefinito di questa colonna è un valore Null.

Nota

Per assicurarsi che le colonne di metadati restituiscono le informazioni corrette, è necessario chiamare ExecuteReader con il behavior parametro impostato su KeyInfo. In caso contrario, alcune delle colonne nella tabella dello schema potrebbero restituire dati predefiniti, Null o non corretti.

Vedi anche

• DataAdapter e DataReader