DataSet DataSet DataSet DataSet Class

Определение

Представляет кэш данных в памяти.Represents an in-memory cache of data.

public ref class DataSet : System::ComponentModel::MarshalByValueComponent, System::ComponentModel::IListSource, System::ComponentModel::ISupportInitializeNotification, System::Runtime::Serialization::ISerializable, System::Xml::Serialization::IXmlSerializable
[System.Serializable]
public class DataSet : System.ComponentModel.MarshalByValueComponent, System.ComponentModel.IListSource, System.ComponentModel.ISupportInitializeNotification, System.Runtime.Serialization.ISerializable, System.Xml.Serialization.IXmlSerializable
type DataSet = class
    inherit MarshalByValueComponent
    interface IListSource
    interface IXmlSerializable
    interface ISupportInitializeNotification
    interface ISerializable
    interface ISupportInitialize
Public Class DataSet
Inherits MarshalByValueComponent
Implements IListSource, ISerializable, ISupportInitializeNotification, IXmlSerializable
Наследование
Атрибуты
Реализации

Примеры

Следующий пример состоит из нескольких методов, которые в совокупности, создать и заполнить DataSet из Northwind базы данных.The following example consists of several methods that, combined, create and fill a DataSet from the Northwind database.

using System;
using System.Data;
using System.Data.SqlClient;

namespace Microsoft.AdoNet.DataSetDemo
{
    class NorthwindDataSet
    {
        static void Main()
        {
            string connectionString = GetConnectionString();
            ConnectToData(connectionString);
        }

        private static void ConnectToData(string connectionString)
        {
            //Create a SqlConnection to the Northwind database.
            using (SqlConnection connection =
                       new SqlConnection(connectionString))
            {
                //Create a SqlDataAdapter for the Suppliers table.
                SqlDataAdapter adapter = new SqlDataAdapter();

                // A table mapping names the DataTable.
                adapter.TableMappings.Add("Table", "Suppliers");

                // Open the connection.
                connection.Open();
                Console.WriteLine("The SqlConnection is open.");

                // Create a SqlCommand to retrieve Suppliers data.
                SqlCommand command = new SqlCommand(
                    "SELECT SupplierID, CompanyName FROM dbo.Suppliers;",
                    connection);
                command.CommandType = CommandType.Text;

                // Set the SqlDataAdapter's SelectCommand.
                adapter.SelectCommand = command;

                // Fill the DataSet.
                DataSet dataSet = new DataSet("Suppliers");
                adapter.Fill(dataSet);

                // Create a second Adapter and Command to get
                // the Products table, a child table of Suppliers. 
                SqlDataAdapter productsAdapter = new SqlDataAdapter();
                productsAdapter.TableMappings.Add("Table", "Products");

                SqlCommand productsCommand = new SqlCommand(
                    "SELECT ProductID, SupplierID FROM dbo.Products;",
                    connection);
                productsAdapter.SelectCommand = productsCommand;

                // Fill the DataSet.
                productsAdapter.Fill(dataSet);

                // Close the connection.
                connection.Close();
                Console.WriteLine("The SqlConnection is closed.");

                // Create a DataRelation to link the two tables
                // based on the SupplierID.
                DataColumn parentColumn =
                    dataSet.Tables["Suppliers"].Columns["SupplierID"];
                DataColumn childColumn =
                    dataSet.Tables["Products"].Columns["SupplierID"];
                DataRelation relation =
                    new System.Data.DataRelation("SuppliersProducts",
                    parentColumn, childColumn);
                dataSet.Relations.Add(relation);
                Console.WriteLine(
                    "The {0} DataRelation has been created.",
                    relation.RelationName);
            }
        }

        static private string GetConnectionString()
        {
            // To avoid storing the connection string in your code, 
            // you can retrieve it from a configuration file.
            return "Data Source=(local);Initial Catalog=Northwind;"
                + "Integrated Security=SSPI";
        }
    }
}
Option Explicit On
Option Strict On

Imports System.Data
Imports system.Data.SqlClient

