DataCommand.DeriveSchema 方法

从指定的命令到数据读取器派生返回的模式,指示项目格式和块。

命名空间:  Microsoft.VisualStudio.Data
程序集:  Microsoft.VisualStudio.Data(在 Microsoft.VisualStudio.Data.dll 中)

语法

声明
Public Overridable Function DeriveSchema ( _
    command As String, _
    commandType As Integer, _
    parameters As DataParameter(), _
    commandTimeout As Integer _
) As DataReader
public virtual DataReader DeriveSchema(
    string command,
    int commandType,
    DataParameter[] parameters,
    int commandTimeout
)
public:
virtual DataReader^ DeriveSchema(
    String^ command, 
    int commandType, 
    array<DataParameter^>^ parameters, 
    int commandTimeout
)
abstract DeriveSchema : 
        command:string * 
        commandType:int * 
        parameters:DataParameter[] * 
        commandTimeout:int -> DataReader 
override DeriveSchema : 
        command:string * 
        commandType:int * 
        parameters:DataParameter[] * 
        commandTimeout:int -> DataReader 
public function DeriveSchema(
    command : String, 
    commandType : int, 
    parameters : DataParameter[], 
    commandTimeout : int
) : DataReader

参数

  • command
    类型:System.String
    一个命令可以派生架构特定到数据源。
  • commandType
    类型:System.Int32
    指定的命令的命令类型,指定如何解释 command 参数的内容。
  • parameters
    类型:array<Microsoft.VisualStudio.Data.DataParameter[]
    数组指定的命令类型的 DataParameter 对象。尽管这是输入参数时,DDEX提供程序可以改为设置的属性和返回值参数。但是,那么,当派生模式时,它们不会填充。
  • commandTimeout
    类型:System.Int32
    时间长度,秒,取消模式派生并返回之前阻止客户端调用方。值0表示无限超时;值-1表示一个提供默认值。

返回值

类型:Microsoft.VisualStudio.Data.DataReader
返回 DataReader 对象。此对象用于读取器对象提供描述项目格式并阻止,即,架构的前向,只读数据流,返回在执行指定的命令。

异常

异常 条件
ArgumentNullException

命令或asyncCommandEvents为空。

ArgumentException

commandType指定无效类型。

ArgumentOutOfRangeException

commandTimeout小于-1。

NotSupportedException

该提供程序不支持此方法。

备注

数据读取器模式返回必须采用方法遵循特定的格式。对于将返回,在执行命令时,应具有在数据读取器的结果的每个结果。描述项目将返回,在执行命令时这些结果中的每一个都应当包含块。该声明应包含以下项:

  • 名称(字符串):项目的名称。

  • 序号(、):项的位置。

  • UserDataType (字符串):项目(例如,“myType”)的用户数据类型。

  • NativeDataType (字符串):项目的本机数据类型(例如,“nvarchar”)。

  • ProviderDataType (、):项目(例如,System.Data.DbType.StringFixedLength)的提供程序数据类型。

  • FrameworkDataType (类型):项目(例如,System.Int32)的framework数据类型。

  • 长度(、):项目的最大长度,如果适用)。

  • 精度(、):项目的精度,如果适用)。

  • 缩放(、):项目的缩放,如果适用)。

  • 可以为null (布尔值):项目的nullability。

提供程序不支持的那些项目(例如,数据类型的某种形式)应存在,但设置为 nullnull 引用(在 Visual Basic 中为 Nothing)。

说明说明

发生的其他异常指示参数派生为一个提供程序指定的原因而失败。

.NET Framework 安全性

请参见

参考

DataCommand 类

Microsoft.VisualStudio.Data 命名空间

DataReader