Partilhar via


DataSet Construtores

Definição

Inicializa uma nova instância da classe DataSet.

Sobrecargas

DataSet()

Inicializa uma nova instância da classe DataSet.

DataSet(String)

Inicializa uma nova instância da classe DataSet com o nome especificado.

DataSet(SerializationInfo, StreamingContext)
Obsoleto.

Inicializa uma nova instância da classe DataSet com dados serializados.

DataSet(SerializationInfo, StreamingContext, Boolean)
Obsoleto.

Inicializa uma nova instância da classe DataSet com dados serializados.

DataSet()

Origem:
DataSet.cs
Origem:
DataSet.cs
Origem:
DataSet.cs

Inicializa uma nova instância da classe DataSet.

public:
 DataSet();
public DataSet ();
Public Sub New ()

Exemplos

O exemplo a seguir cria um novo DataSete adiciona dois DataTable objetos a ele.

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

Comentários

Essa implementação do DataSet construtor não usa parâmetros e cria um nome padrão, "NewDataSet", para a nova instância.

Um nome para o DataSet é necessário para garantir que a representação XML do DataSet sempre tenha um nome para o elemento document, que é o elemento de nível mais alto em uma definição de esquema.

Confira também

Aplica-se a

DataSet(String)

Origem:
DataSet.cs
Origem:
DataSet.cs
Origem:
DataSet.cs

Inicializa uma nova instância da classe DataSet com o nome especificado.

public:
 DataSet(System::String ^ dataSetName);
public DataSet (string dataSetName);
new System.Data.DataSet : string -> System.Data.DataSet
Public Sub New (dataSetName As String)

Parâmetros

dataSetName
String

O nome do DataSet.

Exemplos

O exemplo a seguir cria um novo DataSet, ao qual dois DataTable objetos são adicionados.

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

Comentários

Um nome para o DataSet é necessário para garantir que a representação XML do DataSet sempre tenha um nome para o elemento document, que é o elemento de nível mais alto em uma definição de esquema.

Confira também

Aplica-se a

DataSet(SerializationInfo, StreamingContext)

Origem:
DataSet.cs
Origem:
DataSet.cs
Origem:
DataSet.cs

Cuidado

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

Inicializa uma nova instância da classe DataSet com dados serializados.

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)

Parâmetros

info
SerializationInfo

Os dados serializados para o conjunto de dados.

context
StreamingContext

Informações contextuais sobre o fluxo serializado.

Atributos

Exceções

Somente .NET 7 e versões posteriores: info contém dados binários.

Comentários

Importante

Usar uma instância deste objeto quando você tiver dados não confiáveis é um risco à segurança. Use esse objeto somente quando você tiver dados confiáveis. Para obter mais informações, consulte Validar todas as entradas.

Aplica-se a

DataSet(SerializationInfo, StreamingContext, Boolean)

Origem:
DataSet.cs
Origem:
DataSet.cs
Origem:
DataSet.cs

Cuidado

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

Inicializa uma nova instância da classe DataSet com dados serializados.

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)

Parâmetros

info
SerializationInfo

Os dados serializados para o conjunto de dados.

context
StreamingContext

Informações contextuais sobre o fluxo serializado.

ConstructSchema
Boolean
Atributos

Exceções

Somente .NET 7 e versões posteriores: info contém dados binários.

Comentários

Importante

Usar uma instância deste objeto quando você tiver dados não confiáveis é um risco à segurança. Use esse objeto somente quando você tiver dados confiáveis. Para obter mais informações, consulte Validar todas as entradas.

Aplica-se a