Public Class NorthwindDataSet

    Public Shared Sub Main()
        Dim connectionString As String = _
            GetConnectionString()
        ConnectToData(connectionString)
    End Sub

    Private Shared Sub ConnectToData( _
        ByVal connectionString As String)

        ' Create a SqlConnection to the Northwind database.
        Using connection As SqlConnection = New SqlConnection( _
           connectionString)

            ' Create a SqlDataAdapter for the Suppliers table.
            Dim suppliersAdapter As SqlDataAdapter = _
               New SqlDataAdapter()

            ' A table mapping names the DataTable.
            suppliersAdapter.TableMappings.Add("Table", "Suppliers")

            ' Open the connection.
            connection.Open()
            Console.WriteLine("The SqlConnection is open.")

            ' Create a SqlCommand to retrieve Suppliers data.
            Dim suppliersCommand As SqlCommand = New SqlCommand( _
               "SELECT SupplierID, CompanyName FROM dbo.Suppliers;", _
               connection)
            suppliersCommand.CommandType = CommandType.Text

            ' Set the SqlDataAdapter's SelectCommand.
            suppliersAdapter.SelectCommand = suppliersCommand

            ' Fill the DataSet.
            Dim dataSet As DataSet = New DataSet("Suppliers")
            suppliersAdapter.Fill(dataSet)

            ' Create a second SqlDataAdapter and SqlCommand to get
            ' the Products table, a child table of Suppliers. 
            Dim productsAdapter As SqlDataAdapter = _
                New SqlDataAdapter()
            productsAdapter.TableMappings.Add("Table", "Products")

            Dim productsCommand As SqlCommand = New SqlCommand( _
               "SELECT ProductID, SupplierID FROM dbo.Products;", _
               connection)
            productsAdapter.SelectCommand = productsCommand

            ' Fill the DataSet.
            productsAdapter.Fill(dataSet)

            ' Close the connection.
            connection.Close()
            Console.WriteLine("The SqlConnection is closed.")

            ' Create a DataRelation to link the two tables
            ' based on the SupplierID.
            Dim parentColumn As DataColumn = _
               dataSet.Tables("Suppliers").Columns("SupplierID")
            Dim childColumn As DataColumn = _
               dataSet.Tables("Products").Columns("SupplierID")
            Dim relation As DataRelation = New _
               System.Data.DataRelation("SuppliersProducts", _
               parentColumn, childColumn)
            dataSet.Relations.Add(relation)

            Console.WriteLine( _
               "The {0} DataRelation has been created.", _
               relation.RelationName)
        End Using

    End Sub

    Private Shared Function GetConnectionString() As String
        ' To avoid storing the connection string in your code,  
        ' you can retrieve it from a configuration file.
        Return "Data Source=(local);Initial Catalog=Northwind;" _
           & "Integrated Security=SSPI;"
    End Function
End Class

Комментарии

DataSet, Который представляет собой кэш в памяти данных, получаемых из источника данных, — это главный компонент архитектуры ADO.NET.The DataSet, which is an in-memory cache of data retrieved from a data source, is a major component of the ADO.NET architecture. DataSet Представляет собой коллекцию из DataTable объектов, которые можно связать друг с другом и с DataRelation объектов.The DataSet consists of a collection of DataTable objects that you can relate to each other with DataRelation objects. Можно также включить целостность данных в DataSet с помощью UniqueConstraint и ForeignKeyConstraint объектов.You can also enforce data integrity in the DataSet by using the UniqueConstraint and ForeignKeyConstraint objects. Дополнительные сведения о работе с DataSet объектов, см. в разделе наборы данных, таблицы данных и объекты DataView.For further details about working with DataSet objects, see DataSets, DataTables, and DataViews.

Тогда как DataTable с данными DataRelationCollection позволяет перемещаться по структуре таблиц.Whereas DataTable objects contain the data, the DataRelationCollection allows you to navigate though the table hierarchy. Таблицы, содержащиеся в DataTableCollection через Tables свойство.The tables are contained in a DataTableCollection accessed through the Tables property. При доступе к DataTable объектов, обратите внимание, что они по условию с учетом регистра.When accessing DataTable objects, note that they are conditionally case sensitive. Например, если один DataTable называется «mydatatable» и другое с именем «Mydatatable», строка, используемая для поиска одной из таблиц считается учитывается регистр.For example, if one DataTable is named "mydatatable" and another is named "Mydatatable", a string used to search for one of the tables is regarded as case sensitive. Однако если существует «mydatatable» и «Mydatatable» нет, строка поиска, которая считается без учета регистра.However, if "mydatatable" exists and "Mydatatable" does not, the search string is regarded as case insensitive. Дополнительные сведения о работе с DataTable объектов, см. в разделе создание объекта DataTable.For more information about working with DataTable objects, see Creating a DataTable.

Объект DataSet могут читать и записывать данные и схему в виде XML-документов.A DataSet can read and write data and schema as XML documents. Данные и схему можно затем передавать по протоколу HTTP и использовать любое приложение, на любой платформе с поддержкой XML.The data and schema can then be transported across HTTP and used by any application, on any platform that is XML-enabled. Схемы можно сохранить в виде XML-схемы с WriteXmlSchema метода, схему и данные можно сохранить с помощью WriteXml метод.You can save the schema as an XML schema with the WriteXmlSchema method, and both schema and data can be saved using the WriteXml method. Чтобы считать XML-документ, включающий схему и данные, используйте ReadXml метод.To read an XML document that includes both schema and data, use the ReadXml method.

В типичной реализации многоуровневой, шаги для создания и обновления DataSet, и в свою очередь, исходных данных:In a typical multiple-tier implementation, the steps for creating and refreshing a DataSet, and in turn, updating the original data are to:

  1. Создание и заполнение каждого DataTable в DataSet с данными из источника данных с помощью DataAdapter.Build and fill each DataTable in a DataSet with data from a data source using a DataAdapter.

  2. Изменение данных в отдельных DataTable объектов путем добавления, обновления или удаления DataRow объектов.Change the data in individual DataTable objects by adding, updating, or deleting DataRow objects.

  3. Вызвать GetChanges метод для создания второго DataSet , отображающего только изменения данных.Invoke the GetChanges method to create a second DataSet that features only the changes to the data.

  4. Вызовите Update метод DataAdapter, передав второй DataSet как аргумент.Call the Update method of the DataAdapter, passing the second DataSet as an argument.

  5. Вызвать Merge метод для слияния изменений из второго DataSet в первый.Invoke the Merge method to merge the changes from the second DataSet into the first.

  6. Вызвать AcceptChanges на DataSet.Invoke the AcceptChanges on the DataSet. Кроме того, вызывать RejectChanges для отмены изменений.Alternatively, invoke RejectChanges to cancel the changes.

