DataSet 建構函式

定義

命名空間:: System.Data

組件:: netstandard.dll, System.Data.Common.dll

組件:: System.Data.Common.dll

組件:: System.Data.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

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

多載

名稱	Description
DataSet()	初始化 DataSet 類別的新執行個體。
DataSet(String)	初始化一個新的類別實例 DataSet ，並以該名稱。
DataSet(SerializationInfo, StreamingContext)	已淘汰. 初始化一個新的類別實例 DataSet ，並使用序列化資料。
DataSet(SerializationInfo, StreamingContext, Boolean)	已淘汰. 初始化一個新的類別實例 DataSet ，並使用序列化資料。

DataSet()

來源:: DataSet.cs

來源:: DataSet.cs

來源:: 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 表示中文件元素始終有名稱，文件元素是結構定義中最高層級的元素。

另請參閱

DataTableCollection
使用 ADO.NET

適用於

DataSet(String)

來源:: DataSet.cs

來源:: DataSet.cs

來源:: 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

來源:: 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);

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
[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);

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

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
protected DataSet(System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
[<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

new System.Data.DataSet : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Data.DataSet

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
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

關於序列化串流的上下文資訊。

屬性: RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute ObsoleteAttribute

例外狀況

InvalidEnumArgumentException

僅 .NET 7 及更新版本： info 包含二進位資料。

備註

Important

使用這種類型的實例與不受信任的資料存在安全風險。此物件僅用於受信任的資料。如需詳細資訊，請參閱驗證所有輸入。

適用於

DataSet(SerializationInfo, StreamingContext, Boolean)

來源:: DataSet.cs

來源:: DataSet.cs

來源:: DataSet.cs

來源:: DataSet.cs

來源:: DataSet.cs

警告