OleDbDataReader.GetSchemaTable Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Data.OleDb
Assembly:
System.Data.OleDb.dll
Assembly:
System.Data.dll
Pacchetto:
System.Data.OleDb v8.0.1
Pacchetto:
System.Data.OleDb v9.0.0-rc.2.24473.5
Origine:
OleDbDataReader.cs
Origine:
OleDbDataReader.cs

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

public:
 override System::Data::DataTable ^ GetSchemaTable();
public:
 virtual System::Data::DataTable ^ GetSchemaTable();
public override System.Data.DataTable? GetSchemaTable ();
public System.Data.DataTable GetSchemaTable ();
public override System.Data.DataTable GetSchemaTable ();
override this.GetSchemaTable : unit -> System.Data.DataTable
abstract member GetSchemaTable : unit -> System.Data.DataTable
override this.GetSchemaTable : unit -> System.Data.DataTable
Public Overrides Function GetSchemaTable () As DataTable
Public Function GetSchemaTable () As DataTable

Restituisce

DataTable

Oggetto DataTable che descrive i metadati della colonna.

Implementazioni

GetSchemaTable()

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.

Si applica a

Vedi anche