Примечание

DataSet И DataTable объекты наследуют от MarshalByValueComponentи поддерживают ISerializable интерфейс для удаленного взаимодействия.The DataSet and DataTable objects inherit from MarshalByValueComponent, and support the ISerializable interface for remoting. Это единственные объекты ADO.NET, которые разрешают удаленное взаимодействие.These are the only ADO.NET objects that can be remoted.

Примечание

Классы наследуется от DataSet не завершаются сборщиком мусора, так как метод завершения не была отключена в DataSet.Classes inherited from DataSet are not finalized by the garbage collector, because the finalizer has been suppressed in DataSet. Производный класс может вызывать ReRegisterForFinalize метод в его конструктор, позволяющий класс финализации сборщиком мусора.The derived class can call the ReRegisterForFinalize method in its constructor to allow the class to be finalized by the garbage collector.

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

DataSet() DataSet() DataSet() DataSet()

Инициализирует новый экземпляр класса DataSet.Initializes a new instance of the DataSet class.

DataSet(SerializationInfo, StreamingContext) DataSet(SerializationInfo, StreamingContext) DataSet(SerializationInfo, StreamingContext) DataSet(SerializationInfo, StreamingContext)

Инициализирует новый экземпляр класса DataSet, содержащего заданные сведения о сериализации и контекст.Initializes a new instance of a DataSet class that has the given serialization information and context.

DataSet(SerializationInfo, StreamingContext, Boolean) DataSet(SerializationInfo, StreamingContext, Boolean) DataSet(SerializationInfo, StreamingContext, Boolean) DataSet(SerializationInfo, StreamingContext, Boolean)

Инициализирует новый экземпляр класса DataSet.Initializes a new instance of the DataSet class.

DataSet(String) DataSet(String) DataSet(String) DataSet(String)

Инициализирует новый экземпляр класса DataSet с заданным именем.Initializes a new instance of a DataSet class with the given name.

Свойства

CaseSensitive CaseSensitive CaseSensitive CaseSensitive

Возвращает или задает значение, определяющее, учитывается ли регистр при сравнении строк в объектах DataTable.Gets or sets a value indicating whether string comparisons within DataTable objects are case-sensitive.

Container Container Container Container

Возвращает контейнер для компонента.Gets the container for the component.

(Inherited from MarshalByValueComponent)
DataSetName DataSetName DataSetName DataSetName

Возвращает или задает имя текущего DataSet.Gets or sets the name of the current DataSet.

DefaultViewManager DefaultViewManager DefaultViewManager DefaultViewManager

Получает новое представление данных класса DataSet для осуществления фильтрации, поиска или перехода с помощью настраиваемого класса DataViewManager.Gets a custom view of the data contained in the DataSet to allow filtering, searching, and navigating using a custom DataViewManager.

DesignMode DesignMode DesignMode DesignMode

Возвращает значение, показывающее, находится ли компонент в настоящий момент в режиме разработки.Gets a value indicating whether the component is currently in design mode.

(Inherited from MarshalByValueComponent)
EnforceConstraints EnforceConstraints EnforceConstraints EnforceConstraints

Возвращает или задает значение, определяющее соблюдение правил ограничения при попытке совершения операции обновления.Gets or sets a value indicating whether constraint rules are followed when attempting any update operation.

Events Events Events Events

Возвращает список обработчиков событий, которые прикреплены к этому компоненту.Gets the list of event handlers that are attached to this component.

(Inherited from MarshalByValueComponent)
ExtendedProperties ExtendedProperties ExtendedProperties ExtendedProperties

Возвращает коллекцию настраиваемых данных пользователя, связанных с DataSet.Gets the collection of customized user information associated with the DataSet.

HasErrors HasErrors HasErrors HasErrors

Получает значение, определяющее наличие ошибок в любом из объектов DataTable в классе DataSet.Gets a value indicating whether there are errors in any of the DataTable objects within this DataSet.

IsInitialized IsInitialized IsInitialized IsInitialized

Получает значение, указывающее, инициализирована ли таблица DataSet.Gets a value that indicates whether the DataSet is initialized.

Locale Locale Locale Locale

Возвращает или задает сведения о языке, используемые для сравнения строк таблицы.Gets or sets the locale information used to compare strings within the table.

Namespace Namespace Namespace Namespace

Возвращает или задает пространство имен DataSet.Gets or sets the namespace of the DataSet.

Prefix Prefix Prefix Prefix

Возвращает или задает префикс XML, который является псевдонимом пространства имен класса DataSet.Gets or sets an XML prefix that aliases the namespace of the DataSet.

Relations Relations Relations Relations

Получает коллекцию соотношений, связывающих таблицы и позволяющих переходить от родительских таблиц к дочерним.Gets the collection of relations that link tables and allow navigation from parent tables to child tables.

RemotingFormat RemotingFormat RemotingFormat RemotingFormat

Возвращает или задает объект SerializationFormat для набора данных DataSet, который используется для удаленного взаимодействия.Gets or sets a SerializationFormat for the DataSet used during remoting.

SchemaSerializationMode SchemaSerializationMode SchemaSerializationMode SchemaSerializationMode

