共用方式為


DataSet 建構函式

定義

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

多載

DataSet()

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

DataSet(String)

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

DataSet(SerializationInfo, StreamingContext)
已淘汰.

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

DataSet(SerializationInfo, StreamingContext, Boolean)
已淘汰.

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

DataSet()

來源:
DataSet.cs
來源:
DataSet.cs
來源:
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 表示一律具有檔項目的名稱,這是架構定義中的最高層級專案。

另請參閱

適用於

DataSet(String)

來源:
DataSet.cs
來源:
DataSet.cs
來源:
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 表示一律具有檔項目的名稱,這是架構定義中的最高層級專案。

另請參閱

適用於

DataSet(SerializationInfo, StreamingContext)

來源:
DataSet.cs
來源:
DataSet.cs
來源:
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);
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);
new System.Data.DataSet : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Data.DataSet
[<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

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

屬性

例外狀況

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

備註

重要

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

適用於

DataSet(SerializationInfo, StreamingContext, Boolean)

來源:
DataSet.cs
來源:
DataSet.cs
來源:
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);
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);
new System.Data.DataSet : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext * bool -> System.Data.DataSet
[<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
屬性

例外狀況

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

備註

重要

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

適用於