DataSet Конструкторы

Определение

Пространство имен:

System.Data

Сборки:

netstandard.dll, 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 необходимо для обеспечения того, чтобы xml-представление DataSet всегда было именем элемента документа, который является элементом верхнего уровня в определении схемы.

См. также раздел

• DataTableCollection
• Using DataSets в 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 необходимо для обеспечения того, чтобы xml-представление DataSet всегда было именем элемента документа, который является элементом верхнего уровня в определении схемы.

См. также раздел

• DataSetName
• DataTableCollection
• Using DataSets в 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.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);

[<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

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

Внимание!

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.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, bool ConstructSchema);

[<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 * bool -> System.Data.DataSet

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

Параметры

info

SerializationInfo

Сериализованные данные для набора данных.

context

StreamingContext

Контекстные сведения о сериализованном потоке.

ConstructSchema

Boolean

Атрибуты

RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute ObsoleteAttribute

Исключения

InvalidEnumArgumentException

Только для .NET 7 и более поздних версий: info содержит двоичные данные.

Комментарии

Important

Использование экземпляра этого типа с ненадежными данными является угрозой безопасности. Используйте этот объект только с доверенными данными. Дополнительные сведения см. в разделе Проверка всех входных данных.