Возвращает или задает объект SchemaSerializationMode для DataSet.Gets or sets a SchemaSerializationMode for a DataSet.

Site Site Site Site

Возвращает или задает тип ISite для объекта DataSet.Gets or sets an ISite for the DataSet.

Tables Tables Tables Tables

Возвращает коллекцию таблиц класса DataSet.Gets the collection of tables contained in the DataSet.

Методы

AcceptChanges() AcceptChanges() AcceptChanges() AcceptChanges()

Сохраняет все изменения, внесенные в класс DataSet после его загрузки или после последнего вызова метода AcceptChanges().Commits all the changes made to this DataSet since it was loaded or since the last time AcceptChanges() was called.

BeginInit() BeginInit() BeginInit() BeginInit()

Начинает инициализацию DataSet, используемого в форме или другим компонентом.Begins the initialization of a DataSet that is used on a form or used by another component. Инициализация происходит во время выполнения.The initialization occurs at run time.

Clear() Clear() Clear() Clear()

Удаляет из класса DataSet любые данные путем удаления всех строк во всех таблицах.Clears the DataSet of any data by removing all rows in all tables.

Clone() Clone() Clone() Clone()

Копирует структуру класса DataSet, включая все схемы, соотношения и ограничения объекта DataTable.Copies the structure of the DataSet, including all DataTable schemas, relations, and constraints. Данные не копируются.Does not copy any data.

Copy() Copy() Copy() Copy()

Копирует структуру и данные для DataSet.Copies both the structure and data for this DataSet.

CreateDataReader() CreateDataReader() CreateDataReader() CreateDataReader()

Возвращает объект DataTableReader с одним результирующим набором для каждой последовательности DataTable в той же последовательности, в которой таблицы отображаются в коллекции Tables.Returns a DataTableReader with one result set per DataTable, in the same sequence as the tables appear in the Tables collection.

CreateDataReader(DataTable[]) CreateDataReader(DataTable[]) CreateDataReader(DataTable[]) CreateDataReader(DataTable[])

Возвращает объект DataTableReader с одним результирующим набором для каждой таблицы DataTable.Returns a DataTableReader with one result set per DataTable.

DetermineSchemaSerializationMode(SerializationInfo, StreamingContext) DetermineSchemaSerializationMode(SerializationInfo, StreamingContext) DetermineSchemaSerializationMode(SerializationInfo, StreamingContext) DetermineSchemaSerializationMode(SerializationInfo, StreamingContext)

Определяет SchemaSerializationMode для DataSet.Determines the SchemaSerializationMode for a DataSet.

DetermineSchemaSerializationMode(XmlReader) DetermineSchemaSerializationMode(XmlReader) DetermineSchemaSerializationMode(XmlReader) DetermineSchemaSerializationMode(XmlReader)

Определяет SchemaSerializationMode для DataSet.Determines the SchemaSerializationMode for a DataSet.

Dispose() Dispose() Dispose() Dispose()

Освобождает все ресурсы, используемые объектом MarshalByValueComponent.Releases all resources used by the MarshalByValueComponent.

(Inherited from MarshalByValueComponent)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом MarshalByValueComponent, а при необходимости освобождает также управляемые ресурсы.Releases the unmanaged resources used by the MarshalByValueComponent and optionally releases the managed resources.

(Inherited from MarshalByValueComponent)
EndInit() EndInit() EndInit() EndInit()

Завершает инициализацию DataSet, используемого в форме или другим компонентом.Ends the initialization of a DataSet that is used on a form or used by another component. Инициализация происходит во время выполнения.The initialization occurs at run time.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetChanges() GetChanges() GetChanges() GetChanges()

Получает копию класса DataSet, содержащую все изменения, внесенные после его загрузки или после последнего вызова метода AcceptChanges().Gets a copy of the DataSet that contains all changes made to it since it was loaded or since AcceptChanges() was last called.

GetChanges(DataRowState) GetChanges(DataRowState) GetChanges(DataRowState) GetChanges(DataRowState)

Получает копию таблицы DataSet, содержащую все изменения, внесенные после ее последней загрузки или после вызова метода AcceptChanges() и отфильтрованные по параметру DataRowState.Gets a copy of the DataSet containing all changes made to it since it was last loaded, or since AcceptChanges() was called, filtered by DataRowState.

GetDataSetSchema(XmlSchemaSet) GetDataSetSchema(XmlSchemaSet) GetDataSetSchema(XmlSchemaSet) GetDataSetSchema(XmlSchemaSet)

Получает копию XmlSchemaSet для DataSet.Gets a copy of XmlSchemaSet for the DataSet.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

Заполняет объект сведений о сериализации данными, необходимыми для сериализации DataSet.Populates a serialization information object with the data needed to serialize the DataSet.

GetSchemaSerializable() GetSchemaSerializable() GetSchemaSerializable() GetSchemaSerializable()

Возвращает сериализуемый экземпляр XmlSchema.Returns a serializable XmlSchema instance.

GetSerializationData(SerializationInfo, StreamingContext) GetSerializationData(SerializationInfo, StreamingContext) GetSerializationData(SerializationInfo, StreamingContext) GetSerializationData(SerializationInfo, StreamingContext)

Десериализует данные таблицы из двоичного потока или XML-потока.Deserializes the table data from the binary or XML stream.

GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Возвращает средство реализации объекта IServiceProvider.Gets the implementer of the IServiceProvider.

