DataSet 建構函式

定義

命名空間:

System.Data

組件:

System.Data.Common.dll

初始化 DataSet 類別的新執行個體。

多載

DataSet()	初始化 DataSet 類別的新執行個體。
DataSet(String)	使用指定的名稱，初始化 DataSet 類別的新執行個體。
DataSet(SerializationInfo, StreamingContext)	已淘汰. 使用序列化資料，初始化 DataSet 類別的新執行個體。
DataSet(SerializationInfo, StreamingContext, Boolean)	已淘汰. 使用序列化資料，初始化 DataSet 類別的新執行個體。

DataSet()

來源:

DataSet.cs

初始化 DataSet 類別的新執行個體。

public:
 DataSet();

public DataSet ();

Public Sub New ()

範例

下列範例會建立新的 DataSet，並將兩 DataTable 個 物件加入其中。

Private Sub CreateDataSet()
    Dim dataSet As New DataSet()

    ' Create two DataTable objects using a function.
    Dim table1 As DataTable = MakeTable("idTable1", "thing1")
    Dim table2 As DataTable = MakeTable("idTable2", "thing2")
    dataSet.Tables.Add(table1)
    dataSet.Tables.Add(table2)
    Console.WriteLine(dataSet.Tables.Count)
End Sub
 
 
Private Function MakeTable(c1Name As String, _
    c2Name As String) As DataTable
    Dim table As New DataTable
    
    ' Add two DataColumns
    Dim column As New DataColumn( _
        c1Name, System.Type.GetType("System.Integer"))
    table.Columns.Add(column)
    column = New DataColumn(c2Name, _
        System.Type.GetType("System.String"))
    MakeTable = table
End Function

備註

此建構函式的實作 DataSet 不需要任何參數，並針對新實例建立預設名稱 「NewDataSet」。。

必須有 DataSet 的名稱，才能確保的 DataSet XML 表示一律具有檔項目的名稱，這是架構定義中的最高層級專案。

另請參閱

• DataTableCollection
• 在 ADO.NET 中使用數據集

DataSet(String)

來源:

DataSet.cs

使用指定的名稱，初始化 DataSet 類別的新執行個體。

public:
 DataSet(System::String ^ dataSetName);

public DataSet (string dataSetName);

new System.Data.DataSet : string -> System.Data.DataSet

Public Sub New (dataSetName As String)

參數

dataSetName

String

DataSet 的名稱。

範例

下列範例會建立新的 DataSet，其中會加入兩 DataTable 個物件。

Private Sub CreateDataSet()
    Dim  dataSet As New DataSet("aNewDataSet")

    ' Create two DataTable objects using a function.
    Dim table1 As DataTable = MakeTable("idTable1", "thing1")
    Dim table2 As DataTable = MakeTable("idTable2", "thing2")

    dataSet.Tables.Add(table1)
    dataSet.Tables.Add(table2)
    Console.WriteLine(dataSet.DataSetName, dataSet.Tables.Count)
End Sub


Private Function MakeTable(c1Name As String, c2Name As String) _
    As DataTable
    Dim table As New DataTable
    
    ' Add two DataColumns
    Dim column As New DataColumn( _
        c1Name, System.Type.GetType("System.Integer"))
    table.Columns.Add(column)
    column = New DataColumn(c2Name, _
        System.Type.GetType("System.String"))
    table.Columns.Add(column)
    MakeTable = table
End Function

備註

必須有 DataSet 的名稱，才能確保的 DataSet XML 表示一律具有檔項目的名稱，這是架構定義中的最高層級專案。

另請參閱

• DataSetName
• DataTableCollection
• 在 ADO.NET 中使用數據集

DataSet(SerializationInfo, StreamingContext)

來源:

DataSet.cs

警告

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

使用序列化資料，初始化 DataSet 類別的新執行個體。

protected:
 DataSet(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected DataSet (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Data.DataSet : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Data.DataSet

Protected Sub New (info As SerializationInfo, context As StreamingContext)

參數

info

SerializationInfo

數據集的串行化數據。

context

StreamingContext

串行化數據流的相關內容資訊。

屬性

ObsoleteAttribute

例外狀況

InvalidEnumArgumentException

僅限 .NET 7 和更新版本： info 包含二進位數據。

備註

重要

使用此物件的執行個體時，若並用了不信任的資料，會造成安全性上的風險。 使用此物件時，請一律使用信任的資料。 如需詳細資訊，請參閱 驗證所有輸入。

DataSet(SerializationInfo, StreamingContext, Boolean)

來源:

DataSet.cs

警告

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

使用序列化資料，初始化 DataSet 類別的新執行個體。

protected:
 DataSet(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context, bool ConstructSchema);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected DataSet (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context, bool ConstructSchema);

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Data.DataSet : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext * bool -> System.Data.DataSet

Protected Sub New (info As SerializationInfo, context As StreamingContext, ConstructSchema As Boolean)

參數

info

SerializationInfo

數據集的串行化數據。

context

StreamingContext

串行化數據流的相關內容資訊。

ConstructSchema

Boolean

屬性

ObsoleteAttribute

例外狀況

InvalidEnumArgumentException

僅限 .NET 7 和更新版本： info 包含二進位數據。

備註

重要

使用此物件的執行個體時，若並用了不信任的資料，會造成安全性上的風險。 使用此物件時，請一律使用信任的資料。 如需詳細資訊，請參閱 驗證所有輸入。