GrapeCity.Documents.Excel.IRange.ImportData

ImportData Method

ImportData(IEnumerable, DataImportOptions)

将数据（最多二维）从数据源导入到范围。

Declaration

[RequiresUnreferencedCode("This method uses reflection to construct generic types or get members. Read the user manual or contact support if it has AOT compatibility issues at runtime.")]
DataImportResult ImportData(IEnumerable items, DataImportOptions options = null)

Parameters

Type	Name	Description
IEnumerable	items	要导入的项。元素类型可以是： 基础类型：sbyte，byte，short，ushort，int，uint，long，ulong，float，double，decimal，bool，DateTime，TimeSpan 或 CalcError。 可以为空的基础类型：string 或 Nullable<T>，其中 T 是一个基础类型。 自定义对象：具有要映射到单元格值的属性的对象。 IReadOnlyDictionary<TKey, TValue> 或 IDictionary<TKey, TValue> 或 IDictionary，其中键是 string： 将其视为属性名和值的集合。 DataRow 或 DataRowView。 集合类型可以是： 非嵌套（一维）IEnumerable。例如，DataView。 嵌套数组（总共二维）IEnumerable 或 IEnumerable<T>，其中内部集合的元素类型是基础类型或可为空的基础类型。 二维数组，其中元素类型是基础类型或可为空的基础类型。
DataImportOptions	options	导入选项。

Returns

Type	Description
DataImportResult

Remarks

如果项集合是基础类型的列表， 则方向由范围的形状确定。 如果范围的行数大于列数， 我们将集合垂直导入。 否则，我们将集合水平导入。

Exceptions

Type	Condition
InvalidCastException	某列的数据类型不一致。使用 ItemTypeProvider 来修复它。
ArgumentException	项的类型不受支持或 options 包含错误信息。
NotSupportedException	当运行时出现 AOT 兼容性问题，通常会抛出此异常。

ImportData<T>(IEnumerable<T>, DataImportOptions)

将数据从数据源（最多二维）导入到范围。

Declaration

[RequiresUnreferencedCode("This method uses reflection to construct generic types or get members. Read the user manual or contact support if it has AOT compatibility issues at runtime.")]
DataImportResult ImportData<T>(IEnumerable<T> items, DataImportOptions options = null)

Parameters

Type	Name	Description
IEnumerable<T>	items	要导入的项目。元素类型可以是： 基础类型：sbyte，byte，short，ushort，int，uint，long，ulong，float，double，decimal，bool，DateTime，TimeSpan 或 CalcError。 可以为空的基础类型：string 或 Nullable<T>，其中 T 是一个基础类型。 自定义对象：具有要映射到单元格值的属性的对象。 IReadOnlyDictionary<TKey, TValue> 或 IDictionary<TKey, TValue> 或 IDictionary，其中键是 string： 将其视为属性名称和值的集合。 DataRow 或 DataRowView。 集合类型可以是： 非嵌套（一维）IEnumerable<T>。 嵌套数组（总共二维）IEnumerable<T>，其中内部集合的元素类型是基础类型或可为空的基础类型。 二维数组，其中元素类型是基础类型或可为空的基础类型。
DataImportOptions	options	导入选项。

Returns

Type	Description
DataImportResult

Type Parameters

Name	Description
T

Remarks

如果项目集合是基础类型的列表， 则方向由范围的形状决定。 如果范围的行数大于列数， 我们将集合垂直导入。 否则，我们将集合水平导入。

Exceptions

Type	Condition
InvalidCastException	某列的数据类型不一致。检查 ItemTypeProvider 的实现是否正确。
ArgumentException	项目类型不受支持或 options 包含错误信息。
NotSupportedException	通常在运行时出现 AOT 兼容性问题时会抛出。

ImportData(DataTable, DataImportOptions)

将数据从表格导入到范围。

Declaration

[RequiresUnreferencedCode("This method uses reflection to construct generic types or get members. Read the user manual or contact support if it has AOT compatibility issues at runtime.")]
DataImportResult ImportData(DataTable table, DataImportOptions options = null)

Parameters

Type	Name	Description
DataTable	table	要导入的表格。列类型可以是： 基础类型：sbyte，byte，short，ushort，int，uint，long，ulong，float，double，decimal，bool，DateTime，TimeSpan 或 CalcError。 可以为空的基础类型：string 或 Nullable<T>，其中 T 是一个基础类型。
DataImportOptions	options	导入选项。

Returns

Type	Description
DataImportResult

Exceptions

Type	Condition
InvalidCastException	列的数据类型不一致。
ArgumentException	options 包含错误的信息。
NotSupportedException	通常在运行时发生 AOT 兼容性问题时会抛出此异常。