(Inherited from MarshalByValueComponent)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
GetXml() GetXml() GetXml() GetXml()

Возвращает XML-представление данных, хранящихся в классе DataSet.Returns the XML representation of the data stored in the DataSet.

GetXmlSchema() GetXmlSchema() GetXmlSchema() GetXmlSchema()

Возвращает XML-схему для XML-представления данных, хранящихся в классе DataSet.Returns the XML Schema for the XML representation of the data stored in the DataSet.

HasChanges() HasChanges() HasChanges() HasChanges()

Получает значение, определяющее наличие изменений в классе DataSet, включая добавление, удаление или изменение строк.Gets a value indicating whether the DataSet has changes, including new, deleted, or modified rows.

HasChanges(DataRowState) HasChanges(DataRowState) HasChanges(DataRowState) HasChanges(DataRowState)

Получает значение, определяющее наличие изменений в классе DataSet, включая добавление, удаление или изменение строк, отфильтрованных по типу DataRowState.Gets a value indicating whether the DataSet has changes, including new, deleted, or modified rows, filtered by DataRowState.

InferXmlSchema(Stream, String[]) InferXmlSchema(Stream, String[]) InferXmlSchema(Stream, String[]) InferXmlSchema(Stream, String[])

Применяет XML-схему из указанного объекта Stream к объекту DataSet.Applies the XML schema from the specified Stream to the DataSet.

InferXmlSchema(String, String[]) InferXmlSchema(String, String[]) InferXmlSchema(String, String[]) InferXmlSchema(String, String[])

Применяет XML-схему из указанного файла к классу DataSet.Applies the XML schema from the specified file to the DataSet.

InferXmlSchema(TextReader, String[]) InferXmlSchema(TextReader, String[]) InferXmlSchema(TextReader, String[]) InferXmlSchema(TextReader, String[])

Применяет XML-схему из указанного объекта TextReader к объекту DataSet.Applies the XML schema from the specified TextReader to the DataSet.

InferXmlSchema(XmlReader, String[]) InferXmlSchema(XmlReader, String[]) InferXmlSchema(XmlReader, String[]) InferXmlSchema(XmlReader, String[])

Применяет XML-схему из указанного объекта XmlReader к объекту DataSet.Applies the XML schema from the specified XmlReader to the DataSet.

InitializeDerivedDataSet() InitializeDerivedDataSet() InitializeDerivedDataSet() InitializeDerivedDataSet()

Десериализует все данные таблицы DataSet из двоичного потока или XML-потока.Deserialize all of the tables data of the DataSet from the binary or XML stream.

IsBinarySerialized(SerializationInfo, StreamingContext) IsBinarySerialized(SerializationInfo, StreamingContext) IsBinarySerialized(SerializationInfo, StreamingContext) IsBinarySerialized(SerializationInfo, StreamingContext)

Анализирует формат сериализованного представления набора данных DataSet.Inspects the format of the serialized representation of the DataSet.

Load(IDataReader, LoadOption, DataTable[]) Load(IDataReader, LoadOption, DataTable[]) Load(IDataReader, LoadOption, DataTable[]) Load(IDataReader, LoadOption, DataTable[])

Заполняет набор данных DataSet значениями из источника данных с помощью предоставляемого объекта IDataReader, использующего массив экземпляров DataTable для предоставления сведений о схеме и пространстве имен.Fills a DataSet with values from a data source using the supplied IDataReader, using an array of DataTable instances to supply the schema and namespace information.

Load(IDataReader, LoadOption, FillErrorEventHandler, DataTable[]) Load(IDataReader, LoadOption, FillErrorEventHandler, DataTable[]) Load(IDataReader, LoadOption, FillErrorEventHandler, DataTable[]) Load(IDataReader, LoadOption, FillErrorEventHandler, DataTable[])

Заполняет набор данных DataSet значениями из источника данных с помощью предоставляемого объекта IDataReader, использующего массив экземпляров DataTable для предоставления сведений о схеме и пространстве имен.Fills a DataSet with values from a data source using the supplied IDataReader, using an array of DataTable instances to supply the schema and namespace information.

Load(IDataReader, LoadOption, String[]) Load(IDataReader, LoadOption, String[]) Load(IDataReader, LoadOption, String[]) Load(IDataReader, LoadOption, String[])

Заполняет набор данных DataSet значениями из источника данных с помощью предоставляемого объекта IDataReader, используя массив строк для предоставления имен таблиц в наборе данных DataSet.Fills a DataSet with values from a data source using the supplied IDataReader, using an array of strings to supply the names for the tables within the DataSet.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
Merge(DataRow[]) Merge(DataRow[]) Merge(DataRow[]) Merge(DataRow[])

Осуществляет слияние массива объектов DataRow и текущего класса DataSet.Merges an array of DataRow objects into the current DataSet.

Merge(DataRow[], Boolean, MissingSchemaAction) Merge(DataRow[], Boolean, MissingSchemaAction) Merge(DataRow[], Boolean, MissingSchemaAction) Merge(DataRow[], Boolean, MissingSchemaAction)

Осуществляет слияние массива объектов DataRow и текущего объекта DataSet, сохраняя или удаляя любые изменения в этом объекте DataSet и обрабатывая несовместимую схему в соответствии с заданными аргументами.Merges an array of DataRow objects into the current DataSet, preserving or discarding changes in the DataSet and handling an incompatible schema according to the given arguments.

