IData Object. Get Data Метод
Определение
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает данные, связанные с заданным форматом.
Перегрузки
Получает данные, связанные с заданным форматом.
Получает данные, связанные с заданным форматом типа класса.
Получает данные, связанные с указанным форматом данных, используя значение типа Boolean для определения необходимости преобразования данных в этот формат.
GetData(String)
Получает данные, связанные с заданным форматом.
Параметры
Формат извлекаемых данных. Сведения о предварительно определенных форматах см. в разделе DataFormats.
Возвращаемое значение
Примеры
Комментарии
Данные могут быть преобразованы в другой формат, если они были сохранены с указанием того, что преобразование разрешено, и если запрошенный формат совместим с сохраненным форматом. Например, данные, хранящиеся в Юникоде, можно преобразовать в текст.
См. также раздел
Применяется к
GetData(Type)
Получает данные, связанные с заданным форматом типа класса.
Параметры
Объект Type, представляющий формат извлекаемых данных. Сведения о предварительно определенных форматах см. в разделе DataFormats.
Возвращаемое значение
Примеры
Комментарии
Данные могут быть преобразованы в другой формат, если они были сохранены с указанием того, что преобразование разрешено, и если запрошенный формат совместим с сохраненным форматом. Например, данные, хранящиеся в Юникоде, можно преобразовать в текст.
См. также раздел
Применяется к
GetData(String, Boolean)
Получает данные, связанные с указанным форматом данных, используя значение типа Boolean для определения необходимости преобразования данных в этот формат.
Параметры
Формат извлекаемых данных. Сведения о предварительно определенных форматах см. в разделе DataFormats.
Возвращаемое значение
Примеры
Комментарии
Данные могут быть преобразованы в другой формат, если они были сохранены с указанием того, что преобразование разрешено, и если запрошенный формат совместим с сохраненным форматом. Например, данные, хранящиеся в Юникоде, можно преобразовать в текст.
IData Object. Get Data Метод
Определение
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Извлекает объект данных в указанном формате данных.
Перегрузки
Извлекает объект данных в указанном формате; формат данных задается строкой.
Извлекает объект данных в указанном формате; формат данных указывается объектом Type.
Извлекает объект данных в указанном формате, при необходимости преобразуя эти данные в указанный формат.
GetData(String)
Извлекает объект данных в указанном формате; формат данных задается строкой.
Параметры
Строка, задающая формат для извлечения данных. Сведения о предопределенных форматах данных см. в описании класса DataFormats.
Возвращаемое значение
Объект данных с данными в указанном формате, или значение NULL, если данные в указанном формате недоступны.
Комментарии
См. также раздел
Применяется к
GetData(Type)
Извлекает объект данных в указанном формате; формат данных указывается объектом Type.
Параметры
Объект Type, задающий формат для извлечения данных. Сведения о предопределенных форматах данных см. в описании класса DataFormats.
Возвращаемое значение
Объект данных с данными в указанном формате, или значение NULL, если данные в указанном формате недоступны.
Комментарии
См. также раздел
Применяется к
GetData(String, Boolean)
Извлекает объект данных в указанном формате, при необходимости преобразуя эти данные в указанный формат.
Параметры
Строка, задающая формат для извлечения данных. Сведения о предопределенных форматах данных см. в описании класса DataFormats.
Значение true — пытаться автоматически преобразовать данные в указанный формат; значение false — без преобразования формата данных.
Возвращаемое значение
Объект данных с данными в указанном формате, или значение NULL, если данные в указанном формате недоступны.
Комментарии
Data Object. Get Data Метод
Определение
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает данные в указанном формате.
Перегрузки
Возвращает данные в формате, указанном строкой.
Возвращает объект данных в формате, указанном объектом Type.
Возвращает объект данных в указанном формате, при необходимости преобразуя данные в этот формат.
GetData(String)
Возвращает данные в формате, указанном строкой.
Параметры
Строка, задающая формат для данных. Набор предопределенных форматов данных см. в статье о классе DataFormats.
Возвращаемое значение
Реализации
Исключения
Примеры
В следующем примере этот метод используется для первой проверки доступности указанного формата данных (изначально или путем автоматического преобразования). Если указанный формат доступен, в примере данные извлекаются с помощью GetData(String) метода.
В следующем примере кода используется GetDataPresent(String, Boolean) метод, чтобы сначала проверить, доступен ли заданный формат данных в собственном формате (фильтры с автопреобразуемым форматом данных). Если указанный формат доступен, в примере данные извлекаются с помощью GetData(String) метода.
См. также раздел
Применяется к
GetData(Type)
Возвращает объект данных в формате, указанном объектом Type.
Параметры
Type, указывающий формат данных. Набор предопределенных форматов данных см. в статье о классе DataFormats.
Возвращаемое значение
Clipboard. Get Data(String) Метод
Определение
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Извлекает данные из буфера обмена в указанном формате.
Параметры
Формат извлекаемых данных. Сведения о предварительно определенных форматах см. в разделе DataFormats.
Возвращаемое значение
Исключения
Не удалось очистить буфер обмена. Обычно это происходит, когда буфер обмена используется другим процессом.
Текущий поток не выполняется в режиме апартмента с одним потоком (STA). Добавьте STAThreadAttribute в метод Main своего приложения.
Примеры
В следующем примере демонстрируется этот элемент.
Комментарии
Используйте ContainsData метод, чтобы определить, содержит ли буфер обмена данные в указанном формате или совместимом формате перед их извлечением с помощью этого метода.
Данные могут быть преобразованы в другой формат, если они были сохранены с указанием того, что преобразование разрешено, и если запрошенный формат совместим с сохраненным форматом. Например, данные, хранящиеся в Юникоде, можно преобразовать в текст.
ClipboardКласс может использоваться только в потоках, для которых установлен режим апартамента однопотокового подразделения (STA). Чтобы использовать этот класс, убедитесь, что ваш Main метод помечен STAThreadAttribute атрибутом.
Используйте SetData метод, чтобы добавить данные в буфер обмена в определенном формате.
Заполнение наборов данных с помощью адаптеров таблицы
Компонент TableAdapter заполняет набор данных данными из базы данных на основе одного или нескольких указанных запросов или хранимых процедур. TableAdapter также может выполнять операции добавления, обновления и удаления в базе данных для сохранения изменений, внесенных в набор данных. Кроме того, можно выдавать глобальные команды, не связанные ни с одной конкретной таблицей.
Подробные сведения об операциях TableAdapter можно пропустить непосредственно в одном из следующих разделов:
| Раздел | Описание |
|---|---|
| Создание и настройка адаптеров таблиц TableAdapter | Использование конструкторов для создания и настройки адаптеров таблиц |
| Создание параметризованных запросов адаптера таблицы TableAdapter | Как разрешить пользователям предоставлять аргументы для процедур или запросов TableAdapter |
| Непосредственный доступ к базе данных с помощью адаптера таблицы TableAdapter | Использование методов DBDirect для адаптеров таблиц TableAdapter |
| Отключение ограничений при заполнении набора данных | Работа с ограничениями внешнего ключа при обновлении данных |
| Практическое руководство. Расширение функциональных возможностей адаптера таблицы | Добавление пользовательского кода в TableAdapter |
| Считывание XML-данных в набор данных | Работа с XML |
Общие сведения об адаптере таблиц
Адаптеры таблиц — это компоненты, создаваемые конструктором, которые подключаются к базе данных, выполняют запросы или хранимые процедуры и заполняют их таблицу данных возвращаемыми данными. Адаптеры таблиц также отправляют обновленные данные из приложения обратно в базу данных. В TableAdapter можно выполнять столько запросов, сколько нужно, если они возвращают данные, соответствующие схеме таблицы, с которой связан TableAdapter. На следующей схеме показано взаимодействие адаптеров таблиц с базами данных и другими объектами в памяти.
Связанная схема DataTable
Команды обновления TableAdapter
запросы TableAdapter
Адаптеры таблиц могут содержать несколько запросов для заполнения связанных таблиц данных. Можно определить столько запросов для TableAdapter, сколько требуется приложению, при условии, что каждый запрос возвращает данные, соответствующие той же схеме, что и связанная с ней таблица данных. Эта возможность позволяет адаптеру таблицы загружать различные результаты на основе различных критериев.
Помимо добавления запросов, возвращающих данные той же схемы, что и таблица данных TableAdapter, можно добавлять запросы, возвращающие скалярные (одиночные) значения. Например, запрос, возвращающий число клиентов (), SELECT Count(*) From Customers допустим для, CustomersTableAdapter, даже если возвращаемые данные не соответствуют схеме таблицы.
Клеарбефорефилл, свойство
Наследование TableAdapter
TableAdapter расширяют функциональные возможности стандартных адаптеров данных путем инкапсуляции настроенного DataAdapter класса. По умолчанию TableAdapter наследует от Component класса и не может быть приведен к DataAdapter классу. Приведение TableAdapter к DataAdapter классу приводит к InvalidCastException ошибке. Чтобы изменить базовый класс TableAdapter, можно указать класс, производный от, Component в свойстве базового класса TableAdapter в Конструктор наборов данных.
Методы и свойства TableAdapter
Ниже перечислены часто используемые методы и свойства адаптеров таблиц.
Метод обновления адаптера таблицы
Адаптеры таблиц используют команды данных для чтения и записи из базы данных. Используйте первоначальный Fill (основной) запрос TableAdapter в качестве основания для создания схемы связанной таблицы данных, а также InsertCommand UpdateCommand команд, и, DeleteCommand связанных с TableAdapter.Update методом. При вызове Update метода TableAdapter выполняются инструкции, созданные при первоначальной настройке TableAdapter, а не один из дополнительных запросов, добавленных с помощью мастера настройки запросов TableAdapter.
При использовании TableAdapter он фактически выполняет те же операции с командами, которые обычно выполняются. Например, при вызове Fill метода адаптера адаптер выполняет команду данных в своем SelectCommand свойстве и использует модуль чтения данных (например, SqlDataReader ) для загрузки результирующего набора в таблицу данных. Аналогично, при вызове метода адаптера Update он выполняет соответствующую команду (в UpdateCommand InsertCommand DeleteCommand свойствах, и) для каждой измененной записи в таблице данных.
GenerateDbDirectMethods адаптера таблицы
Если вы не хотите создавать эти прямые методы, задайте для свойства GenerateDBDirectMethods TableAdapter значение false (в окне » Свойства «). Дополнительные запросы, добавляемые в TableAdapter, являются автономными запросами — они не создают эти методы.
Поддержка TableAdapter для типов, допускающих значение null
Справочник по TableAdapterManager
По умолчанию класс TableAdapterManager создается при создании набора данных, содержащего связанные таблицы. Чтобы предотвратить создание класса, измените значение Hierarchical Update Свойства набора данных на false. при перетаскивании таблицы, имеющей отношение, в область конструктора Windows формы или WPF, Visual Studio объявляет переменную-член класса. Если не используется привязка данных, необходимо вручную объявить переменную.
Ниже приведены часто используемые методы и свойства TableAdapterManager класса.
| Член | Описание |
|---|---|
| Метод UpdateAll | Сохраняет все данные из всех таблиц данных. |
| Свойство BackUpDataSetBeforeUpdate | Определяет, следует ли создать резервную копию набора данных перед выполнением TableAdapterManager.UpdateAll метода. Логическая. |
| TableName TableAdapter свойства | Представляет адаптер таблицы. Созданный TableAdapterManager содержит свойство для каждого элемента TableAdapter управления. Например, набор данных с таблицей Customers и Orders создается с помощью TableAdapterManager, который содержит CustomersTableAdapter OrdersTableAdapter Свойства и. |
| Свойство UpdateOrder | Управляет порядком отдельных команд вставки, обновления и удаления. Задайте для этого параметра одно из значений TableAdapterManager.UpdateOrderOption перечисления. По умолчанию для задано UpdateOrder значение инсертупдатеделете. Это означает, что операции вставки, обновления и удаления выполняются для всех таблиц в наборе данных. |