Merge(DataSet) Merge(DataSet) Merge(DataSet) Merge(DataSet)

Осуществляет слияние указанного объекта DataSet и его схемы с текущим объектом DataSet.Merges a specified DataSet and its schema into the current DataSet.

Merge(DataSet, Boolean) Merge(DataSet, Boolean) Merge(DataSet, Boolean) Merge(DataSet, Boolean)

Осуществляет слияние указанного класса DataSet и его схемы с текущим объектом DataSet, сохраняя или удаляя любые изменения в этом объекте DataSet в соответствии с заданным аргументом.Merges a specified DataSet and its schema into the current DataSet, preserving or discarding any changes in this DataSet according to the given argument.

Merge(DataSet, Boolean, MissingSchemaAction) Merge(DataSet, Boolean, MissingSchemaAction) Merge(DataSet, Boolean, MissingSchemaAction) Merge(DataSet, Boolean, MissingSchemaAction)

Осуществляет слияние указанного класса DataSet и его схемы с текущим набором данных DataSet, сохраняя или удаляя любые изменения в текущем наборе данных DataSet и обрабатывая несовместимую схему в соответствии с заданными аргументами.Merges a specified DataSet and its schema with the current DataSet, preserving or discarding changes in the current DataSet and handling an incompatible schema according to the given arguments.

Merge(DataTable) Merge(DataTable) Merge(DataTable) Merge(DataTable)

Осуществляет слияние указанного объекта DataTable и его схемы с текущим объектом DataSet.Merges a specified DataTable and its schema into the current DataSet.

Merge(DataTable, Boolean, MissingSchemaAction) Merge(DataTable, Boolean, MissingSchemaAction) Merge(DataTable, Boolean, MissingSchemaAction) Merge(DataTable, Boolean, MissingSchemaAction)

Осуществляет слияние указанного класса DataTable и его схемы с текущим объектом DataSet, сохраняя или удаляя любые изменения в этом объекте DataSet и обрабатывая несовместимую схему в соответствии с заданными аргументами.Merges a specified DataTable and its schema into the current DataSet, preserving or discarding changes in the DataSet and handling an incompatible schema according to the given arguments.

OnPropertyChanging(PropertyChangedEventArgs) OnPropertyChanging(PropertyChangedEventArgs) OnPropertyChanging(PropertyChangedEventArgs) OnPropertyChanging(PropertyChangedEventArgs)

Вызывает событие OnPropertyChanging(PropertyChangedEventArgs).Raises the OnPropertyChanging(PropertyChangedEventArgs) event.

OnRemoveRelation(DataRelation) OnRemoveRelation(DataRelation) OnRemoveRelation(DataRelation) OnRemoveRelation(DataRelation)

Происходит при удалении объекта DataRelation из DataTable.Occurs when a DataRelation object is removed from a DataTable.

OnRemoveTable(DataTable) OnRemoveTable(DataTable) OnRemoveTable(DataTable) OnRemoveTable(DataTable)

Происходит при удалении объекта DataTable из DataSet.Occurs when a DataTable is removed from a DataSet.

RaisePropertyChanging(String) RaisePropertyChanging(String) RaisePropertyChanging(String) RaisePropertyChanging(String)

Посылает уведомление об изменении указанного свойства DataSet.Sends a notification that the specified DataSet property is about to change.

ReadXml(Stream) ReadXml(Stream) ReadXml(Stream) ReadXml(Stream)

Считывает XML-схему и данные в DataSet, используя указанный класс Stream.Reads XML schema and data into the DataSet using the specified Stream.

ReadXml(Stream, XmlReadMode) ReadXml(Stream, XmlReadMode) ReadXml(Stream, XmlReadMode) ReadXml(Stream, XmlReadMode)

Считывает XML-схему и данные в DataSet, используя указанные объекты Stream и XmlReadMode.Reads XML schema and data into the DataSet using the specified Stream and XmlReadMode.

ReadXml(String) ReadXml(String) ReadXml(String) ReadXml(String)

Считывает XML-схему и данные в DataSet, используя указанный файл.Reads XML schema and data into the DataSet using the specified file.

ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode)

Считывает XML-схему и данные в DataSet, используя указанный файл и XmlReadMode.Reads XML schema and data into the DataSet using the specified file and XmlReadMode.

ReadXml(TextReader) ReadXml(TextReader) ReadXml(TextReader) ReadXml(TextReader)

Считывает XML-схему и данные в DataSet, используя указанный класс TextReader.Reads XML schema and data into the DataSet using the specified TextReader.

ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode)

Считывает XML-схему и данные в DataSet, используя указанные объекты TextReader и XmlReadMode.Reads XML schema and data into the DataSet using the specified TextReader and XmlReadMode.

ReadXml(XmlReader) ReadXml(XmlReader) ReadXml(XmlReader) ReadXml(XmlReader)

Считывает XML-схему и данные в DataSet, используя указанный класс XmlReader.Reads XML schema and data into the DataSet using the specified XmlReader.

ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode)

Считывает XML-схему и данные в DataSet, используя указанные объекты XmlReader и XmlReadMode.Reads XML schema and data into the DataSet using the specified XmlReader and XmlReadMode.

ReadXmlSchema(Stream) ReadXmlSchema(Stream) ReadXmlSchema(Stream) ReadXmlSchema(Stream)

Считывает XML-схему из указанного класса Stream в класс DataSet.Reads the XML schema from the specified Stream into the DataSet.

ReadXmlSchema(String) ReadXmlSchema(String) ReadXmlSchema(String) ReadXmlSchema(String)

Считывает XML-схему из указанного файла в класс DataSet.Reads the XML schema from the specified file into the DataSet.

ReadXmlSchema(TextReader) ReadXmlSchema(TextReader) ReadXmlSchema(TextReader) ReadXmlSchema(TextReader)

Считывает XML-схему из указанного класса TextReader в класс DataSet.Reads the XML schema from the specified TextReader into the DataSet.

ReadXmlSchema(XmlReader) ReadXmlSchema(XmlReader) ReadXmlSchema(XmlReader) ReadXmlSchema(XmlReader)

Считывает XML-схему из указанного класса XmlReader в класс DataSet.Reads the XML schema from the specified XmlReader into the DataSet.

ReadXmlSerializable(XmlReader) ReadXmlSerializable(XmlReader) ReadXmlSerializable(XmlReader) ReadXmlSerializable(XmlReader)

Игнорирует атрибуты и возвращает пустой DataSet.Ignores attributes and returns an empty DataSet.

RejectChanges() RejectChanges() RejectChanges() RejectChanges()

Отменяет все изменения, внесенные в класс DataSet после его создания или после последнего вызова метода AcceptChanges().Rolls back all the changes made to the DataSet since it was created, or since the last time AcceptChanges() was called.

Reset() Reset() Reset() Reset()

Очищает все таблицы и удаляет все связи, внешние ограничения и таблицы из DataSet.Clears all tables and removes all relations, foreign constraints, and tables from the DataSet. Для восстановления исходного состояния класса Reset() необходимо переопределить метод DataSet в подклассах.Subclasses should override Reset() to restore a DataSet to its original state.

ShouldSerializeRelations() ShouldSerializeRelations() ShouldSerializeRelations() ShouldSerializeRelations()

Получает значение, определяющее необходимость сохранения значения свойства Relations.Gets a value indicating whether Relations property should be persisted.

ShouldSerializeTables() ShouldSerializeTables() ShouldSerializeTables() ShouldSerializeTables()

Получает значение, определяющее необходимость сохранения значения свойства Tables.Gets a value indicating whether Tables property should be persisted.

ToString() ToString() ToString() ToString()

Возвращает строку String, содержащую имя компонента Component, если таковое имеется.Returns a String containing the name of the Component, if any. Этот метод не следует переопределять.This method should not be overridden.

(Inherited from MarshalByValueComponent)
WriteXml(Stream) WriteXml(Stream) WriteXml(Stream) WriteXml(Stream)

Записывает текущие данные для DataSet с помощью указанного объекта Stream.Writes the current data for the DataSet using the specified Stream.

WriteXml(Stream, XmlWriteMode) WriteXml(Stream, XmlWriteMode) WriteXml(Stream, XmlWriteMode) WriteXml(Stream, XmlWriteMode)

Записывает текущие данные и по возможности схему для DataSet с помощью указанных Stream и XmlWriteMode.Writes the current data, and optionally the schema, for the DataSet using the specified Stream and XmlWriteMode. Чтобы записать схему, задайте в параметре mode значение WriteSchema.To write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(String) WriteXml(String) WriteXml(String) WriteXml(String)

Записывает текущие данные для DataSet в указанный файл.Writes the current data for the DataSet to the specified file.

WriteXml(String, XmlWriteMode) WriteXml(String, XmlWriteMode) WriteXml(String, XmlWriteMode) WriteXml(String, XmlWriteMode)

Записывает текущие данные и по возможности схему для DataSet в указанный файл с помощью заданного объекта XmlWriteMode.Writes the current data, and optionally the schema, for the DataSet to the specified file using the specified XmlWriteMode. Чтобы записать схему, задайте в параметре mode значение WriteSchema.To write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(TextWriter) WriteXml(TextWriter) WriteXml(TextWriter) WriteXml(TextWriter)

Записывает текущие данные для DataSet с помощью указанного объекта TextWriter.Writes the current data for the DataSet using the specified TextWriter.

WriteXml(TextWriter, XmlWriteMode) WriteXml(TextWriter, XmlWriteMode) WriteXml(TextWriter, XmlWriteMode) WriteXml(TextWriter, XmlWriteMode)

Записывает текущие данные и по возможности схему для DataSet с помощью указанных TextWriter и XmlWriteMode.Writes the current data, and optionally the schema, for the DataSet using the specified TextWriter and XmlWriteMode. Чтобы записать схему, задайте в параметре mode значение WriteSchema.To write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(XmlWriter) WriteXml(XmlWriter) WriteXml(XmlWriter) WriteXml(XmlWriter)

Записывает текущие данные для DataSet в указанный класс XmlWriter.Writes the current data for the DataSet to the specified XmlWriter.

WriteXml(XmlWriter, XmlWriteMode) WriteXml(XmlWriter, XmlWriteMode) WriteXml(XmlWriter, XmlWriteMode) WriteXml(XmlWriter, XmlWriteMode)

Записывает текущие данные и по возможности схему для DataSet с помощью указанных XmlWriter и XmlWriteMode.Writes the current data, and optionally the schema, for the DataSet using the specified XmlWriter and XmlWriteMode. Чтобы записать схему, задайте в параметре mode значение WriteSchema.To write the schema, set the value for the mode parameter to WriteSchema.

WriteXmlSchema(Stream) WriteXmlSchema(Stream) WriteXmlSchema(Stream) WriteXmlSchema(Stream)

Записывает структуру DataSet в качестве XML-схемы для указанного объекта Stream.Writes the DataSet structure as an XML schema to the specified Stream object.

WriteXmlSchema(Stream, Converter<Type,String>) WriteXmlSchema(Stream, Converter<Type,String>) WriteXmlSchema(Stream, Converter<Type,String>) WriteXmlSchema(Stream, Converter<Type,String>)

Записывает структуру DataSet в качестве XML-схемы для указанного объекта Stream.Writes the DataSet structure as an XML schema to the specified Stream object.

WriteXmlSchema(String) WriteXmlSchema(String) WriteXmlSchema(String) WriteXmlSchema(String)

Записывает структуру класса DataSet в виде XML-схемы в файл.Writes the DataSet structure as an XML schema to a file.

WriteXmlSchema(String, Converter<Type,String>) WriteXmlSchema(String, Converter<Type,String>) WriteXmlSchema(String, Converter<Type,String>) WriteXmlSchema(String, Converter<Type,String>)

Записывает структуру класса DataSet в виде XML-схемы в файл.Writes the DataSet structure as an XML schema to a file.

WriteXmlSchema(TextWriter) WriteXmlSchema(TextWriter) WriteXmlSchema(TextWriter) WriteXmlSchema(TextWriter)

Записывает структуру DataSet в качестве XML-схемы для указанного объекта TextWriter.Writes the DataSet structure as an XML schema to the specified TextWriter object.

WriteXmlSchema(TextWriter, Converter<Type,String>) WriteXmlSchema(TextWriter, Converter<Type,String>) WriteXmlSchema(TextWriter, Converter<Type,String>) WriteXmlSchema(TextWriter, Converter<Type,String>)

Записывает структуру DataSet в виде схемы XML для указанного объекта TextWriter.Writes the DataSet structure as an XML schema to the specified TextWriter.

WriteXmlSchema(XmlWriter) WriteXmlSchema(XmlWriter) WriteXmlSchema(XmlWriter) WriteXmlSchema(XmlWriter)

Записывает структуру класса DataSet в виде XML-схемы в объект XmlWriter.Writes the DataSet structure as an XML schema to an XmlWriter object.

WriteXmlSchema(XmlWriter, Converter<Type,String>) WriteXmlSchema(XmlWriter, Converter<Type,String>) WriteXmlSchema(XmlWriter, Converter<Type,String>) WriteXmlSchema(XmlWriter, Converter<Type,String>)

Записывает структуру DataSet в виде схемы XML для указанного объекта XmlWriter.Writes the DataSet structure as an XML schema to the specified XmlWriter.

События

Disposed Disposed Disposed Disposed

Добавляет обработчик событий, чтобы прослушивать событие Disposed для компонента.Adds an event handler to listen to the Disposed event on the component.

(Inherited from MarshalByValueComponent)
Initialized Initialized Initialized Initialized

Происходит после инициализации таблицы DataSet.Occurs after the DataSet is initialized.

MergeFailed MergeFailed MergeFailed MergeFailed

Происходит, если значения первичного ключа конечного и основного объектов DataRow совпадают, а свойство EnforceConstraints имеет значение true.Occurs when a target and source DataRow have the same primary key value, and EnforceConstraints is set to true.

Явные реализации интерфейса

IListSource.ContainsListCollection IListSource.ContainsListCollection IListSource.ContainsListCollection IListSource.ContainsListCollection

Описание этого члена см. в разделе ContainsListCollection.For a description of this member, see ContainsListCollection.

IListSource.GetList() IListSource.GetList() IListSource.GetList() IListSource.GetList()

Описание этого члена см. в разделе GetList().For a description of this member, see GetList().

ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Заполняет объект сведений о сериализации данными, необходимыми для сериализации DataSet.Populates a serialization information object with the data needed to serialize the DataSet.

IXmlSerializable.GetSchema() IXmlSerializable.GetSchema() IXmlSerializable.GetSchema() IXmlSerializable.GetSchema()

Описание этого члена см. в разделе GetSchema().For a description of this member, see GetSchema().

IXmlSerializable.ReadXml(XmlReader) IXmlSerializable.ReadXml(XmlReader) IXmlSerializable.ReadXml(XmlReader) IXmlSerializable.ReadXml(XmlReader)

Описание этого члена см. в разделе ReadXml(XmlReader).For a description of this member, see ReadXml(XmlReader).

IXmlSerializable.WriteXml(XmlWriter) IXmlSerializable.WriteXml(XmlWriter) IXmlSerializable.WriteXml(XmlWriter) IXmlSerializable.WriteXml(XmlWriter)

Описание этого члена см. в разделе WriteXml(XmlWriter).For a description of this member, see WriteXml(XmlWriter).

Применяется к

Потокобезопасность

Этот тип является безопасным для многопоточных операций чтения.This type is safe for multithreaded read operations. Необходимо синхронизировать все операции записи.You must synchronize any write operations.

Дополнительно