WWW.DISSERS.RU

БЕСПЛАТНАЯ ЭЛЕКТРОННАЯ БИБЛИОТЕКА

   Добро пожаловать!

Pages:     | 1 | 2 || 4 | 5 |

«.net ^ Microsoft Предисловие Криса Селлза IVMl/IUSUI I • Development ...»

-- [ Страница 3 ] --

Листинг 5.13. Добавление отношения для таблиц с составным первичным ключом // Создание массива столбцов, входящих а первичный // ключ родительской таблицы.

DataColumn[] aParentCols = { ds.Tables["Tablel"].Columns["keyl"], ds.Tables["Tablel"]. Columns [")cey2"]} // Создание массива столбцов, входящих в первичный // ключ дочерней таблицы.

DataColumn[] aChildCols = { ds. Tables t "ТаЫе2 " ]. Columns [ "keyl" ], ds.Tables["Table2"].Columns["key2"]} // Создание нового отношения на основе // составных первичных ключей таблиц, ds.Relations.Add( "DualKeyRelation", aParentCols, aChildCols, false);

114 Часть И. Класс DataSet являются реляционными (relational), т.е. такими, в которых одни наборы данных свя заны с другими наборами данных. В нашем случае таблица Customer связана с таб лицей Invoice, которая, в свою очередь, связана с таблицей Invoiceltem, а та — с таблицей Product (рис. 5.2).

Customer! D РК FirstName LastName MlddleName Address Apartment City State Zip HomePhone BusinessPhone DOB Discount Stamp CheckedOut In voice ID InvoiceNumber Description In voice Date Vendor Terms Cost FOB InStock PO Price CustomerlD • Kl InvoiceltemID PK InvoicelD FK ProductID FK Quantity Discount Рис. 5.2. Отношения, существующие между четырьмя таб лицами базы данных Глава 5. Создание объекта DataSet // ключа, не содержат уникальных значений.

Console.WriteLine{"Column(s) in the PrimaryKey are " + "not unique.");

Console.WriteLine(" Exception Thrown: {0}", ex.Message);

Стратегии, использующиеся при определении первичного ключа Одно из первых (и самых важных) решений, которое необходимо принять при проектировании базы данных, касается выбора первичных ключей таблиц. Ниже при ведены три наиболее распространенных методики определения первичного ключа, со стоящего из одного столбца.

• Автоинкрементное значение. Столбец содержит число, однозначно идентифици рующее строку. При добавлении к таблице новой строки число в этом столбце автоматически увеличивается на заданную величину (обычно на единицу). Если вам необходимо использовать автоинкрементные ключи на стороне сервера в SQL Server, обратитесь к главе 8, "Обновление базы данных", для получения более подробной информации.

• Уникальное имя. Ключевой столбец содержит информацию, уникальную для данной строки. Следует отметить, что в этом случае необходимо быть полно стью уверенным в уникальности подобной информации. К примеру, в табли це пациентов в качестве первичного ключа может быть использован номер социального страхования, а в таблице посетителей Web-узла — адрес элек тронной почты.

• Глобальный уникальный идентификатор (Globally Unique Identifier— GUID).- Клю чевой столбец содержит GUID, который однозначно идентифицирует строку.

Каждый из подходов имеет свои плюсы и минусы. В контексте объекта DataSet я бы порекомендовал использовать в качестве первичного ключа столбец, содержащий уникальное имя или GUID. Главная проблема при использовании автоинкрементного столбца заключается в неизбежном перекрытии значений ключа в том случае, если вставка данных в одну таблицу осуществляется посредством более чем одного объекта DataSet. Если значения ключа пересекаются, их (а также ссылки на них) необходимо изменить еще до того, как новые строки будут сохранены в базе данных. При исполь зовании GUID или уникальных имен этих проблем можно избежать. Следует отме тить, что все приведенные выше предположения делаются с учетом того, что сущест вует контроль над схемой объекта DataSet.

Бывают ситуации, в которых программисту приходится работать со старыми сис темами. Если в вашей базе данных используются автоинкрементные поля, не пытай тесь применять их также и в объектах DataSet. В этом случае создание идентифика ционных номеров можно возложить на базу данных и извлекать их в процессе об новления (более подробно возврат идентификатора из базы данных рассматривается в главе 8, "Обновление базы данных").

Создание отношений После определения первичного ключа необходимо сообщить объекту DataSet об отношениях, существующих между таблицами. Большинство баз данных, которые ис пользуются на сегодняшний день (SQL Server, Oracle, Microsoft Access, DB2 и т.д.), GUID — это 128-битовые числа, которые гарантированно являются уникальными. В.NET Framework класс Guid может использоваться для генерации, анализа и чтения идентификаторов GUID.

112 Часть II. Класс DataSet dalnvoiceltems.Fill{dataSet, "Invoiceltems");

// Создание переменных, упрощающих доступ к таблицам.

DataTable customerTable = dataSet.Tables["Customers"];

DataTable invoiceTable = dataSet.Tables["Invoices"];

DataTable invoiceltemTable - dataSet.Tables["Invoiceltems"];

// Определение первичных ключей таблиц.

customerTable.PrimaryKey = new DataColumn[] ( customerTable.Columns["CuatomerlD"] };

invoiceTable. PrimaryKey » new DataColuron[] { invoiceTable.Columns["InvoicelD"] };

invoiceltemTable. PrimaryKey = new DataColximn [] { invoiceltemTable.Columns["InvoiceltemID"] };

Как вы, наверняка, отметили, в листинге 5.15 первичные ключи представляют собой массивы объектов DataColumn. И это действительно так! Хотя в большинстве ситуаций первичный ключ представляет собой единственный столбец, иногда необ ходимо использовать ключ, состоящий из нескольких столбцов. Для достижения единообразия обработки первичного ключа ADO.NET требует, чтобы свойство PrimaryKey являлось массивом столбцов.

При определении первичного ключа для таблицы, которая уже содержит данные, нарушающие условие первичного ключа., генерируется исключение Argument Exception. Пример обработки исключения типа ArgumentException приведен в листинге 5.16.

Листинг 5.16. Обработка исключения типа ArgumentException II Создание объекта DataAdapter для таблицы Customer.

SqlDataAdapter daCustomers = new SqlDataAdapter{"SELECT * FROM CUSTOMER", conn);

// Создание пустого объекта DataSet.

DataSet dataSet = new DataSet();

// Заполнение объекта DataSet с помощью объекта DataAdapter.

daCustomers.Fill(dataSet, "Customers");

// Создание переменной, упрощающей доступ к таблице Customer.

DataTable customerTable = dataSet.Tables["Customers"];

// Добавление дублирующей строки перед определением первичного // ключа - это позволит нам обработать исключение.

customerTable.Rows.Add(customerTable.Rows[0].ItemArray);

try // Определение первичного ключа.

customerTable.PrimaryKey = new DataColumn[] { customerTable.Columns["CustomerlD"] );

I catch (ArgumentException ex) I // Вывод на консоль сообщения об ошибке. В данной случае // исключение типа ArgumentException говорит нам о том, что // столбцы, определенные в качества (части) первичного Глава 5. Создание объекта DataSet Создание схемы объекта DataSet программным путем Бывают ситуации, в которых создание полной схемы объекта DataSet возможно только программным путем. На первый взгляд это может показаться очень утоми тельным занятием, требующим написания кода огромного размера, однако существу ют и весьма приемлемые альтернативы. В конце концов на определенном этапе у вас обязательно возникнет желание разобраться во внутренней структуре объекта DataSet.

Кроме того, я советую создавать классы, которые непосредственно наследуют класс DataSet (несмотря на то что в примерах данной главы это не отражено). Создав класс-потомок класса DataSet, вы можете указать его схему на этапе инициализации, как показано в листинге 5.14.

Листинг 5.14, Наследование класса DataSet class PragmaticDataSet : DataSet ( public PragmaticDataSet() { // Здесь можно разместить определение схемы.

Первичные ключи Как и при работе с базой данных, вы можете определить для таблицы первичный ключ. Первичный ключ используется для обеспечения уникальности вводимых в таб лицу строк. Установив значение свойства PrimaryKey объекта DataTable, можно быть уверенным, что при внесении в таблицу повторяющейся строки будет сгенерировано исключение. Это очень эффективная техника, позволяющая не обращаться к базе данных только лишь затем, чтобы выяснить, что такая строка в таблице уже есть.

Пример добавления первичного ключа приведен в листинге 5.15.

Листинг 5.15. Создание первичного ключа // Создание объекта DataAdapter для каждой извлекаемой // из базы данных таблицы.

SqlDataAdapter daCustomers = new SqlDataAdapter("SELECT * FROM CUSTOMER", conn);

SqlDataAdapter dalnvoices = new SqlDataAdapter("SELECT * FROM INVOICE", conn);

SqlDataAdapter dalnvoiceltems = new SqlDataAdapter("SELECT * FROM INVOICEITEM", conn);

// Создание пустого объекта DataSet.

DataSet dataSet = new DataSet();

// Заполнение объекта DataSet с помощью объектов DataAdapter.

daCustomers.Fill(dataSet, "Customers");

dalnvoices.Fill(dataSet, "Invoices");

f 10 Часть It. Класс DataSet //из базы данных таблицы.

SqlDataAdapter dataAdapter = new SqlDataAdapter("SELECT * FROM CUSTOMER",conn);

// При необходимости обт.ект DataAdapter создаст схему, // включив в нее информацию о первичном ключе.

dataAdapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;

// Создание пустого объекта "DataSet.

DataSet dataSet » new DataSetO;

// Добавление в объект DataSet новой таблицы DataTable // с именем "Customers".

dataAdapter.FillSchema{dataSet, SchemaType.Mapped, "Customers");

Использование языка XSD для определения схемы объекта DataSet Как вы далее увидите, создание сложной схемы объекта DataSet может потребовать написания большого объема кода, С целью повышения производительности и облег чения поддержки стоит обеспечить возможность сериализаиии схемы объекта DataSet так, чтобы ею можно было манипулировать отдельно от кода, проводящего заполне ние объекта DataSet данными. Это можно сделать путем создания объекта DataSet и сохранения его схемы в файле.XSD. В результате при каждом создании объекта DataSet файл.XSD можно будет использовать для определения схемы, как показано в листинге 5.13.

Листинг 5.13. Определение схемы объекта DataSet с помощью файла.XSD // Создание объекта DataAdapter для каждой извлекаемой // из базы данных таблицы.

SqlDataAdapter dataAdapter = new SqlDataAdapter("SELECT * FROM CUSTOMER",conn);

// Если объект DataAdapter обнаружит отсутствие // схемы, он сгенерирует исключение.

dataAdapter.MissingSchemaAction = MissingSchemaAction.Error;

// Создание пустого объекта DataSet.

DataSet dataSet = new DataSetO;

// Загрузка схемы из XSD-файла.

dataSet.ReadXmlSchema(@ "customer.xsd11};

// В этом случае не должно генерироваться исключение, так как // в файле customer.xsd содержится схема таблицы Customers.

dataAdapter. Fill (dataSet, "Customers"), Обратите внимание, что в приведенном выше коде загружается схема для всего объекта DataSet. Создание модульных файлов.XSD, использующихся для заполнения отдельных объектов DataTable, не поддерживается. Более подробно интеграция XML и объекта DataSet рассматривается в главе 9.

Глава 5. Создание объекта DataSet живать нижележащий поставщик данных OLE DB. Более подробно перечисле ние MissingSchemaAction описано в документации MSDN.

• Error — если в объекте DataSet отсутствует схема, необходимая для добавления данных из объекта DataAdapter, генерируется исключение.

• Ignore—дополнительные столбцы, о которых "знает" объект DataAdapter и которые отсутствуют в схеме объекта DataSet, игнорируются.

Значения из перечисления MissingSchemaAction позволяют указать поведение объекта DataAdapter в том случае, если необходимая схема отсутствует. Проще указать схему заранее и установить свойство MissingSchemaAction в значение Error. После этого, если объект DataAdapter попытается внести в объект DataSet не ожидавшиеся данные, будет сгенерировано сообщение об ошибке, и нам не придется иметь дело с "фантомными" строками (листинг 5.11) Листинг 5.11. Заполнение объекта DafaSet с использованием параметра MissingSchemaAction. Error // Создание объекта DataAdapter для каждой извлекаемой / / и з базы данных таблицы.

SqlDataAdapter dataAdapter = new SqlDataAdapter("SELECT * FROM CUSTOMER", c o n n ) ;

// Если объект DataAdapter обнаружит отсутствие // схемы, он сгенерирует исключение.

dataAdapter.MissingSchemaAction = MissingSchemaAction.Error;

// Создание пустого объекта DataSet.

DataSet dataSet = new D a t a S e t ( ) ;

// В данном случае будет сгенерировано исключение, // поскольку объект DataSet пуст (не содержит схемы).

dataAdapter.Fill{dataSet, "Customers");

Для того чтобы схема была создана объектом DataAdapter, можно воспользоваться методом DataAdapter. FillSchema ( ). Этот метод выводит схему на основе инфор мации, хранящейся в базе данных, точно так же, как это делается обычно;

отличие заключается в том, что схема создается заранее. Метод Fill schema () может оказать ся полезным при создании объекта DataSet, который будет заполняться позднее или будет заполнен пользовательскими данными. В качестве параметров метод FillSchema () принимает объект DataSet или DataTable и значение из перечисления schemaType. Параметр типа SchemaType используется для указания объекту DataAdapter на необходимость использования свойства TableMappings (SchemaType.Mapped). В противном случае используется схема, хранящаяся в базе данных (SchemaType. Source). Так как определение значения свойства TableMappings объекта DataAdapter предполагает проведение активных действий, па раметр типа SchemaType почти всегда будет иметь значение SchemaType.Mapped. Ес ли же свойство TableMappings необходимо игнорировать, просто не задавайте его значение. Свойство MissingSchemaAction, как и прежде, используется для указания методу FillSchema {) на способ добавления схемы, как показано в листинге 5.12.

Листинг 5.12. Заполнение объекта DataSet с параметром MissingSchemaAction.AdaWithKey II Создание объекта DataAdapter для каждой извлекаемой Ю8 Часть //. Класс DataSet шлось познакомиться с сотнями различных вариантов схем баз данных, большая часть кото рых представляла собой минимально необходимые схемы. Однако как можно определить этот минимум? Несмотря на то что каждому конкретному случаю соответствовала своя схема, чаще всего она включала в себя определения таблиц, столбцов и, иногда, первичных ключей. При более глубоком изучении исходного кода приложения оказывалось, что в нем была реализова на функциональность, которую легко могла обеспечить сама база данных Тем не менее я не хочу выступать здесь в роли беспощадного критика, так как сам иногда опускался до подобной практики.

Как определить, обладает ли схема базы данных достаточной полнотой? Если вы когда либо писали код (это касается и класса ADO.NET DataSet) для реализации отношений, огра ничений, триггеров и других функциональных возможностей схемы базы данных, то вам опре деленно стоит уделить более пристальное внимание вопросу проектирования схемы базы данных.

На самом деле я хочу сказать только то, что база данных (объект DataSet) должна выпол нять "свою" работу, например:

• если в приложении присутствует код для проверки уникальности строк таблицы, до бавьте к таблице первичный ключ;

• если в приложении присутствует код для проверки уникальности отдельного столбца, добавьте к таблице ограничение;

• если в приложении присутствует код для связывания таблиц родителей и потомков, создайте отношение;

• если в приложении присутствует код, обеспечивающий гарантированное изменение или удаление связанных строк, разрешите для соответствующего отношения каскадные об новления и удаления данных;

• если в приложении присутствует код, отслеживающий изменение состояния базы дан ных, добавьте к последней триггер;

• если все запросы к базе данных содержат много операторов JOIN, создайте представ ление.

Более подробно использование схемы базы данных рассматривается в книгах Джо Келко (Joe Celko) (www.celco.com/books.html).

Вывод схемы объекта DataSet с помощью объекта DataAdapter Каждый раз, когда объект DataSet заполняется с помощью объекта DataAdapter, он должен содержать схему столбцов (объекты DataColumn) для обеспечения возможно сти принимать новые строки данных. Если на текущий момент объект DataSet не со держит схемы, объект DataAdapter выведет ее на основе результатов выполнения за проса (SelectCommand). Процессом вывода схемы можно управлять. Объект DataAdapter содержит свойство MissingSchemaAction, позволяющее указать дейст вия, которые необходимо предпринять в том случае, если в объекте DataSet отсутству ет нужная схема. Свойство MissingSchemaAction может принимать следующие зна чения.

• Add — к схеме будут добавлены столбцы, необходимые для заполнения объекта DataSet с помощью объекта DataAdapter (значение по умолчанию).

AddwithKey— к схеме будут добавлены столбцы, необходимые для заполнения • объекта DataSet с помощью объекта DataAdapter. Кроме того, объект DataAdapter пытается извлечь из базы данных информацию о ключах и опреде ляет первичные ключи заполняемых им объектов DataTable. При использова нии управляемого поставщика OLE DB эту функциональность должен подцер Глава 5. Создание объекта DataSet dataTable.Columns.Add("fname", Systern. Type.GetType("System.String"));

// Добавление строк данных, object[] aSmoltz = {1, "Smoltz", "John"};

object!] aMaddux = {2, "Maddux", "Greg"};

object[] aGlavine = {3, "Glavine", "Tom"};

dataTable.Rows.Add( aSmoltz );

dataTable.Rows.Add( aMaddux );

dataTable.Rows.Add{ aGlavine );

После завершения этих действий с полученным объектом DataSet можно обра щаться точно так же, как и с объектом DataSet, полученным на основе информации из базы данных или на основе информации из XML-файла.

Определение схемы объекта DataSet Правильна ли ваша схема? Не мешает ли она в работе? Предназначение схемы ба зы данных заключается в определении правил, которым должна соответствовать хра нящаяся в базе данных информация. Проблема при этом заключается в том, что программисты вынуждены отражать такие правила в своем коде, чтобы не допустить ошибок в программе. Схема объекта DataSet позволяет эффективно определить эти правила, избавляя программиста от необходимости писать сложный код.

После загрузки данных в объект DataSet его создание можно считать завершенным только наполовину. В большинстве примеров объектов DataSet, которые я встречал, второй шаг был попросту пропущен. Что же собой представляет схема объекта DataSet? После загрузки данных в объект DataSet таблицы имеют схему с минималь но возможным объемом информации, состоящую, в основном, из имен таблиц, столбцов и типов столбцов. Полагаясь лишь на такую схему, можно серьезно услож нить себе жизнь ~ в ней отсутствуют ключи, ограничения, отношения и триггеры.

Для того чтобы заставить объект DataSet вести себя так же, как база данных, необ ходимо определить все перечисленные выше элементы. Для этого можно воспользо ваться несколькими способами: заставить объект DataAdapter вывести схему из запро сов, загрузить содержащий необходимую схему XSD-файл, а также создать схему программным путем. Все эти способы определения схемы объекта DataSet будут рас смотрены в следующих разделах данной главы.

Зачем нужно определять схему объекта DataSet?

Каждый объект DataSet, содержащий данные, имеет определенную схему. Таблица DataTable с заданными правилами для каждого столбца строки DataRow включает в себя объекты Data Column. А как бы со схемой, содержащейся в базе данных? Зачем вам необходимы в объекте DataSet все эти ключи, отношения, ограничения и тригге ры,.особенно если точно такая же схема присутствует в базе данных? Причина дубли рования схемы базы данных в объекте DataSet заключается в возможности обнаруже ния ошибки задолго до того, как будет предпринята попытка сохранить информацию в базе данных. Таким способом можно не только уменьшить общее количество обра щений к базе данных, но также избежать обращений, результатом которых станет всего лишь уведомление о нарушении схемы. Чем раньше мы найдем ошибки в схе ме, тем проще их будет исправить.

Обладает ли схема базы данных достаточной полнотой?

Я занимаюсь разработкой приложений, ориентированных на взаимодействие с базами данных, дольше, чем, возможно, мне этого хотелось бы. В течение этого времени мне при Часть II. Класс DataSet / SqlDataAdapter dataAdapter = new SqlDataAdapter(query, conn);

// Создание объекта DataSet и1его заполнение информацией, // хранящейся в базе данных.

DataSet dataSet = new DataSet ();

// Заполнение объекта DataSet информацией, // хранящейся в базе данных.

dataAdapter.Fill(dataSet);

// Добавление в объект DataSet данных из XML-документа, dataSet.ReadXml(@"products.xml", XmlReadMode.InferSchema);

Как показано в приведенном выше примере, часть информации считывается из базы данных, а часть — из XML-документа. При вызове метода ReadXml ( ) использу ется директива XmlReadMode. inferSchema, потому что по умолчанию при чтении XML-данных в объект DataSet, уже содержащий данные, метод ReadXml ( ) попытает ся сопоставить схему XML-файла с текущей схемой объекта DataSet. Поскольку при вызове метода в объекте DataSet отсутствует таблица Product, без указания на необ ходимость вывода схемы объект DataSet не сможет принять данные из XML-файла.

При желании эту проблему можно было обойти, загрузив XML-данные прежде ин формации из базы данных, так как в случае отсутствия схемы объект DataSet создает ее сам (согласитесь, что вывод схемы только в случае ее отсутствия является несколь ко сбивающим с толку поведением). Если же считываемый XML-файл содержит в се бе дополнительные строки таблиц, уже существующих в объекте DataSet, директива InferSchema нам просто не нужна.

Более подробно интеграция XML и объекта DataSet рассматривается в главе 9, "ADO.NET и XML", Создание объекта DataSet программным путем В некоторых случаях нам может понадобиться создать объект DataSet программным путем. Создание объекта DataTablc вручную и его заполнение данными позволит вам лучше узнать структуру объекта DataSet. Объект DataSet создается сверху вниз. Другими словами, сначала мы создаем сам объект DataSet, затем добавляем в него объект DataTable и определяем информационную схему, создавая объекты DataColumn. Нако нец, в объект DataTable добавляются строки данных, как показано в листинге 5.10.

Листинг 5.10. Создание объекта DataSet программным путем // Создание объекта DataSet.

DataSet dataSet = new DataSetО;

// Добавление нового объекта DataTable в коллекцию // объектов DataTable объекта DataSet.

DataTable dataTable - dataSet.Tables. AddC'Pitchers") ;

// Добавление столбцов (определение информационной схемы).

dataTable.Columns.Add("pitcher_id", System.Type.GetType("System.Int64"));

dataTable.Columns.Add("Iname", System.Type.GetType("System.String"});

Глава 5, Создание объекта DataSet из XML-файла или из места, указанного в URL-адресе, не используя при этом управ ляемый поставщик, как показано в листинге 5.8.

Листинг 5.8. Создание объекта DataSet на основе XML-документа // Заполнение объекта DataSet из XML-файла // или из места, указанного в URL-адресе.

DataSet dsFile = new D a t a S e t ( ) ;

dsFile.ReadXml<@ " c : \ t e s t. x m l " ) ;

// Заполнение объекта DataSet на основе объекта TextReader // (класс StringReader является производным от TextReader).

DataSet dsTextReader = new D a t a S e t ( ) ;

StringReader textReader = new StringReader("hello");

dsTextReader.ReadXml(textReader);

textReader,Close();

// Заполнение объекта DataSet на основе объекта XmlReader // (класс XmlTextReader является производным от XmlReader).

DataSet dsXmlReader = new DataSet();

XmlTextReader xmlReader = new X m l T e x t R e a d e r ( @ " c : \ t e s t. x m l " ) ;

dsXmlReader.ReadXml(xmlReader);

xmlReader.Close();

// Заполнение объекта DataSet на основе объекта Stream // (класс FileStream является производным от Stream)-.

DataSet dsStream = new D a t a S e t О ;

FileStream fs = new F i l e S t r e a m ( @ " c : \ t e s t. x m l ", FileMode.Open);

dsXmlReader.ReadXml(fs);

fs.Close();

Метод ReadXml О может принимать несколько вариантов входных данных: текст в формате XML, путь к файлу, объект XmlReader, объект StringReader или даже объект Stream.

Так как объект DataSet имеет реляционную структуру, его создание на основе XML-документа может показаться странным — ведь по своей природе последний ие рархичен, Несмотря на то что объект DataSet не является самым лучшим контейнером XML-данных, он идеачьно подходит в качестве средства "смешивания" информации из базы данных и данных в формате XML. Чтобы "приготовить" эту смесь, необходи мо использовать объект DataAdapter для извлечения информации из базы данных и метод ReadXml () для ее загрузки из XML-документа, как показано в листинге 5.9.

Листинг 5.9. "Смешивание" информации из базы данных и XML документа // Создание строки-запроса query.

// Для того чтобы извлечь из базы данных несколько // таблиц, мы используем пакетный запрос, возвращающий // несколько результирующих наборов данных.

string query = " ;

" query += "SELECT * FROM CUSTOMER;

";

query +- "SELECT * FROM INVOICE;

";

query +- "SELECT * FROM INVOICEITEM;

";

// Создание объекта DataAdapter для извлечения информации //из базы данных.

Ю4 Часть II. Класс DataSet dataAdapter.TableMappings.Add("ADONET1", "Invoices");

dataAdapter.TableMappings.Add("ADONET2", "Invoicelterns"};

// Определение отображений имен столбцов.

dataAdapter.TableMappings["ADONET"].

ColumnMappings.Add("CustomerlD", "ID");

dataAdapter.TableMappings["ADONET1"].

ColumnMappings.Add("InvoiceID", "ID") ;

dataAdapter.TableMappings["ADONET2"].

ColumnMappings.Add<"InvoiceltemlD", "ID");

// Создание пустого объекта DataSet.

DataSet dataSet = new DataSet(};

// Заполнение объекта DataSet с помощью объекта DataAdapter.

dataAdapter.Fill(dataSet, "ADONET");

Как показано в листинге 5.6, объект DataAdapter получает указание переимено вать поле CustomerlD таблицы Customer, поле invoicelD таблицы Invoice и по ле invoiceltemlD таблицы Invoiceltem в ID. Единственным требованием для пере именования столбцов в объекте Data I able является существование соответствующего объекта DataTableMapping. Если использовать объект DataTableMapping для конкрет ного объекта DataTable нет необходимости, то с целью обеспечения поддержки объек та Data Column Mapping можно создать пустой объект DataTableMapping, как показано в листинге 5.7.

Листинг 5.7. Использование свойства ColumnMappings без изменения имен таблиц // Создание объекта DataAdapter для каждой извлекаемой // из базы данных таблицы.

SqlDataAdapter dataAdapter = new SqlDataAdapter( "SELECT * FROM CUSTOMER", conn);

// Определение 'фиктивного' отображения DataTableMapping.

dataAdapter.TableMappings.Add("Customers", "Customers");

// Определение отображения для имени столбца.

dataAdapter.TableMappings["Customers"].

ColumnMappings.Add("CustomerlD", "ID");

// Создание пустого объекта DataSet.

DataSet dataSet = new DataSet();

// Заполнение объекта DataSet с помощью объекта DataAdapter.

dataAdapter.Fill(dataSet, "Customers");

В этом примере создается "фиктивный" объект DataTableMapping, не производя щий переименования таблицы. Обратите внимание, что имена таблиц в вызове метода TableMappings.Add() должны совпадать с именем таблицы в вызове метода DataAdapter.Fill (.

) Создание объекта DataSet на основе XML-документа Времена меняются — сейчас мы должны быть готовы интегрировать наши данные с данными из произвольных источников (отличных от базы данных). Для того чтобы создать объект DataSet на основе XML-документа, необходимо считать в него данные Глава 5. Создание объекта DataSet ЮЗ Листинг 5.5. Использование свойства TableMappings при заполнении объекта DalaSet таблицами с измененными именами // Создание строки-запроса query.

// Для того чтобы извлечь из базы данных несколько // таблиц, мы используем пакетный запрос, возвращающий // несколько результирующих наборов данных.

string query = " ;

" query += "SELECT * FROM CUSTOMER;

";

query += "SELECT * FROM INVOICE;

";

query +- "SELECT * FROM INVOICEITEM;

";

// Создание объекта DataAdapter для извлечения данных.

SqlDataAdapter dataAdapter = new SqlDataAdapter(query, conn);

// Определение отображений.

dataAdapter.TableMappings.Add("ADONET", "Customers");

dataAdapter.TableMappings.Add("ADONETl", "Invoices");

dataAdapter.TableMappings.Add("ADONET2", "Invoiceltems");

// Создание пустого объекта DataSet.

DataSet dataSet = new DataSet ( ) ;

// Заполнение объекта DataSet с использованием временного имени.

dataAdapter.Fill(dataSet, "ADONET");

В этом листинге метод DataAdapter.Fill () использует в качестве базового имени таблицы имя "ADONET", в результате чего после выполнения пакетного запроса таблицы получают имена ADONET, ADONETI и ADONET2, а стандартным базовым именем таблицы является "Table". На практике одновременное использование свойства TableMappings и определение имени таблицы при вызове метода Fi 11 встречается редко.

Кроме определения имен таблиц, свойство TableMappings может использовать ся для переименования столбцов (при этом первоначальные имена столбцов, воз вращаемые в результате выполнения запроса, заменяются новыми именами, ис пользующимися в объекте DataTable). Для поддержки этой функциональности класс DataTableMapping содержит коллекцию объектов DataCoIumnMappJng, задающих отображение между именами полей в запросе и именами полей в объекте DataSet (листинг 5.6).

Листинг 5.6. Использование свойства ColumnMappings // Создание строки-запроса query.

// Для того чтобы извлечь из базы данных несколько // таблиц, мы используем пакетный запрос, возвращающий // несколько результирующих наборов данных.

string query = " ;

" query 4= "SELECT * FROM CUSTOMER;

";

query += "SELECT * FROM INVOICE;

";

query += "SELECT * FROM INVOICEITEM;

";

// Определение отображений имен таблиц.

dataAdapter.TableMappings.Add{"ADONET", "Customers");

102 Часть II. Класс DataSet DataSet dataSet = new DataSet (};

// Заполнение объекта DataSet с помощью объектов DataAdapter, // присваивая таблицам DataTable информативные имена.

daCustomers.Pill{dataSet, "Customers");

dalnvoices.Fill(dataSet, "Invoices");

daInvoiceIterns.Fill(dataSet, "Invoiceltems");

Хотя теперь таблицы имеют более понятные имена, при этом совершается три об ращения к базе данных, что очень неэффективно. Для того чтобы иметь информатив ные имена таблиц при использовании пакетного запроса, следует воспользоваться свойством объекта DataAdapter TableMappings.

Использование свойства TableMappings Свойство TableMappings объекта DataAdapter является коллекцией объектов DataTableMapping, которые используются для сообщения объекту DataAdapter имен объектов DataTable внутри объекта DataSet, а также имен столбцов внутри каждой таблицы. Для того чтобы использовать свойство TableMappings для назначения имен таблицам, просто добавьте к нему отображение старого имени таблицы на новое имя таблицы, как показано в листинге 5.4.

Листинг 5.4. Использование свойства TableMappings II Создание строки-запроса query.

// Для того чтобы извлечь из базы данных несколько // таблиц, мы используем пакетный запрос, возвращающий // несколько результирующих наборов данных.

string query = " ;

" query += "SELECT * FROM CUSTOMER;

";

query += "SELECT * FROM INVOICE;

";

query += "SELECT * FROM INVOICEITEM;

";

// Создание объекта DataAdapter для извлечения данных.

SqlDataAdapter dataAdapter = new SqlDataAdapter(query, conn);

// Определение отображений.

dataAdapter.TableMappings.Add<"Table", "Customers");

dataAdapter.TableMappings.Add("Tablel", "Invoices");

dataAdapter.TableMappings. Add("Table2", "Invoiceltems");

// Создание пустого объекта DataSet.

DataSet dataSet = new DataSet ();

// Заполнение объекта DataSet с помощью объекта DataAdapter.

dataAdapter.Fill(dataSet};

Как уже упоминалось ранее, в результате вызова метода DataAdapter. Fill () создаются таблицы с именами Table, Tablel и Table2. Поскольку нам известен алгоритм назначения стандартных имен, достаточно просто задать отображение имен с целью переименования T a b l e в Customers, Tablel в Invoices, а ТаЫе в Invoiceltems. Кроме того, методу DataAdapter. Fill О можно указать на не обходимость присвоения объектам DataTable более полезных имен, как показано в листинге 5.5.

Глава 5. Создание объекта DataSet Множественные объекты DataTable Вскоре вы поймете, что больше всего достоинства объекта DataSet проявляются при его использовании в качестве реляционного хранилища данных, расположенного в памяти. Вам довольно часто придется создавать объекты DataSet, содержащие более одного объекта DataTable. Это можно сделать разными способами. Мы рассмотрим каждый из них, отмечая по ходу их плюсы и минусы. В листинге 5.2 показано ис пользование пакетных запросов для получения из базы данных нескольких таблиц, Листинг 5.2. Использование пакетного запроса // Создание строки-запроса query.

// Для того, чтобы извлечь из базы данных несколько // таблиц, мы используем пакетный запрос, возвращающий // несколько результирующих наборов данных.

string query = " ;

" query +- "SELECT * FROM CUSTOMER;

";

query += "SELECT * FROM INVOICE;

";

query += "SELECT * FROM INVOICEITEM;

";

// Создание объекта DataAdapter для извлечения данных, SqlDataAdapter dataAdapter = new SqlDataAdapter(query, conn);

// Создание и заполнение объекта DataSet.

DataSet dataSet = new DataSet();

dataAdapter.Fill(dataSet);

Все было бы хорошо, если бы только таблицам автоматически не присваивались "универсальные" имена. В этом примере объекты DataTable названы Table, Tablel и ТаЫе2 соответственно. Если вам необходимо иметь более информативные имена таблиц, вы можете использовать один объект DataAdapter на каждую из таблиц объек та DataSet, как показано в листинге 5.3.

Листинг 5.3. Заполнение объекта DataSet с использованием информативных имен таблиц // Создание объекта DataAdapter для каждой из таблиц, // извлекаемых из базы данных.

SqlDataAdapter daCustomers = new SqlDataAdapter("SELECT * FROM CUSTOMER;

", conn);

SqlDataAdapter dalnvoices = new SqlDataAdapter("SELECT * FROM INVOICE;

", conn);

SqlDataAdapter dalnvoiceltems - new SqlDataAdapter("SELECT * FROM INVOICEITEM;

", conn);

// Создание пустого объекта DataSet.

Обратите внимание, что не все производители баз данных поддерживают пакетные запро сы. Для того чтобы ознакомиться со всеми способами заполнения объекта DataSet несколькими таблицами, прочитайте весь раздел. Другие описанные в нем методы более независимы от про изводителя базы данных.

Часть //. Класс DataSet / DataAdapter в качестве "моста" между объектом DataSet и базой данных можно встретить на всем протяжении этой главы, а также в последующих главах части II этой книги.

Еше одной важной задачей объекта DataAdapter является минимизация времени, в течение которого соединение будет оставаться открытым. При рассмотрении объекта DataAdapter вы наверняка обратите внимание на то, что явного открытия или закрытия соединения не происходит. DataAdapter знает, что соединение должно быть как можно более коротким, и самостоятельно управляет его открытием и за крытием. Если использовать объект DataAdapter совместно с уже открытым соеди нением, то состояние соединения будет сохранено (т.е. соединение не будет ни от крыто, ни закрыто).

Создание объекта DataSet на основе информации, хранящейся в базе данных В самом простом случае объект DataSet будет использоваться для хранения одной таблицы, как показано в листинге 5.1.

Листинг 5.1. Создание объекта DataSet на основе информации, хранящейся в базе данных // Создание объекта Command для извлечения из базы // данных таблицы Customer.

SqlCommand cmd = conn.CreateCommand();

cmd.CommandText = "SELECT * FROM CUSTOMER";

// Создание объекта DataAdapter для заполнения объекта DataSet.

SqlDataAdapter dataAdapter = new SqlDataAdapter(and);

// Создание пустого объекта DataSet.

DataSet dataSet = new DataSet();

// Заполнение объекта DataSet с помощью объекта DataAdapter.

dataAdapter.Fill(dataSet) ;

В этом примере объект DataSet заполняется результирующим набором данных — таблицей CUSTOMER. На данном этапе читатель должен быть знаком с созданием объектов Connection и Command, а поэтому нам достаточно рассмотреть подробно только выделенный код.

1. Создается экземпляр класса SqlDataAdapter. SqlDataAdapter является спе циализированным классом, выполняющим функцию контейнера для команд, осуществляющих чтение и запись информации в базу данных.

2. Создается экземпляр класса DataSet. Только что созданный объект DataSet является пустым.

3. Вызывается метод Fill о объекта DataAdapter для заполнения объекта DataSet данными из запроса, определенного ранее в объекте Command.

Это очень простой пример заполнения объекта DataSet информацией из одной таблицы на основе одного SQL-запроса. Далее в этой главе мы рассмотрим более сложные аспекты создания объектов DataSet, не затрагивая при этом вопрос обновле ния базы данных. Более подробно обновление базы данных рассматривается в главе 8.

Глава 5. Создание объекта DataSet • System.Data.Common— содержит базовые классы и интерфейсы поставщиков данных;

• System.Data.SqlClient— содержит классы управляемого поставщика дан ных SQL Server;

• System.Data.OleDb— содержит классы управляемого поставщика данных OLE DB;

• System.Data.Odbc— содержит классы управляемого поставщика данных ODBC;

• System.Data.OracleClient— содержит классы управляемого поставщика данных Oracle.

В отличие от предыдущих уровней доступа к данным Microsoft, объект DataSet не имеет никакого внутреннего представления об источнике данных. Таким образом, объект DataSet оказывается отсоединенным не только от данных, но и от информа ции об их происхождении. Следовательно, нам необходимо иметь что-то, что позво лило бы соединить объект DataSet и источник данных.

Заполнение объекта DataSet Так как объект DataSet не связан с базой данных, его можно воспринимать как ре ляционное хранилище данных. Для того чтобы заполнить объект DataSet, совсем не обязательно использовать информацию, хранящуюся в базе данных. На практике су ществует три метода заполнения объекта DataSet: с помощью объекта DatiAdapter (при этом информация, как правило, извлекается из базы данных), на основе XML документа и вручную.

Объект DataAdapter Объект DataAdapter является связующим звеном между объектом DataSet и храни лищем данных. С помощью объекта DataAdapter можно заполнять объект DataSet ин формацией из хранилища данных, а также обновлять хранилище данных на основе объекта DataSet. Фактически объект DataAdapter представляет собой метакоманду, Так, объект DataAdapter состоит из четырех объектов Command, каждый из которых выполняет строго определенную задачу:

• SelectCormand — используется для извлечения данных из хранилища;

• insertCommand— используется для добавления новых записей, созданных в объекте DataSet, в нижележащее хранилище;

• updateCommand — используется для обновления существующих записей в хра нилище на основе изменений в объекте DataSet;

• DeleteCommand — используется для удаления существующих записей из храни лища на основе удалений в объекте DataSet.

Объект DataAdapter используется каждый раз, когда объект DataSet нуждается в непосредственном взаимодействии с источником данных. Один из наиболее важных моментов здесь заключается в том, что объект DataAdapter содержит объекты Command для каждой из основных операций, производимых над базами данных: SELECT, INSERT, UPDATE и DELETE. Основное предназначение объекта DataAdapter заключается в формировании "моста" между объектом DataSet и базой данных. Поскольку таким "мостом" является сам объект DataAdapter, он должен иметь возможность выполнять все основные операции над базой данных. Примеры использования объекта 95 Часть //. Класс DataSet • DataColumn — коллекция правил, описывающая данные, которые можно хра нить в объектах DataRow.

• DataRow — коллекция данных, которая представляет собой одну строку табли цы DataTable. Объект DataRow является фактическим хранилищем данных.

• Constraint— правило, которое задает допустимость хранения определенных данных в объекте DataTable. Объект Constraint используется для определения бизнес-правил объекта DataSet.

• DataRelation — описание навигационных связей между различными объектами DataTable. В большинстве случаев объект DataRelation сопровождается объектом Constraint, позволяющим строго задать отношение.

Как показано на рис. 5.1, внутри объекта DataSet может храниться коллекция объектов DataTable. В свою очередь внутри объектов DataTable хранятся коллекции объектов DataRow, DataColumn, Constraint и две коллекции объектов DataRelation.

Коллекция объектов DataRelation соответствует формирующим связь между объектами DataTable отношениям "родитель-потомок". Коллекция объектов DataRelation внутри объекта DataSet является агрегированным представлением всех объектов DataRelation во всех объектах DataTable.

DataSet 1' t DataTable

System. Data— содержит классы, которые входят в объект DataSet, а также • интерфейсы, использующиеся для определения управляемых поставщиков;

Глава 5. Создание объекта DataSet Глава Создание объекта DataSet В этой главе...

Что такое объект DataSet?

Заполнение объекта DataSet Определение схемы объекта DataSet Так что же представляет собой объект DataSet? Для начала попытайтесь отвлечься от сложностей отсоединенного режима доступа к данным. Объект DataSet — это про сто реляционная структура, хранимая в памяти. Но что это дает в контексте повсе дневной работы с объектом? Если вспомнить мои замечания о стоимости сетевого трафика и соединений с базой данных, то становится понятно, что хранение данных и правил, связанных с этими данными, на стороне клиента или на среднем уровне мо жет сократить общую стоимость применения правил к данным.

Что такое объект DataSet?

Если вы знакомы с другими API доступа к данным, то можете попытаться найти в них объекты, аналогичные объекту DataSet. He скрою, что этот поиск, скорее всего, завершится неудачей. Какое отношение имеет объект DataSet к программированию доступа к базе данных или, скажем, к XML? А может это что-то совершенно новое?

Объект DataSet — это:

• набор информации, извлеченной из базы данных;

доступ к этому набору осу ществляется в отсоединенном режиме;

• база данных, расположенная в памяти;

• сложная реляционная структура данных с встроенной поддержкой XML сериализации.

В самом деле, объект DataSet является всем этим одновременно. Роль объекта DataSet в ADO.NET заключается в предоставлении отсоединенного хранилища информации, извлеченной из базы данных, и в обеспечении для.NET возможно стей базы данных, хранимой в памяти. Объект DataSet— это простая коллекция структур данных, использующихся для организации отсоединенного хранилища информации.

Структура объекта DataSet Объект DataSet состоит из нескольких связанных друг с другом структур данных.

Концептуально он представляет собой полный набор реляционной информации.

Внутри объекта DataSet могут хранится пять объектов.

• DataTable — прямоугольный набор данных, организованный в столбцы и строки. Этот объект является аналогом объекта ADO Recordset и объекта OLE DB RowSet.

96 Часть //. Класс DataSet Часть II Класс DataSet Глава 5. Создание объекта DataSet Глава б, Типизированные классы DataSet Глава 7. Манипулирование объектом DataSet Глава 8. Обновление базы данных // Запрос к базе данных, string query = "SELECT Customer.CustomerlD, FirstName, LastName, " + HomePhone, Address, City, State, Zip, DOB, " + InvoiceNumber, InvoiceDate, FOB, PO, Terms " + " FROM Customer " •+• JOIN Invoice on Customer.CustomerlD = " + Invoice.CustomerlD " + " ORDER BY Customer.CustomerlD, Invoice.InvoicelD ";

// Подключение к базе данных и выполнение запроса.

SqlConnection conn = new SqlConnection( "Server=localhost;

" + "Database=ADONET;

" + "Integrated Security=true;

");

conn.Open();

// Создание объекта команды для выполнения запроса.

SqlConunand cmd = conn.CreateCommandf);

cmd.CommandText = query;

// Создание объекта DataReader.

SqlDataReader rdr = cmd.SxecuteReader(CommandBehavior.KeyInfo | CommandBehavior.CloseConnection);

// Использование объекта DataReader для создания // объектной модели нашего приложения.

customerList = new CustomerList(rdr);

// Закрытие объекта DataReader.

rdr.Close();

// Заполнение комбинированного списка.

cbCustomers.Items.AddRange{customerList.ToArray{));

// Установка фокуса на первом элементе // в комбинированном списке.

cbCustomers.Selectedlndex = 0;

Поскольку мы спроектировали достаточно неплохую объектную модель, ее реали зация в приложении достигается путем создания экземпляра класса CustomerList, конструктору которого передается объект DataReader. Полный исходный код прило жения можно загрузить с моего Web-узла по адресу: www.adoguy.com/book.

Резюме Дочитав книгу до этой страницы, вы уже должны были проникнуться идеей "пожарного шланга" и понять всю ее мощь. Так как в ADO.NET однонаправленный курсор представлен отдельным типом объекта (DataReader), считывание данных с по мощью "пожарного шланга" стало куда более простым занятием, чем в старых API доступа к данным. Кроме того, вы должны были узнать о способе использования объекта DataReader с целью обеспечения доступа к данным для ваших собственных классов. Во второй части этой книги мы воспользуемся полученными знаниями для того, чтобы рассмотреть, какую роль во всей этой схеме играет объект DataSet 94 Часть L Основы ADO. NET Класс InvoiceList Класс InvoiceList (как и класс C u s t o m e r L i s t ) — это простая оболочка клас са A r r a y L i s t, позволяющая иметь конструктор, которЬЕЙ принимает интерфейс IDataReader. Самая важная часть исходного кода данного класса — это часть, в которой реализуется добавление счета в список. Если посмотреть на запрос, который используется для извлечения информации из базы данных, можно заметить, что каждая строка резуль тирующего набора содержит сведения как о клиенте, так и о его счете. Следует отметить, что эти же сведения применяются и при добаалении в базу данных счета определенного клиента. В самом начале исходного кода конструктора я "кэширую" идентификационный номер клиента (CustomerlD). В цикле do... while я добавляю все счета клиентов до тех пор, пока идентификационный номер клиента текущей строки совпадает с "кэши рованным" идентификационным номером. Вы могли обратить внимание на то, что когда я заношу в "кэш" идентификационный номер клиента, я не делаю проверку на null.

В этом нет необходимости, так как идентификационный номер клиента — это первичный ключ соответствующей таблицы. Если идентификационный номер клиента был бы равен null, это означало бы наличие неожиданной и неисправимой ошибки, требующей гене рации исключения. Исходный код класса InvoiceList показан в листинге 4.16.

Листинг 4.16. Класс InvoiceList public class InvoiceList : ArrayList I public InvoiceList(IDataReader rdr) { // "Кэшируем" идентификатор текущего клиента.

Guid customerlD = rdr.GetGuidt rdr.GetOrdinal("CustomerlD") ) ;

// Добавляем счета до тех пор, // пока не изменится идентификатор клиента или // не будет достигнут конец объекта DataReader.

do Invoice inv = new Invoice(rdr);

Add(inv);

, while (rdr.Read() ss customerlD == rdr.GetGuidl rdr.GetOrdinal("CustomerlD")));

Код Windows-формы Написав запрос и разработав классы, использующиеся для представления данных, рассмотрим код, непосредственно применяющийся для создания объектной модели, как показано в листинге 4.17.

Листинг 4.17. Код Windows-формы // Необходимо для поддержки проектировщика Windows-форм.

InitializeComponent ();

Глава 4. Получение данных // Добавление клиентов в список, while (rdr.Read()) { Customer oust = new Customer(rdr);

Add(cust);

Класс Invoice Класс Invoice очень похож на класс Customer. Это простой класс, в котором со держится информация о счете клиента. Для представления списка счетов я решил применить элемент пользовательского интерфейса Listview, самый эффективный способ заполнения которого заключается в создании массива. Ответственность за созда ние массива я решил возложить на класс Invoice, разработав метод ToStringArray ().

Исходный код класса Invoice приведен в листинге 4.15.

Листинг 4.15. Класс Invoice public class Invoice public Invoice (IDataReader rdr) I // Если столбец не равен null, извлечь всю информацию // о счете клиента из объекта DataReader.

'InvoicelD");

InvoicelD = Field.GetGuid(rdr, 'InvoiceNumber' InvoiceNumber = Field.Getlnt32 (rdr, = Field.GetDateTime(rdr, 'InvoiceDate"), InvoiceDate = Field.GetString(rdr, •PO");

PO 'FOB");

= Field.GetString(rdr, FOB 'Terms") ;

Terms = Field.GetString(rdr, // Члены класса - открытые на случай, если нам // понадобится получить к ним прямой доступ.

InvoicelD;

public Quid InvoiceNumber;

public Int InvoiceDate;

public DateTirne public string PO;

FOB;

public string public string Terms;

public string[] ToStringArray() { // Создание массива строк, необходимого для более // эффективного заполнения объекта ListView.

string[] values = new string[6];

values[0] = InvoiceNumber.ToString();

values[1] = InvoiceDate.ToString{);

values[2] = PO;

values[3] = FOB;

values[4] = Terms;

return values;

Часть/. ОсновыADO.NET Листинг 4.13. Класс Customer public class Customer public Customer (IDataReader rdr) i // Если столбец не равен null, извлечь всю информацию // о клиенте из объекта DataReader.

CustomerlD = Field.GetGuid(rdr. "CustomerlD");

FieId.GetString(rdr, "LastName");

LastName = "FirstName");

FirstName = FieId.GetString(rdr, HomePhone = Field.GetString{rdr. "HomePhone");

"Address");

FieId.GetString{rdr, Address = City = Field.GetString{rdr, "City");

State = Field.GetString{rdr, "State");

Field.GetString{rdr. "Zip"};

Zip = DOB = Field.GetDateTime(rdr, "DOB"};

// Создать объект InvoiceList.

Invoices = new InvoiceList(rdr);

, // Члены класса, public Guid CustomerlD;

LastName;

public string FirstName;

public string public string HomePhone;

public string Address;

City;

public string State;

public string public string Zip;

public DateTime DOB;

public InvoiceList Invoices;

// Переопределение метода object.ToString() для обеспечения // вывода полного имени клиента в комбинированном списке, public override string ToString () • return LastName + FirstName;

Класс CustomerList Класс CustomerList — это тонкая "оболочка" класса ArrayList, необходимая для создания простого упорядоченного списка клиентов. Цель создания подобной оболочки состоит в том, чтобы иметь конструктор, принимающий в качестве аргумен та объект DataReader. Исходный код класса CustomerList приведен в листинге 4.14.

Листинг 4.14. Класс CustomerList // Оболочка класса ArrayList, поддерживающая создание // объекта CustomerList на основе объекта DataReader.

public class CustomerList : ArrayList public CustomerList (IDataReader rdr) t Глава 4. Получение данных Доступ к базе данных Получить всю информацию о клиентах и их счетах можно несколькими способами.

Во-первых, можно извлечь из базы данных всю таблицу Customer и всю таблицу Invoice (в которой хранится информация о счетах), после чего придется провести сопоставление каждого клиента его счетам. Согласитесь, что такая сложность является излишней.

Для того чтобы упростить задачу, я написал запрос, который возвращает всю необ ходимую информацию в одном результирующем наборе данных. Этот запрос выбира ет из базы данных все необходимые поля таблиц Customer и Invoice. Ниже приве дена SELECT-часть такого запроса:

SELECT Customer. Customer ID, FirstName, LastName, HornePhone, Address, C i t y, State, Z i p, DOB, InvoiceNumber, InvoiceDate, FOB, PO, Terms Обратите внимание, что единственным полем с полностью определенным именем является поле CustomerlD, так как оно существует более чем в одной таблице. Так как мы запрашиваем информацию из нескольких таблиц, их необходимо объединить, Ниже приведена JOiN-часть запроса:

FROM Customer JOIN Invoice on Customer.CustomerlD = Invoice.CustomerlD И, наконец, для того чтобы упорядочить извлеченные данные, нам необходимо доба вить предложение ORDER BY (иначе счета клиентов могут "перемешаться"): ORDER BY Customer. CustomerlD, Invoice. InvoicelD. А вот как выглядит наш запрос целиком:

SELECT Customer.CustomerlD, FirstName, LastName, HomePhone, A d d r e s s, City, State, Zip, DOB, InvoiceNumber, InvoiceDate, FOB, PO, Terms FROM Customer JOIN Invoice on Customer.CustomerlD = Invoice.CustomerlD ORPER BY Customer.CustomerlD, Invoice.InvocelD Объекты данных Одним из решений, принятых мною в самом начале разработки приложения, было создание классов для представления клиентов и счетов. Эти классы предназначены для простого хранения информации, извлеченной из базы данных. Поскольку для выполне ния последней операции я планировал использовать объект DataReader, эти классы по могли бы мне создать копию данных в оперативной памяти и я мог бы закрыть соеди нение с базой данных сразу же после считывания всей нужной информации.

Наконец, мне нужно было, чтобы объекты данных создавались на основе объекта DataReader и не зависели от конкретного управляемого поставщика. Для этого я вос пользовался конструкторами, принимающими в качестве аргумента интерфейс IDataReader и разрешающими при необходимости сменить поставщик данных.

Класс Customer Начнем с класса Customer. В нем должны содержаться демографические сведения о клиенте, взятые из базы данных. Кроме того, здесь должен храниться список всех счетов клиента, представленный классом invoiceList (см. листинг 4.16).

Когда я отлаживал этот класс, то понял, что для хранения информации о всех кли ентах мне необходимо воспользоваться комбинированным списком. Чтобы изменить вид имени клиента, я переопределил метод ToStringO класса Object так, чтобы он возвращал имя и фамилию клиента. Когда объект Customer добавляется в комбини рованный список, метод ToString () автоматически вызывается для определения ото бражаемого имени клиента. Исходный код класса Customer показан в листинге 4.13.

Часть I. Основы ADO.NET судят о том, использует ли база данных SQL Server в качестве ключа таблицы глобальный уникальный идентификатор (GUID).

• isUnique. Булево выражение, указывающее на уникальность хранящихся в столбце данных. Если значение столбца таблицы метаданных isKeyColumn равно true, то значение столбца IsUnique также будет равно true.

• IsKeyColumn. Булево выражение. Значение true указывает на то, что столбец является либо первичным ключом таблицы, либо его частью.

• IsAutoIncrement. Булево выражение, указывающее на автоматическое увели чение базой данных значения столбца на определенную величину.

• BaseSchemaName. Имя схемы в базе данных, содержащей таблицу столбца.

null, если это невозможно определить.

• BaseCatalogName. Имя каталога в базе данных, содержащей таблицу столбца.

null, если это невозможно определить.

BaseTableName. Имя таблицы базы данных, в которой содержится столбец, • null, если это невозможно определить.

• BaseColumnName. Имя столбца в таблице базы данных. Не зависит от имени столбца в объекте Command.

Если вам необходимо получить более подробные сведения об информационной схеме базы данных, обратитесь к разделу "Получение информационной схемы базы данных с помощью поставщика OLE DB" главы 2.

Создание простого приложения, взаимодействующего с базой данных В этом разделе мы постараемся объединить весь рассмотренный ранее материал в простом приложении Windows Forms, позволяющем просматривать счета клиентов (диалоговое окно приложения показано на рис. 4.2).

При желании вы можете загрузить исходный код этого приложения с моего Web узла по адресу: www.adoguy.com/book. В следующих разделах данной главы оста новимся на рассмотрении способа использования в приложении объекта DataRcadcr.

Рис. 4.2. Простое приложение Windows Forms Глава 4. Получение данных LastNarae :

Type: System.String IsUnique: False AllowDBNull: False Result Set Column:

InvoicelD :

Type: System.Guid IsUnique: False AllowDBNull: False Column:

InvoiceNumber :

Type: System.Int IsQnique: False AllowDBNull: False Column:

InvoiceDate :

Type: System.DateTime IsUnique: False AllowDBNull: False В столбцах схемы хранится различная информация о возвращенных данных В сле дующем списке перечислены все столбцы таблицы метаданных результирующего набора.

• ColumnName. Имя столбца, определенное поставщиком. Если имя столбца ука зано в объекте Command, используется это имя. С конкретной реализацией ме тода GecSchemaTable ( ) не связано никаких гарантий того, что имя столбца будет уникальным или что оно не будет равно null.

• ColunmOrdinal. Порядковый номер столбца. Отсчет порядковых номеров столбцов начинается с единицы.

• ColumnSize. Если тип данных имеет фиксированную длину, то здесь содержит ся максимальный размер столбца таблицы.

• NumericPrecision. Максимальная точность числа (если в столбце хранятся числовые данные). Если в столбце хранятся не числовые данные, то здесь со держится значение null.

• NumericScale. Количество знаков после запятой (если в столбце хранятся число вые данные). Если в столбце хранятся не числовые данные или числовые данные, которые не поддерживают дробные значения, то здесь содержится null.

DataType, CLR-тип столбца.

• • DbType. Тип столбца, специфичный для поставщика данных.

• isLong. Булево выражение, определяющее возможность хранения в столбце длинных двоичных данных (например, BLOB).

• AllowDBNull. Булево выражение, определяющее возможность хранения в столбце значения null.

• isReadOnly. Булево выражение, определяющее возможность изменения значе ния столбца.

• isRowVersion. Булево выражение. Значение true указывает на то, что в столбце хранится идентификатор строки. Как правило, по значению этого выражения Часть!. Основы ADO. NET 8Й метод GetSchemaTable ( ), который возвращает объект DataTable, содержащий ин формацию о типах данных результирующего набора. Более подробно объект DataTable рассматривается в главе 6. В листинге 4.12 приведен упрощенный пример извлечения информации о столбцах результирующего набора данных.

Листинг 4.12. Работа с метаданными объекта DataReader II Создание объекта команды.

SqlCoinmand cmd = conn. CreateCommand ( } ;

cmd.CommandText = "SELECT * FROM CUSTOMER\n" + "SELECT * FROM INVOICE";

// Создание объекта DataReader в результате выполнения запроса SqlDataReader rdr = cmd.ExecuteReader ( ) ;

// Итерация по всем результирующим наборам данных.

do // Получение метаданных результирующего набора // в виде объекта DataTable.

DataTable schema = rdr.GetSchemaTable {);

// Вывод заголовка 'Result Set'.

Console. WriteLine ("Result Set") ;

// Вывод информационной схемы, foreach (DataRow row in schema.Rows] Console.WriteLine(" Column:") Console.WriteLine(" {0} : " row["ColumnName Console.WriteLine(" Type: 10}", row["DataType"]);

Console.WriteLine(" IsUnique:

row["IsUnique"]};

Console.WriteLine(" AllowDBNull: {0} row["AllowDBNul1"]};

while ( r d r. N e x t R e s u l t ( ) ) ;

Если выполнить этот код, на консоль будут выведены метаданные таблиц клиентов и счетов. Ниже приведен отрывок из них:

Result Set Column:

CustomerlD :

Type: System.Guid IsUnique: False AllowDBNull: False Column:

FirstName :

Type: System.String IsUnique:. False AllowDBNull;

False Column:

Глава 4. Получение данных В большинстве остальных случаев имеет смысл использовать поведение команды CommandBehavior.Keylnfo. Блокировка базы данных без необходимости приводит к недоступности строк для других процессов, работающих с базой данных, и может стать причиной снижения производительности.

Что такое результирующие наборы данных ?

В ответ на запрос база данных формирует так называемый результирующий набор данных. Если в запросе требовалось возвратить только одну порцию информации (т.е.

единичный запрос), база данных сформирует один результирующий набор. В то же вре мя, при вызове хранимой процедуры или выполнении пакетного оператора база данных может сформировать несколько результирующих наборов. Например, при выполнении следующих операторов будет возвращено два результирующих набора данных:

SELECT * FROM CUSTOMER SELECT * FROM INVOICE Обработка множественных результирующих наборов данных Извлечение множества результирующих наборов данных из одного объекта Data Reader — вполне обыденное занятие. Для итерации по этому множеству исполь зуется метод объекта DataReader NextResultO. В отличие от метода Read ( }, он не должен вызываться перед началом считывания данных. Пример использования метода NextResult () приведен в листинге 4.11.

Листинг 4.11. Использование объекта DataReader для возврата множественных результи рующих наборов данных // Создание объекта команды.

SqlComraand cmd = conn.CreateConmand();

cmd.CommaridText = "SELECT * FROM CUSTOMER\n" + "SELECT * FROM INVOICE";

// Создание объекта DataReader в результате выполнения запроса.

SqlDataReader rdr = cmd.ExecuteReader();

// Итерация по всем результирующим наборам данных, do \ /I Итерация по всем записям результирующего набора, while (rdr.Read(}) ( Console.WriteLine(rdr[0]);

} } while (rdr.NextResult());

Как видно из этого примера, метод NextResult {} вызывается только после того, как мы закончили обработку первого результирующего набора данных.

Работа с метаданными объекта DataReader В большинстве случаев нам известен тип информации, извлекаемой из базы дан ных, но так бывает не всегда. К счастью, объект DataReader предоставляет сведения о типах данных для каждого результирующего набора. Все DataReader-классы имеют 86 Часть I Основы ADO.NET Этот вспомогательный класс предлагает более простой метод определения прием лемого значения для null-полей. Используя класс Field, я могу сделать код более удобочитаемым. Листинг 4.9 — яркий этому пример (для сравнения см. листинг 4.7).

Листинг 4.9. Использование класса F/e/d public invoice(IDataReader rdr) { // Если столбец не содержит значение n u l l, извлечь // хранящуюся в нем информацию.

InvoicelD = Field.GetGuidlrdr, "InvoicelD");

InvoiceNumber = F i e l d. G e t l n t ( r d r, "InvoiceNumber");

InvoiceDate = Field.GetDateTime(rdr, "InvoiceDate");

Terras = Field.GetString(rdr, " T e r m s " ) ;

PO = F i e l d. G e t S t r i n g ( r d r, " P O " ) ;

FOB = Field.GetString(rdr, "FOB");

Существуют единичные случаи, когда поле не может содержать значения null. Ти пичными примерами являются первичные ключи и обязательные поля. Фактически для определения подобных полей мы могли бы воспользоваться информационной схемой базы данных. Если информационная схема показывает, что поле является обязательным, проверка isDbNulK) — это простая трата времени. Если поле обязательно, однако ADO.NET сообщает, что оно является null-полем, генерируется исключение. Следует отметить, что в данном случае это весьма кстати, поскольку после возникновения такой неожиданной ситуации приложение вряд ли может продолжать нормально свою работу.

В любом случае если вы решите использовать мой класс Field, то можете обойти это требование, рискуя встретить null-строку в совершенно неожиданном месте.

Блокировка базы данных Каждая современная многопользовательская база данных поддерживает блокировку.

Блокировка записей — это способ сообщить базе данных о том, что считываемая поль зователем информация может быть вскоре изменена для предотвращения модификации последней другими системами или пользователями. Объект ADO.NET DataReader не поддерживает сложную блокировку базы данных. Блокировку считываемых записей можно произвести при вызове метода IDbCommand.ExecuteReader ( ). В этом случае блокировка записей осуществляется по умолчанию, как показано в листинге 4.10.

Листинг 4.10. Использование объекта DataReader с блокировкой записей базы данных // Записи базы данных блокируются.

SqlDataReader rdr = cmd.ExecuteReader();

// Блокировки записей базы данных не происходит.

SqlDataReader rdr = cmd.ExecuteReader(CommandBehavior.Keylnfo);

Блокировать записи при работе с объектом DataReader нужно по двум причинам.

• Записи будут модифицироваться, и вы не хотите, чтобы другие системы или пользователи изменяли их, пока вы не закончите внесение собственных изме нений.

• Вы не хотите, чтобы изменения вносились в базу данных во время анализа счи танной вами информации. При этом обычно речь идет о критической необхо димости в согласованности данных во время проведения статистического ана лиза или составления важных отчетов.

Глава 4. Получение данных if ( Irdr.lsDBNull {rdr.GetOrdinal ( "InvoiceNumber") ) ) InvoiceNumber = rdr.GetString ( rdr.GetOrdinal ("InvoiceNumber") } ;

if ( Irdr.lsDBNull (rdr.GetOrdinal ("InvoiceDate") ) I InvoiceDate = rdr.GetString ( rdr.GetOrdinal ("InvoiceDate") ) ;

if ( Irdr.lsDBNull {rdr.GetOrdinal ("Terms") ) ) I Terras = rdr. GetString (rdr.GetOrdinal ( "Terms") if ( !rdr.IsDBNull(rdr.GetOrdinal("PQ") ) ) { PO = rdr.GetString(rdr.GetOrdinal("PO") ) ;

} if (Irdr.lsDBNull {rdr.GetOrdinal ("FOB") ) ] { FOB = rdr.GetString(rdr.GetOrdinal ("FOB") ) ;

Достаточно много работы для простого копирования значений из шести полей!

Необходимо предложить более эффективное решение. Вы можете загрузить класс Field с моего Web-узла, расположенного по адресу: www.adoguy.com/book. В лис тинге 4.8 приведена часть его (класса Field) исходного кода.

Листинг 4.8. Класс Field public class Field -' // Доступ к полю осуществляется по его имени.

static public string GetString (iDataRecord rec, string fldname) I return GetString (rec, rec.GetOrdinal (fldname) ) ;

static public decimal GetDecimal (IDataRecord rec, string fldname) { return GetDecimal (rec, rec.GetOrdinal (fldname) ) 84 Часть I. Основы ADO.NET помогает более эффективно работать с запросами большого количества двоич ных данных, когда реально работа ведется только с их частью.

• SingleResult. В результате выполнения запроса ожидается возвращение толь ко одного набора данных.

• singleRow. В результате выполнения запроса ожидается возвращение только одной строки.

Работа с Null-столбцами Обеспечивающие безопасность типов get-методы объекта DataReader (например, GetString, GetBoolean и т.д.), удобно использовать при извлечении значений столбцов из объекта DataReader. В идеале их существование могло бы полностью удовлетворить разработчика. К сожалению, при считывании данных из столбца нет никаких гарантий того, что они там вообще существуют. Начинающих разработчиков это может сбить с толку. Например, если в таблице клиентов есть запись о клиенте, который не сообщил свой адрес, то это поле может иметь значение null. На самом деле содержимое этого поля полностью зависит от разработчика базы данных. В том случае, если он решит вообще не заполнять это поле в записи клиента (вместо того, чтобы заполнить его пустой строкой), оно будет иметь значение null.

Когда вы совершаете итерацию по записям в объекте DataReader, при попытке извлечь значение из null-поля (а точнее, при попытке преобразования null-поля в требуемый тип данных) ADO.NET сгенерирует исключение. Чтобы избежать подобной ситуации, объект DataReader имеет метод i s D B N u l l O, предназначен ный для индикации null-поля. Пример использования метода IsDBNullO пока зан в листинге 4.6.

Листинг 4.6. Работа с п и//-столбца ми // crr.d - это экземпляр класса SqlCominand.

SqlDataReader rdr = cmd.ExecuteReader();

while (rdr.Read()} // Вывод на консоль значения поля, если оно не равно null.

if ('rdr.IsDBNull(O)) { // Вывод на консоль первого поля строки.

Console.WEiteLine(rdr.GetString(0});

} Несмотря на то что этот метод работает, в большинстве приложений он приводит к созданию огромного и некрасивого кода. Взгляните на листинг 4.7, представляю щий собой пример типичного копирования содержимого объекта DataReader в неко торое локальное хранилище.

Листинг 4.7. Множественная проверка на ли//-значения в объекте DataReader public Invoice(IDataReader rdr} I // Если столбец не содержит значение null, извлечь // хранящуюся Ё нем информацию.

if (Irdr.IsDBNull(rdr.GetOrdinal("InvoicelD"))) InvoicelD = rdr.GetString(rdr.GetOrdinal("InvoicelD"));

Глава 4. Получение данных // Создание объекта DataReader в результате выполнения запроса.

SqlDataReader rdr = cmd.ExecuteReader();

// Итерация по всем строкам.

while {rdr.Read()) { // Функциональность этих строк кода идентична.

Console.WriteLine(rdr.GetDateTime( rdr.GetOrdinal("InvoiceDate")));

Console.WriteLine((DateTime) rdr["InvoiceDate"]);

} Методы GetOrdinal О и GetName {} объекта DataReader в некотором смысле допол няют друг друга, позволяя узнать порядковый номер и имя столбца, соответственно.

Параметры метода ExecuteReader В большинстве случаев вызов метода ExecuteReader объекта Command без пара метров является оптимальным решением. Тем не менее в более сложных сценариях метод ExecuteReader может быть вызван с флагом CommandBehavior, который из меняет способ создания объекта DataReader и влияет на содержащиеся в нем типы данных. Флаг CommandBehavior может принимать одно или более из перечисленных ниже значений (поддерживается их побитовая комбинация).

• Default. С данным значением не ассоциировано никакое специальное поведе ние. Следовательно, команда будет выполнена на сервере без установки/снятия блокировки строк;

соединение при этом также не подвергается какому-либо воздействию. Значение Default используется по умолчанию при вызове метода ExecuteReader () без указания флага CommandBehavior.

• CloseConnection. Когда объект DataReader достигает конца всех результи рующих наборов данных или попросту уничтожается, уничтожается также и ас социированный с ним объект Connection.

• Keylnfo. Запрошенная информация возвращается без блокировки каких-либо строк. Данное значение обычно применяется только при чтении, Предполагает ся, что результирующий набор данных, возвращенный объектом DataReader, не будет обновлен. Это очень важно, так как если не заблокировать строки во время работы с объектом DataReader, то любые из них (еще не извлеченные) могут быть изменены, что способно привести к весьма неожиданным результа там. К тому же управляемый поставщик SQL Server рассматривает значение Keylnfo как указание поместить предложение FOR BROWSE в выполняемую ко манду. При работе с SQL Server такое поведение может привести к различным побочным эффектам. Более подробно эта тема рассматривается в документации no SQL Server. • SchemaOnly. В объекте DataReader возвращается информационная схема базы данных, однако запрос при этом не выполняется и в базу данных не вносятся никакие изменения.

• SequentialAccess. Строки считываются последовательно на уровне столбцов, что удобно при использовании методов GetChars или GetBytes для извлече ния из строк объекта DataReader длинных двоичных данных. Если не использо вать это значение, то последние будут считаны в объект DataReader вне зависи мости от того, будут они использованы или нет. Таким образом, это значение См. msdn.microsoft.com/library/en-us/tsqlref/ts_sa-ses_9sfо.asp#_from_c^ause 82 Часть I. Основы ADO. WET" Поскольку индексатор возвращает объект, его можно привести к типу столбца или вызвать для этого один из get-методов объекта DataReader, обеспечивающих безопас ность типов, как показано в листинге 4.3.

Листинг 4.3. Использование get-метода объекта DafaReader, обеспечивающего безопасность типов // Создание объекта команды.

SqlCommand cmd = conn.CreateCommand () ;

cmd.CoramandText = "SELECT * FROM CUSTOMER";

// Создание объекта DataReader в результате выполнения запроса.

SqlDataReader rdr = cmd.ExecuteReader ( ) ;

// Итерация по всем строкам.

while (rdr. Read О ) ( Console. WriteLine( (string) rdr[0]);

// Эти две строки кода Console. WriteLine(rdr. GetString(O) );

// имеют одинаковую / / функциональность.

Обеспечивающие безопасность типов get-методы не производят никаких преобра зований — они просто осуществляют приведение типа. Если попытаться извлечь столбец, тип которого не соответствует типу, к которому осуществляется приведение, метод сгенерирует исключение InvalidCastException — такое же, которое бы воз никло в результате выполнения некорректной операции приведения типа. Если бы в предыдущем примере первый столбец имел целочисленный тип, было бы сгенери ровано исключение InvalidCastException. В тон случае, когда вам нужно провести именно преобразование типа, воспользуйтесь классом System. Convert, как показано в листинге 4.4.

Листинг 4.4. Использование класса System. Сол vert cmd.CoramandText = "SELECT * FROM PRODUCT";

// Создание объекта DataReader в результате выполнения запроса.

SqlDataReader rdr = cmd.ExecuteReader ();

// Итерация по всем строкам.

while (rdr. Read () ) { Console. W r i t e L i n e (Convert. ToString(rdr["Price"] ) ) ;

Bee get-методы, обеспечивающие безопасность типов, требуют передачи в качестве параметра порядкового номера столбца, что, естественно, менее удобно, чем исполь зование его имени. Альтернативным способом получения порядкового номера столбца является применение метода GetOrdinal ( ), как показано в листинге 4.5.

Листинг 4.5. Использование метода GetOrdinal / I Создание объекта команды.

SqlCommand cmd = conn. CreateCommand ( ) ;

cmd.CommandText = "SELECT * FROM INVOICE";

Глава 4. Получение данных SqlComnand cmd - new SqlCommand();

// Все правильно.

SqlDataReader rdr = cmd.ExecuteReader(};

// Неверный код (не будет компилироваться).

SqlDataReader rdr = new SqlDataReaderО;

Функциональность объекта DataReader Постараемся разобраться в функциональности, заложенной в объект DataReader.

В главе 1 говорилось о возможности работать с данными в отсоединенном режиме, однако это совершенно не применимо к объекту DataReader. На всем протяжении его жизни (при чтении или даже просто при просмотре строк) соединение должно оста ваться открытым. Действительно, объект DataReader очень напоминает своих предше ственников, предполагавших обработку данных в подсоединенном режиме.

Так как при работе с объектом DataReader соединение остается открытым, он мо жет не извлекать за один раз все данные, полученные в результате выполнения запро са. В контексте проектов, ориентированных на работу со складом данных или боль шой корпоративной базой данных, это имеет решающее значение. Действительно, ведь требование вернуть за один раз миллион записей, которые должны быть разме щены в памяти, — это сущее безумие. Объект DataReader позволяет оптимальным способом решить эту проблему, загружая в память за один раз небольшую часть ре зультирующего набора данных.

Поскольку объект DataReader предполагает работу с данными в подсоединенном режиме, некоторые разработчики не решаются его использовать, отдавая предпоч тение объекту DataSet. Более подробно выбор между использованием объектов DataReader и DataSet обсуждается в главе 7.

Доступ к данным с помощью объекта DataReader Как было показано в листинге 4.1, объект DataReader позволяет осуществлять доступ к отдельным столбцам, представляя результирующий набор данных в виде массива.

Посредством соответствующего индексатора ([ ]) указывается либо порядковый номер столбца, либо его имя (листинг 4.2).

Листинг 4.2. Доступ к столбцам результирующего набора данных с помощью объекта DataReader II Создание объекта команды.

SqlCommand cmd = conn.CreateCorranand();

cmd.CommandText - "SELECT * FROM CUSTOMER";

// Создание объекта DataReader в результате выполнения запроса.

SqlDataReader rdr = cmd.ExecuteReader();

// Итерация по всем строкам, while (rdr.Read()) { Console.WriteLine(rdr[0]);

// Эти две строки кода Console.WriteLine(rdr["CustomerlD"]);

// имеют одинаковую // функциональность.

Часть /. Основы ADO.NET WHERE Customer.LastName = 'Maddux ORDER BY InvoiceDate DESC Во всех приведенных выше примерах используется синтаксис SQL-92. Как прави ло, все разработчики баз данных (включая Microsoft, IBM и Oracle) следуют этому синтаксису, несмотря на то что каждый из них создал собственное расширение языка SQL (например, T-SQL для SQL Server и PL/SQL для Oracle). Вообще говоря, написа ние универсального SQL-кода — очень сложное занятие. Если вам крайне необходи мо написать именно такой код, будьте готовы к снижению производительности вашей системы, поскольку каждый разработчик баз данных реализует механизм выполнения SQL-операторов по-своему.

Объект DataReader После того как вы научились создавать запросы, пришло время научиться их выпол нять, используя для этого средства ADO.NET. В отличие от большинства других интер фейсов доступа к данным, в которых для считывания и изменения данных используется один и тот же объект, в ADO.NET операции чтения и изменения данных разделены.

В частности, большая часть вашего кода будет просто считывать информацию из базы данных и представлять ее пользователю, используя для этого основной объект ADO.NET, предназначенный исключительно для чтения данных, — объект DataReader.

Объект DataReader обеспечивает доступ к данным, извлеченным в результате вы полнения SQL-запроса, в режиме только для чтения. Объект DataReader представлен соответствующим классом— OleDbDataReader, SqlDataReader, OracelDataReader и OdbcDataReader — в каждом из управляемых поставщиков. Пример использования класса SqlDataReader приведен в листинге 4.1.

Листинг 4.1. Использование класса Sq/Dafafleacter // Создание объекта команды.

SqlCommand cmd = conn.CreateCommand(};

cmd.CommandText = "SELECT * FROM CUSTOMER";

// Создание объекта DataReader в результате выполнения запроса.

SqlDataReader rdr = cmd.ExecuteReader();

// Итерация по всем строкам.

while (rdr.Read{)) I Console.WriteLine(rdr[0]);

В этом примере приведен наиболее простой способ использования объекта DataReader. Для перемещения по результирующему набору данных предназначен метод Read(). Обратите внимание, что метод Re ad О обязательно должен быть вызван один раз еще до считывания первой записи. Благодаря этому объект DataReader более устой чив к ошибкам, так как перемещение строкового курсора и проверка того, достигнут ли конец результирующего набора данных, производится в одном операторе. По достиже нии конца результирующего набора данных метод Read () возвратит false.

Создание объекта DataReader Объект DataReader не может быть создан напрямую из клиентского кода — он соз дается объектом команды во время ее выполнения с помощью метода iDbCommand.

ExecuteReader ( ). Следует отметить, что конструктор DataReader-класса скрыт, для того чтобы предотвратить создание нового объекта DataReader:

Глава 4. Получение данных SELSECT FirstName, LastName, HomePhone FROM Customer WHERE State = 'MA' Еще одним из часто использующихся предложений является JOIN, позволяющее из влекать связанную информацию из разных таблиц. Так, предложение JOIN позволит нам получить не только сведения о клиенте, но и информацию о каждом соответствую щем ему счете. Ниже приведен простой пример использования предложения JOIN:

SELECT FirstName, LastName, HomePhone, InvoiceNumber FROM Customer JOIN Invoice ON Customer.CustomerlD = Invoice.CustomerID В этом примере таблицы Customer и Invoice объединяются с помощью общего для обоих поля CustomerlD. При желании можно добавить еще одно предложение JOIN для объединения таблиц Invoice и Invoiceltem:

SELECT FirstName, LastName, HomePhone, InvoiceNumber, Quantity, ProductID FROM Customer JOIN Invoice ON Customer.CustomerlD = Invoice.CustomerlD JOIN Invoiceltem ON Invoice.InvoicelD = Invoiceltem,InvoicalD Для того чтобы ограничить поиск только счетами клиентов с фамилией Maddux, добавим предложение WHERE:

SELECT FirstName, LastName, HomePhone, InvoiceNumber, Quantity, ProductID FROM Customer JOIN Invoice ON Customer.CustomerlD - Invoice.CustomerlD JOIN Invoiceltem ON Invoice.InvoicelD = Invoiceltem.InvoicelD WHERE Customer.LastName = 'Maddux' И, наконец, применим предложение ORDER BY для сортировки возвращаемого ре зультата по дате оформления счета. Для этого добавим ORDER BY в коней оператора SELECT и укажем столбец, по которому будет производиться сортировка, например:

SELECT FirstName, LastName, HomePhone, InvoiceNumber, Quantity, ProductID FROM Customer JOIN Invoice ON Customer.CustomerlD - Invoice.CustomerlD JOIN Invoiceltem^ ON Invoice.InvoicelD = Invoiceltem.InvoicelD WHERE Customer.LastName = 'Maddux' ORDER ВУ InvoiceDate Если необходимо сортировать по убыванию, а не по возрастанию (стандартный порядок сортировки), добавьте в конец оператора ключевое слово DESC:

SELECT FirstName, LastName, HomePhone, InvoiceNumber, Quantity, ProductID FROM Customer JOIN Invoice ON Customer.CustomerlD = Invoice.CustomerlD JOIN Invoiceltem ON Invoice.InvoicelD = Invoiceltem.InvoicelD 78 Часть l Основы ADO.NET о языке SQL, обратитесь к Web-узлу w w w. s q l. o r g. Кроме того, стоит обратить вни мание на замечательные книги Джо Келко (Joe Celko): Instant SQL Programming (ISBN:

1874416509) и, для более опытных SQL-программистов, SQL for Smarties: Advanced SQL Programming (ISBN: 1558605762).

Чтобы считывать данные с помощью SQL-запроса, необходимо досконально изу чить возможности оператора SELECT, который используется для извлечения из базы данных набора информации. Предположим, что у нас есть четыре таблицы, показан ные на рис. 4,1 (все они взяты из базы данных, использующейся в примерах этой книги — см. Web-узел ADOGuy по адресу: www. adoguy. com/book).

Рис. 4.1. Таблицы, использующиеся в примерах этой книги Ниже приведен пример простейшего запроса к базе данных:

SELECT * FROM Customer В результате выполнения этого запроса из базы данных извлекаются все строки таблицы Customer. Символ звездочки (*) — это маска, которая указывает базе дан ных на необходимость извлечения всех столбцов таблицы. Предложение FROM опреде ляет таблицу базы данных, из которой нужно считать информацию;

в нашем случае это таблица Customer.

В большинстве случаев нам не нужны все строки таблицы. Одним из распростра ненных требований к извлекаемым из таблицы данным является их сортировка в оп ределенном порядке. В этом случае символ звездочки заменяется именами столбцов, которые необходимо извлечь. В следующем примере база данных возвратит столбцы FirstNarae, LastName и Phone таблицы Customer:

SELECT FirstName, LastName, Phone FROM Customer SQL поддерживает функции агрегирования, такие как COUNT (используется для подсчета записей, которые были бы возвращены в результате выполнения запроса) и МАХ (используется для получения максимального значения определенного поля):

SELECT COUNT(*) FROM Customer SELECT MAX(Price) FROM Product Кроме того, часто из таблицы необходимо извлечь только подмножество данных.

Для этого используется предложение WHERE. Например, в результате выполнения сле дующего запроса из базы данных будут извлечены строки таблицы Customer, содер жащие информацию о клиентах, проживающих в штате Массачусетс:

Глава 4. Получение данных Глава Получение данных В этой главе...

Чтение данных Объект DataReader Создание простого приложения, взаимодействующего с базой данных Моя первая работа в качестве программиста заключалась в написании отчетов для давно забытой реляционной базы данных FMS-80 в системе СР/М 1. В те дни написа ние отчетов состояло в простом считывании информации из базы данных и выводе на консоль множества строк текста. Несмотря на то что в современных системах написа ние отчетов для баз данных стало гораздо сложнее, в корне так ничего и не измени лось — сначала данные откуда-то считываются, а затем куда-то выводятся.

Одним из первых правил, которые я использовал при программировании доступа к базам данных, являлось правило "пожарного шланга", применявшееся для уменьше ния нагрузки на СУБД. "Пожарный шланг" (fire hose) — это термин, который обозна чал запрос у базы данных однонаправленного курсора. Сообщив базе данных о своих намерениях, можно ускорить процесс чтения данных и уменьшить объем использо вания ресурсов. В ADO.NET концепция однонаправленного курсора представлена объектом DataReader. Именно о нем и пойдет речь в этой главе.

Чтение данных Чтение данных и составление отчетов — наиболее часто встречающиеся задачи разработчика приложений, основанных на взаимодействии с базой данных. Вне зави симости от того, предназначена ваша программа для просмотра котировок акций, вы дачи списка пациентов или составления отчета о месячных продажах, чтение данных и составление отчетов должны быть наиболее простыми ее функциями. К сожалению, самой трудной частью процесса чтения информации из базы данных является создание соответствующего запроса.

Язык структурированных запросов (Structured Query Language — SQL) — это язык баз данных. SQL-86, SQL-92 и SQL-99 — стандарты языка SQL, разработанные националь ным институтом стандартизации США (American National Standards Institute — ANSI) и использующиеся большинством производителей баз данных. К тому же язык SQL используется для извлечения информации из всех упраапяемых поставщиков Microsoft.

Приведенные в этой книге фрагменты SQL-кода основаны на стандарте SQL-92, Краткий обзор SQL-оператора SELECT Язык SQL — слишком обширная тема для того, чтобы рассматривать ее на страни цах этой книги, тем не менее я попытаюсь кратко рассказать вам об основах построе ния запросов к базе данных. Для того чтобы получить более подробную информацию ' Вот видите какой я старый и мудрый! Для того чтобы познакомиться с системой СР/М, обратитесь по адресу: j f r a c e. s o u r c e f o r g e. n e t / a p p l e t C P M. h t n i l.

76 Часть I. Основы ADO.NET // Перебор всех строк заданного результирующего набора.

while (rdr.ReadO ) { Console.WriteLine(rdr[0]);

} // После просмотра первого результирующего набора // данных переходим к следующему результирующему набору.

} while (rdr.NextResultO};

Резюме Несмотря на то что ADO.NET ориентирована на работу с данными в отсоединенном режиме, иногда нам все же нужно подключаться к базе данных. Приведенная в этой главе информация будет использоваться в каждом написанном вами приложении — способ, позволяющий избежать выполнения команд еще не придуман. В последующих главах этой книги мы сконцентрируемся на обработке полученных данных.

Глава 3. Выполнение команд В данном примере для выполнения пакетного запроса был использован метод ExecuteNonQuery(). Хотя указанный метод эффективен, он, к сожалению, не обеспечивает обработку ошибок. Для разрешения этой проблемы вам нужно собст венноручно добавить SQL-код с проверкой ошибок и (необязательной) поддержкой транзакций:

BEGIN TRAN INSERT INTO Customer (CustomerID, LastName, FirstName, Phone, Zip) VALUES (newid(), 'Smoltz1, 'John', '503-432-4565', '12345');

IF @@ERROR <> BEGIN ROLLBACK TRAN RETURN END INSERT INTO Invoice (InvoicelD, InvoiceNumber, InvoiceDate, Terms] VALUES (newid(), 423456', '05/01/2001', 'Net 20');

IF @@ERROR О О BEGIN ROLLBACK TRAN RETURN END COMMIT TRAN Теперь наш пакетный запрос будет выполнять две задачи: осуществлять вставку новой информации в базу данных и проводить проверку на наличие ошибок. Если во время выполнения транзакции произошел сбой, она будет отклонена, в противном случае — принята. Пакетный запрос — это не что иное, как несколько запросов, объединенных в одну команду. Поскольку ADO.NET поддерживает множественные результирующие наборы данных, нет никакой серьезной причины не использовать пакетные запросы (листинг 3.19).

Листинг 3.19. Получение множественных результирующих наборов данных с помощью объекта DataReader /I Создание команды, включающей в себя два запроса SELECT // и возвращающей два результирующих набора данных.

SqlCommand cmd = conn.CreateConunand() ;

ciud.CommandText =* "SELECT * FROM Customer;

" + " SELECT * FROM Invoice;

";

// Создание объекта DataReader для навигации по // результирующим наборам данных.

SqlDataReader rdr = cmd.ExecuteReader() ;

// Перебор всех строк в каждом результирующем // наборе данных.

do •:

Часть /. Основы ADQ.NET INSERT INTO Invoice (InvoicelD, InvoiceNumber, InvoiceDate, Terms) VALUES ( n e w i d ( ), ' 1 2 3 4 5 6 ', ' 0 5 / 0 1 / 2 0 0 1 ', 'Net 2 0 ' ) ;

В листинге 3.17 приведен ADO.NET-код, в котором используются обычные (а не пакетные) запросы.

Листинг 3.17. Использование обычных запросов string sQueryl = "INSERT INTO Customer " + "(CustomerlD, LastName, FirstName, Phone, Zip} " + "VALUES (newidO, 'Smoltz', 'John'," + "'503-432-4565', '12345');

";

string sQuery2 = "INSERT INTO Customer " + " (CustomerlD, LastName, FirstName, Phone, Zip) " + "VALUES (newid(), 'Maddux, 'Greg'," + "'503-432-4566', '12345');

";

// Подключение к базе данных.

SqlCormection sqlconn = new SqlConnection();

SqlCommand sqlcmd = sqlconn.CreateCommanci (};

sqlcmd.CommandType = CommandType. Text ;

// Первый запрос.

sqlcmd. CommandText = sQueryl;

sqlcmd. ExecuteNonQuery ( ;

) // Второй запрос.

sqlcmd. CommandText = sQuery2;

sqlcmd. ExecuteNonQuery () ;

Несмотря на то что этот код будет выполняться, он неэффективен, так как требует трех обращений к базе данных. Его можно упростить, воспользовавшись пакетными запросами, как показано в листинге 3.18.

Листинг 3.18. Использование пакетных запросов string sQuery = "INSERT INTO Customer " + "(CustomerlD, LastName, FirstName, Phone, Zip) " + "VALUES (newid(), 'Smoltz', 'John1, " + "'503-432-4565', 42345');

" + "INSERT INTO Customer " + " (CustomerlD, LastName, FirstName, Phone, Zip) " + "VALUES (newidf), 'Maddux', 'Greg', " + "'503-432-4566', '12345') ;

";

SqlConnection sqlconn = new SqlConnection {);

SqlCommand sqlcmd = sqlconn. CreateCommand {) sqlcmd.CommandType = CommandType. Text ;

// Пакетный запрос.

sqlcmd. CommandText = sQuery;

sqlcmd. ExecuteNonQuery () ;

Глава З. Выполнение команд "(InvoicelD, invoiceNumber, InvoiceDate, Terms) " + "VALUES (newidi), '123456', '05/01/2001',"+ "'Net 20'};

";

cmd.ExecuteNonQuery();

} catch(Exception) { // Отклонить транзакцию то точки сохранения // момента внесения в базу данных информации о // новом клиенте.

cmd.Transaction.Rollback("New Customer");

// Если выполнение было передано этому оператору, // принять транзакцию.

cnid.Transaction. Commit {} ;

} catch{Exception ex) t cmd.Transaction.Rollback( );

Console.WriteLine("Command f a i l e d : " + " { 0 } \ n T r a n s a c t i o n Rolled back", ex.Message);

} В этом коде мы создали точку сохранения с именем "New Customer" (Новый кли ент). Если занесение в базу данных информации о новом клиенте прошло успешно, однако во время создания нового счета произошла ошибка, нам не хотелось бы терять уже внесенные в базу данных сведения о новом клиенте. Поэтому мы отклоняем транзакцию вплоть до точки сохранения и затем принимаем ее.

Службы Enterprise Services и СОМ+ Иногда транзакции баз данных яапяются довольно масштабными, включающими в себя выполнение ряда операций на нескольких серверах. Для поддержки подобных транзакций в.NET предусмотрены службы Enterprise Services, которые являются.NET оболочками для компонентов СОМ-К Следует отметить, что в этой книге службы Enter prise Services не описываются. Если вам необходима какая-либо дополнительная инфор мация по программированию транзакций, советую обратиться к великолепной книге Тима Эвальда (Tim Ewald) Transactional СОМ+ Programming или к его статье "СОМ+ Integration: How.NET Enterprise Services Can Help You Build Distributed Applications", ко торую можно найти на Web-узле MSDN по адресу: msdn.rnicrosoft.eom/n.sdnmag/ issues/01/10/complus/complus.asp.

Пакетные запросы При выполнении команд базы данных часто приходится проводить целую серию различных операций. В этом случае вы можете просто выполнять команды одну за другой, однако для этого потребуются многочисленные обращения к базе данных (по одному для каждой команды). С целью оптимизации подобных операций используют ся так называемые пакетные запросы. Предположим, что нам необходимо выполнить следующие действия:

INSERT INTO Customer (CustomerlD, LastName, FirstName, Phone, Z i p ) VALUES ( n e w i d ( ), ' S m o l t z ', ' J o h n ', ' 5 0 3 - 4 3 2 - 4 5 6 5 ', '12345');

72 Часть I. Основы ADQ.NET • RepeatableRead. Транзакция не может считывать данные, которыми манипу лируют другие незавершенные транзакции. Иными словами, данные, которыми манипулирует транзакция, на время ее работы блокируются.

• Serializable. Транзакция полностью изолирована от других транзакций.

Несмотря на то что перечисление IsolationLevel имеет атрибут Flags Attribute, позволяющий использовать комбинацию нескольких уровней изоляции, подобная функциональность не поддерживается в силу специфики элементов перечисления.

Использующийся по умолчанию уровень изоляции ReadCommitted, конечно же, не может идеально подходить для каждого случая.

Точки сохранения в транзакциях SQL Server При внесении множественных изменений в базу данных SQL Server может воз никнуть ситуация, когда предпочтительнее отклонить не всю транзакцию, а только ее часть. Текущие версии SQL Server не поддерживают вложенные транзакции, однако в них реализована концепция точек сохранения, с помощью которой можно осущест вить подобную функциональность. Точка сохранения — это средство SQL Server, по зволяющее производить частичное отклонение транзакции. Другими словами, точка сохранения представляет собой "закладку", определяемую посредством вызова метода Save класса SqlTransaction в любом месте транзакции, в которое вы хотели бы вернуться в случае ее отклонения (без отмены всей транзакции). Пример создания точки сохранения и частичного отклонения транзакции приведен в листинге 3.16.

Листинг 3.16. Частичное отклонение транзакции // Открытие соединения.

SqlConnection conn = new SqlConnection( "Server-localhost;

" + "Database=ADQNET;

" + "Integrated Security=true;

"};

conn.Open();

// Создание команды.

SqlCoitimand cmd = conn.CreateCornmanci () ;

// Создание транзакции, cmd.Transaction = conn.BeginTransaction(IsolationLevel.ReadCommitted);

try // Попытка добавить в базу данных сведения о новом клиенте.

crad.CommandText = "INSERT INTO Customer " + "(CustomerlD, LastName, FirstName, Phone, Zip) " + "VALUES {newidO/ 'Smoltz', 'John'," + "'503-432-4565', '12345');

";

cmd.ExecuteNonQuery();

// Создание точки сохранения.

cmd.Transaction.Save("New Customer");

try ( // Попытка добавить в базу данных сведения о новом счете.

cmd.CommandText = "INSERT INTO Invoice " + Глава 3. Выполнение команд Функционально этот код ничем не отличается от SQL-кода, приведенного ранее в этом разделе. Недостаток использования клиентских транзакций заключается в том, что они требуют гораздо больше обращений к базе данных, чем обычный SQL-код.

Именно поэтому предпочтение отдается серверным транзакциям (см. SQL-код перед листингом 3.14) как более эффективным по сравнению с клиентскими транзакциями.

Использование последних (см. листинг 3.15) может быть оправдано необходимостью связывания транзакций базы данных с какой-то внешней системой. Например, если ваш код одновременно сохраняет изменения в базе данных и обновляет Web-службу, сбой в последней операции может заставить вас отменить транзакцию базы данных со стороны клиента.

Если необходимо обеспечить всего лишь поддержку транзакций, то, вероятно, стоит использовать серверные транзакции. С другой стороны, с целью абстрагирования от специфики реализации конкретного ядра базы данных все транзакции можно выпол нять на стороне клиента. При этом следует помнить, что использование транзакций только на стороне клиента может существенно ухудшить производительность системы.

Как вы уже, наверняка, заметили, транзакция создается путем вызова метода BeginTransaction класса соединения. В результате вызова метода создается объект транзакции. После этого ни одна из команд, ассоциированных с данным соединени ем, не будет принята до вызова метода класса транзакции Commit. В случае возникно вении ошибки для отмены всех команд, выполненных с момента создания транзак ции, может быть вызван метод Rollback.

После начала выполнения транзакции ее нужно либо принять, либо отклонить.

Если этого не сделать, то во время освобождения ресурсов транзакции она будет ав томатически отклонена. Другими словами, транзакция автоматически отклоняется при закрытии соединения или освобождении занятых им ресурсов, а также при уничтоже нии объекта транзакции сборщиком мусора. Поскольку об этой особенности в доку ментации ничего не говорится, на нее не стоит обращать внимание — в конце концов в следующей версии.NET все может происходить по-другому. Кроме того, уничтоже ние объекта (вызов метода Finalize) может произойти не сразу, что зависит от осо бенностей реализации сборщика мусора. Таким образом, если вы не хотите сохранять изменения в базе данных, немедленно отмените их.

Уровни изоляции Перед началом выполнения транзакции необходимо определить ее уровень изоля ции — способ блокировки базы данных во время работы транзакции. Ниже перечис лены поддерживаемые уровни изоляции транзакций.

• Chaos. Транзакция не может перезаписать другие не принятые транзакции с большим уровнем изоляции, но может перезаписать изменения, внесенные без использования транзакций. Поскольку данные не блокируются, записи, внесенные во время работы транзакции, могут быть перезаписаны после ее принятия.

• ReadCoramitted. Транзакция не может считать данные, которыми манипулиру ет другая транзакция. Этот уровень позволяет избежать недействительных ре зультатов чтения, так как данные, которыми манипулирует транзакция,, на вре мя ее работы блокируются.

• ReadUncommitted. Транзакция может считывать данные, которыми манипули рует другая транзакция. Выбор этого уровня изоляции способен привести к не действительным результатам чтения и появлению фантомных строк, поскольку после чтения информации, внесенной в базу данных в результате выполнения той или иной транзакции, последняя может быть отменена.

70 Часть /. Основы ADO.NET // Закрытие соединения, conn,Close() ;

// Если значение переменной r e s u l t равно 0, команда была // принята, и мы можем возвратить true.

int result = ( i n t ) crad.Parameters["ERETURN"].Value;

return (result == 0 ) ;

J ADO.NET обеспечивает такую же степень Koi-проля над базой данных, какая дости гается при использовании обычного кода SQL. В ADO.NET транзакция представляется специальным объектом (экземпляром класса SqlTransaction, oleDbTransaction или OdbcTransaction). В листинге 3.15 приведен пример, аналогичный представленному выше фрагменту SQL-кода.

Листинг 3.15. Использование транзакций // Открытие соединения.

SqlConnection conn = new SqlConnection( "Server=localhost;

" + "Database=ADONET;

" + "Integrated Security=true;

");

conn.Open{);

// Создание команды.

SqlCommand cmd = conn.CreateCommand();

// Создание транзакции.

cmd.Transaction = conn.BeginTransaction();

try // Попытка добавить в базу данных сведения о новом клиенте, cmd.CommandText = @"INSERT INTO Customer (CustomerlD, LastName, FirstName, Phone, Zip) VALUES (newidO, 'Smoltz', 'John', '503-432-4565', •12345');

";

end.ExecuteNonQuery();

// Попытка добавить в базу данных сведения о новом счете.

cmd.ComraandText = @"INSERT INTO Invoice (InvoicelD, InvoiceNurrtber, InvoiceDate, Terms) VALUES (newidO, ' 123456', '05/01/2001', 'Net 201);

";

cmd.ExecuteNonQuery();

// Если выполнение программы было передано этому // оператору, подтверждаем транзакцию, cmd.Transaction.Commit(};

catch(Exception ex) cmd.Transaction.Rollback.! ) ;

Console.WriteLine("Command failed: " + ex.Message + "\nTransaction Rolled back");

Глава З. Выполнение команд которые либо выполняются все вместе, либо не выполняются вообще. Обычно это делается с помощью хранимой процедуры или набора SQL-операторов. Например, в следующем фрагменте SQL-кода продемонстрировано использование транзакции для восстановления системы, оказавшейся в несогласованном состоянии.

BEGIN TRAN INSERT INTO Customer (CustomerID, LastName, FirstName, Phone, Zip) 1 VALUES (newidf), 'Smoltz, 'John, '503-432-4565', '12345');

IF @@ERROR <> BEGIN ROLLBACK TRAN RETURN (TERROR END INSERT INTO Invoice (InvoicelD, InvoiceNumber, InvoiceDate, Terms) VALUES (newidO, 423456', '05/01/2001', 'Net 20');

IF @@ERROR О О BEGIN ROLLBACK TRAN RETURN @@ERROR END COMMIT TRAN RETURN В этом запросе осуществляется попытка добавить в базу данных сведения о новом клиенте и о новом счете. В случае возникновения проблемы (например, такой иден тификационный номер клиента уже используется) весь набор команд будет отклонен (так, как если бы они вообще никогда не выполнялись). Если же все три команды выполнятся успешно, то транзакция будет принята, а внесенные в базу данных сведе ния зафиксированы. Для того чтобы убедиться в том, что транзакция была принята, следует проанализировать код возврата, как показано в листинге 3.14 (0 означает при нятие транзакции).

Листинг 3.14. Вызов хранимой процедуры без использования транзакции // Этот метод можно использовать для выполнения команды // и возвращения сведений о том, была она принята или нет.

bool RunCornmand (SqlConnection conn, string sqlStatement) { // Создание команды.

SqlCommand cmd = conn.CreateCommand();

cmd.CommandText = sqlStatement;

// Определение параметра для возвращаемого значения, cmd.Parameters.Add("QRETURN", DbType.Int32>.Direction = ParameterDirection.ReturnValue;

// Открытие соединения, conn.Open();

// Выполнение команды.

cmd.ExecuteScalar{};

68 Часть i. Основы ADO.NET cmd.CommandText * string.Format(8"SELECT * FROM Customer WHERE CustomerlD = {0}", custID);

// Создание команд» с помощью объекта StringBuilder.

StringBuilder bldr « new StringBuilder();

bldr.Append("SELECT * FROM Customer WHERE CustomerlD = ");

bldr.Append(custID);

cmd.CommandText = bldr.ToStringO;

Обычно управляемые поставщики попросту принимают команду и формируют из нее строку для отправки серверу баз данных. Использование параметров может при вести к нежелательному разрастанию программного кода и, возможно, даже к сниже нию производительности.

Так зачем же вообще использовать объекты параметров? В конце концов, мы мо жем с тем же успехом вызвать хранимую процедуру или параметризированный запрос с помошью кода SQL, как показано в листинге 3.13.

Листинг 3.13. Вызов хранимой процедуры без использования объектов параметров // Подсоединение к базе данных.

SqlConnection conn = new SqlConnection( "Server=lccalhost;

" + "Database=master;

" + "Integrated Security=true;

");

conn.Open();

// Создание команды для вызова хранимой процедуры.

SqlCoromand cmd = conn.CreateCommand();

cmd.CommandText = "EXEC sp_storedprocedures NULL, 'dbo 1, NULL";

// Выполнение хранимой процедуры.

SqlDataReader rdr = cmd.ExecuteReader();

// Освобождение ресурсов, conn.Close();

Дело в том, что все это справедливо только для входных параметров. Если же не обходимо извлечь информацию из базы данных (отличную от результирующих набо ров данных), без объектов параметров не обойтись. Простое эмпирическое правило гласит, что объекты параметров используются для обработки выходных, входных выходных параметров, а также возвращаемых значений. Если же вы имеете дело лишь с входными параметрами, то, вероятно, зря тратите усилия, используя объекты пара метров вместо строк.

Транзакции и ADO.NET Одна из наиболее распространенных проблем программирования взаимодействия с базами данных связана с необходимостью обеспечения совместного выполнения не скольких дискретных операций. Например, если вы разрабатываете систему управле ния медицинскими карточками и ваша база данных не смогла сохранить информацию о новом пациенте, сумев при этом сохранить сведения о его визите, система будет на ходиться в несогласованном состоянии. Для решения подобных задач и существуют транзакции. Транзакция базы данных позволяет создать оболочку для набора операций, Глава 3. Выполнение команд Приведенный выше параметризированный запрос позволяет узнать количество за писей, соответствующих критерию, определенному параметром запроса.

Параметры в параметризированных запросах используются таким же образом, как и в хранимых процедурах с той лишь разницей, что вам не нужно создавать параметр для возвращаемого значения — в параметризированных запросах его попросту нет.

Следует отметить одну важную особенность — формат параметризированных за просов "родного" управляемого поставщика SQL Server отличается от формата тако вых управляемых поставщиков OLE DB и ODBC. В табл. 3.1 приведен соответствую щий синтаксис для разных комбинаций управляемых поставщиков и баз данных.

Использование параметризированного запроса демонстрируется в листинге 3.11.

Таблица 3.1. Синтаксис параметров для различных управляемых поставщиков и баз данных Управляемый поставщик База данных Синтаксис параметра SQL Server SQL Server @Имя параметра OLEDB SQL Server ?

OLEDB Oracle ?

OLEDB MS Access (Let 4.0) ? или 8Имя_параметра SQL Server ?

ODBC Oracle ?

ODBC ODBC DB2 ?

ODBC MS Access ?

Листинг 3.11. Использование параметризированных запросов // Создание команды, содержащей параметризированный запрос.

SqlCoirimand crnd = conn.CreateCommand [) ;

cmd.CommandText = "SELECT * FROM Customer Where CustomerlD = @CustID";

// Определение параметра.

cmd.Parameters.Add("@CustID", DbType.Guid).Direction = ParameterDirection.Input;

cmd.Parameters["@CustID"].Value = Guid.NewGuid{);

Альтернатива использованию объектов параметров Вообще говоря, создание команд не должно быть трудной задачей. В большинстве случаев весь процесс можно свести к созданию обычных строк, как показано в лис тинге 3.12.

Листинг 3.12. Выполнение запроса без использования параметров SqlConnection conn = new SqlConnectiont".,,");

SqlCommand cmd = conn.GreateCommand[);

// Значение столбца CustomerlD.

int custID = 12345;

// Создание команды с помощью метода string.Format().

66 Часть /. Основы ADO.NET // Если процедура была выполнена успешно, // извлекаем значение ключа.

Int32 key;

if (sp.RETURN_VALUE — 0) ' key = sp.Key;

При желании можно определить каждый параметр отдельно и обращаться к классу команды напрямую, как показано в листинге 3.10.

Листинг 3.10. Определение параметров хранимой процедуры через ее оболочку SqlConnection conn - new SqlConnection{ "Server=localhost;

" + "Database=ADONET;

" + "Integrated Security=true;

");

conn.Open();

// Создание оболочки хранимой процедуры.

spAddMember sp = new spAddMember(conn);

// Определение параметров.

sp.FirstName = "Greg";

sp.LastName = "Maddux";

sp.Address - "123 Main Street";

sp.City = "Atlanta";

sp.State = "GA";

sp.Zip = "30307";

sp.Phone = "404-555-1212";

sp.Fax - "404-555-1213";

// Выполнение хранимой процедуры, sp.Command.ExecuteNonQuery();

// Если процедура была выполнена успешно, // извлекаем значение ключа.

Int32 key;

if (sp.RETURN_VALUE == 0) { key = sp.Key;

} Иногда возникает необходимость в многократном использовании специфичных запросов, которые нецелесообразно создавать в виде хранимых процедур, В подобном случае следует прибегнуть к разработке параметризированных запросов.

Параметризованные запросы Рассмотрим один из наиболее простых вариантов создания параметризированных запросов. Предположим, что у нас есть запрос, который возвращает число записей, соответствующих определенному критерию.

SELECT COUNT(*} FROM CUSTOMER WHERE SATS = 'MA Этот запрос возвращает результирующий набор данных, состоящий из одной запи си, — количества строк, соответствующих заданному критерию. С помощью парамет ра можно динамически указать этот критерий, например:

SELECT COUNT(*} FROM CUSTOMER WHERE STATE = ?

Глава З. Выполнение команд Zip. DbType = DbType. String;

Zip. Direction = ParameterDirection. Input;

Zip. SourceVersion = DataRowVersion. Current;

cmd. Parameters.Add ( // Параметр Phone.

SqlParameter _Phone = new SqlParameter ();

_Phone. ParameterName = " @ Phone";

_Phone. DbType = DbType. String;

_Phone. Direction = ParameterDirection. Input ;

_Phone.SourceVersion = DataRowVersion. Current;

_cmd. Parameters. Add (_Phone) ;

// Параметр Fax.

SqlParameter _Fax = new SqlParameter (};

_Fax. ParameterName = "@Fax";

_Fax. DbType = DbType. String;

_Fax. Direction = ParameterDirection. Input;

_Fax. SourceVersion = DataRowVersion. Current;

_cmd. Parameters. Add (_Fax) ;

// Параметр Key.

SqlParameter _Key = new SqlParameter ();

_Key. ParameterName = "@Key";

_Key. DbType = DbType. Int32;

_Key. Direction = ParameterDirection. Output;

_Key. SourceVersion = DataRowVersion. Current;

_cmd. Parameters.Add(_Key) ;

} // Защищенное поле, представляющее объект команды.

protected SqlCommand _cmd;

На Web-узле ADOGuy (www.adoguy.com/book) находится средство, позволяющее создавать аналогичный класс-оболочку для любой хранимой процедуры. Генерируе мый класс-оболочка прост в использовании, что и продемонстрировано в лис тинге 3.9.

Листинг 3.9. Использование класса-оболочки хранимой процедуры SqlConnection conn = new SqlConnection ( "Server=localhost;

" + "Database=ADONET;

" + "Integrated Security=true;

") ;

conn. Open ( ) ;

// Создание оболочки хранимой процедуры.

spAddMember sp = new spAddMember (conn) ;

/ / Вызов хранимой процедуры.

sp. Execute ("Maddux", "Greg", "123 Main Street", "Atlanta", "GA", "30307", "404-555-1212", "404-555-1213") ;

Часть I. Основы ADO. NET // Защищенный метод, в котором создается объект команды protected void ConstructCommand() < _cmd = new SqlCommandC'spAddMember") ;

_cmd.CommandType = CommandType.StoredProcedure;

// Параметр RETURN_VALUE.

SqlParameter _RETURN_VALUE = new SqlParameter{};

RETURN_VALUE. ParameterName = "@RETURN_VALUE";

_RETURN_VALUE.DbType = DbType.Int32;

_RETURN_VALUE.Direction ParameterDirection.ReturnValue;

_RETURN_VALUE.SourceVersion = DataRowVersion.Current;

_cmd.Parameters.Add(_RETURN_VALUE);

// Параметр FirstName.

SqlParameter FirstName = new SqlParameter();

_FirstName.ParameterName = "@FirstName";

_FirstName.DbType = DbType.String;

_FirstName.Direction = ParameterDirection.Input;

_FirstName.SourceVersion = DataRowVersion.Current;

_cmd.Parameters.Add(_FirstName);

// Параметр LastName.

SqlParameter _LastName = new SqlParameter(};

_LastName.ParameterName = "@LastName";

_LastName.DbType = DbType.String;

_LastName.Direction ™ ParameterDirection.Input;

_LastName.SourceVersion = DataRowVersion.Current;

_cmd.Parameters.Add(_LastName);

// Параметр Address.

SqlParameter _Address = new SqlParameter{};

_Address.ParameterName = "@Address";

_Address.DbType = DbType.String;

_Address.Direction = ParameterDirection.Input;

_Address.SourceVersion = DataRowVersion.Current;

_cmd.Parameters.Add{_Address);

// Параметр City.

SqlParameter City = new SqlParameter ();

_City.ParameterName = "@City";

_City.DbType = DbType.String;

_City.Direction = ParameterDirection.Input;

_City.SourceVersion = DataRowVersion.Current;

_cmd.Parameters.Add(_City);

// Параметр State.

SqlParameter _State = new SqlParameter();

_State.ParameterName = "@State";

_State.DbType = DbType.String;

_State.Direction = ParameterDirection.Input;

_State.SourceVersion = DataRowVersion.Current;

_cmd.Parameters.Add(_State);

// Параметр Zip.

SqlParameter _Zip = new SqlParameter();

_Zip.ParameterName = "@Zip";

Глава 3, Выполнение команд • } public String LastName I set { _cmd. Parameters [ "@LastName"].Value = value;

} I public String Address i set _cmd. Parameters ["^Address"].Value = value;

!

public String City { set _cmd. Parameters ["@City"].Value = value;

} i public String State { set { _cmd. Parameters ["@State" ].Value = value;

public String Zip { set I _cmd. Parameters ["@Zip"].Value = value;

} ) public String Phone I set { _cmd. Parameters ["@Phone"3 -Value = value;

} :

public String Fax { set I _cmd. Parameters [ "9Fax"].Value = value;

} • public Int32 Key {' get I return (Int32) _cmd. Parameters ["@Key"].Value, 62 Часть I. Основы ADO. NET Листинг 3.8. Создание класса-оболочки хранимой процедуры public class spAddMember : IDisposable public spAddMember(SqlConnection conn) ConstructCommand();

_cmd.Connection = conn;

public SqlCommand Command get return _cmd;

»' public Int32 Execute( string firstName, string lastName, string address, string city, string state, string zip, string phone, string fax) I FirstName = firstName;

LastName = lastName;

Address = address;

City = city;

State = state;

Zip = zip;

Phone = phone;

Fax = fax;

cmd.ExecuteNonQuery() ;

return RETURN_VALUE;

i // Реализация интерфейса IDisposable.

public void Dispose() _cmd.Dispose();

// Свойства для доступа к параметрам.

public Int32 RETURNJ/ALUE i get return (Int32) _cmd.Parameters["@RETURN_VALUE"].Value;

i public String FirstName < set _cmd.Parameters["@FirstName"].Value = value;

Глава З. Выполнение команд 6/ (NVarChar, VarChar, Char) свойство size представляет максимальный размер строки. Значение по умолчанию определяется на основе типа DbType парамет ра — в большинстве случаев его можно использовать, не боясь возникновения каких-либо проблем. Если код хранимой процедуры надежен, определение мак симального размера параметра способно уменьшить вероятность передачи про цедуре заведомо неверных значений, длина которых превышает максимально допустимую (в этом случае база данных генерирует ошибку).

• Direction. Данное свойство определяет способ передачи параметра. Его возмож ные значения— Input, Output, inputOutput и ReturnValue — представлены пе речислением ParameterDirection. По умолчанию используется значение Input.

• isNullable. Это свойство определяет, может ли параметр принять значение null. По умолчанию используется значение false.

• Value. Значение параметра. Для параметров типа Input или InputOutput это свойство должно быть установлено до выполнения команды, а для параметров типа InputOutput, Output и ReturnValue его значение устанавливается в ре зультате выполнения команды. Чтобы передать пустой входной параметр, нуж но либо не устанавливать значение свойства Value, либо установить иго рав ным DBNull. По умолчанию используется значение DBNull.

• Precision. Определяет число знаков (слева от запятой), использующихся для представления значения параметра. По умолчанию используется значение 0.

• Scale. Определяет число десятичных разрядов (число знаков справа от запя той), использующихся для представления значения параметра. По умолчанию используется значение 0.

• SourceColumn. Данное свойство определяет способ использования параметра с объектом DataAdapter (за более детальной информацией обратитесь к главе 8).

• SourceVersion. Определяет, как и предыдущее свойство, способ использова ния параметра с объектом DataAdapter (см. главу 8).

Создание оболочки для хранимой процедуры Разработка ADO.NET-кода для доступа к хранимой процедуре может оказаться уто мительным и скучным занятием, так как при этом обычно требуется определять отдель но каждый параметр. В листинге 3.7 показан пример упрощения этой операции.

Листинг 3.7. Определение параметров // Слишком много кода, SqlParameter param = new SqlParameter(};

param.ParameterName = "@RETURN_VALUE";

param.DbType = DbType.Int32;

param.Direction = ParameterDirection.ReturnValue;

_cmd. Parameters. Add (param) ;

// Сейчас все выглядит кратко и лаконично.

_cmd.Parameters.Add("@RETURN_VALUE", DbType.Int32).Direction = PararaeterDirection.ReturnValue;

Преимущество первого способа заключается в предельной ясности кода. С другой стороны, второй способ, действительно, очень лаконичен. При желании вы можете воспользоваться еще одним способом, заключающимся в инкапсуляции всей храни мой процедуры в класс-оболочку, как показано в листинге 3.8.

60 Часть /. Основы ADQ.NET param = new SqlParameter("@sp_narae", SqlDbType.NVarChar);

param.Direction = ParameterDirection.Input;

cmd.Parameters.Add(param);

param » new SqlParameter("@sp_owner", SqlDbType.NVarChar);

param.Direction = ParameterDirection.Input;

param. Value = "dbo";

cmd.Parameters.Add(param);

param = new SqlParameter("@sp_qualifier", SqlDbTyp*.NVarChar);

param.Direction = ParameterDirection.Input;

cmd. Parameters. Add (param) ;

// Выполнение хранимой процедуры.

SqlDataReader rdr » cmd.ExecuteReader{);

// ПереСор всех записей и вывод на консоль // имен хранимых процедур, while (rdr.ReadO) Console.WriteLineC'Proc: i O } ", rdr["PROCEDURE_NAME"] ) ;

// Освобождение ресурсов, conn.Dispose();

Мы определили четыре параметра, которые необходимо передать хранимой процеду ре sp_stored_procedure. Наверняка, вы заметили, что некоторые входные параметры не были инициализированы — по умолчанию, им будет присвоено значение null (в данном случае— DBNull). Другими словами, для того чтобы присвоить параметру значение null, его не нужно инициализировать. Для каждого параметра были заданы также несколько различных свойств. Некоторые из свойств параметров перечислены ниже (следует отметить, что не каждый параметр требует определения всех свойств).

• ParameterName. Имя параметра. Как правило, каждый разработчик баз данных имеет собственное мнение относительно именования параметров. Так, в управ ляемом поставщике SQL Server и поставщике OLE DB для Access имена пара метров предваряются символом @. С другой стороны, большинство остальных поставщиков OLE DB и все поставщики ODBC и Oracle определяют параметры по их позиции. В этом случае нужно создавать параметры в том порядке, в ко тором они передаются в хранимую процедуру или параметризованный запрос.

• DbType. Тип хранящихся в параметре данных. В.NET-перечислении DbType содержатся типы, которые можно определить для свойства DbType. Кроме того, каждый управляемый поставщик имеет свойство, более точно отражающее ре альный тип данных используемой СУБД. Например, в управляемом поставщи ке SQL Server есть перечисление SqlDbType. При выборе специфичного для поставщика элемента перечисления автоматически устанавливается соответст вующее значение DbType. Именно так производится отображение типов дан ных СУБД на типы управляемого поставщика. Например, установка свойства DbType параметра SqlParameter в значение DbType.Boolean приведет к ав томатической установке свойства SqlDbType в значение SqlDbType.Bit.

• size. Свойство Size зависит от типа данных параметра и обычно используется для указания его максимальной длины. Например, для строковых типов Глава 3. Выполнение команд SqlComraand sqlcmd = sqlconn.CreateCommandO;

sqlcmd.ComrriandType = CommandType.Text;

sqlcmd.CommandText = "SELECT * FROM Customer FOR XML AUTO;

";

XmlReader xml = sqlcmd.ExecuteXmlReader();

Разумеется, мы должны хорошо представлять себе, что происходит в результате выполнения той или иной команды. Например, если нам необходимо внести измене ния в базу данных, то, вероятнее всего, для этого будет достаточно удостовериться в успешном выполнении команды, вместо того чтобы анализировать полученный результирующий набор данных.

Результирующий набор данных Наиболее типичное использование команд заключается в выполнении единствен ной команды для возвращения одного набора данных. Большинство выполняемых команд предназначены для получения информации. Используя объект DataReader, мы обычно имеем дело с прямоугольным набором данных, полученным в результате вы полнения запроса или хранимой процедуры и называющимся результирующим набором данных (result set).

Однако сможем ли мы получить все результирующие наборы данных в случае вы полнения нескольких команд или хранимой процедуры, осуществляющей более од ного запроса? В этой ситуации база данных возвращает множество отдельных резуль тирующих наборов данных. Как мы узнаем из главы 4, объект DataReader поддержи вает средства для работы с каждым из этих наборов.

Использование параметров По своей сути параметры базы данных аналогичны параметрам Visual Basic, C++ или С#. Параметры используются для передачи часто изменяющейся информации серверу баз данных и обратно. Объекты параметров могут использоваться как с хра нимыми процедурами, так и с параметризированными запросами. ADO.NET позволя ет определять параметры при выполнении каждого из вышеназванных типов команд.

В листинге 3.6 приведен пример вызова простой хранимой процедуры с помощью управляемого поставщика SQL Server.

Листинг 3.6. Использование параметров // Подключение к базе данных.

SqlConnection conn = new SqlConnection( "Server=localhost;

Database=master;

" + "Integrated Security=>true;

");

conn.Open {), // Создание команды для выполнения хранимой процедуры.

SqlCommand cmd = conn.CreateCornmand() ;

cmd.CommandText = "sp_stored_procedures";

cmd.CommandType ~ CommandType.StoredProcedure;

// Определение параметров.

SqlParameter param = new SqlParameter("@KETURN", SqlDbType.Int);

param.Direction = ParameterDirection.ReturnValue;

cmd.Parameters.Add(param);

Часть /. Основы ADO.NET Выполнение команд За подготовкой команды следует ее выполнение. В ADO. NET существует несколь ко способов выполнения команд, которые отличаются лишь информацией, возвра щаемой из базы данных. Ниже перечислены методы выполнения команд, поддержи ваемые всеми управляемыми поставщиками, • ExecuteNonQuery ( ). Как правило, этот метод применяется для выполнения команд, которые не должны возвращать результирующий набор данных. Так как при вызове метода ExecuteNonQuery ( ) возвращается число строк, добав ленных, измененных или удаленных в результате выполнения команды, он мо жет использоваться в качестве индикатора успешного завершения операции.

• ExecuteScalar (). Этот метод выполняет команду и возвращает первый стол бец первой строки первого результирующего набора данных. Метод Execute Scalar () может быть полезен для извлечения из базы данных аналитической информации (например, SELECT COUNT (userid) FROM USERS;

).

• ExecuteReader ( ). Этот метод выполняет команду и возвращает объект Data Reader (более подробно он рассматривается в следующей главе), представляющий собой однонаправленный поток записей базы данных. Возвращаемый каждой версией метода ExecuteReader ( ) объект Data Reader представлен классом из пространства имен соответствующего управляемого поставщика (oieDbData Reader, SqlDataReader или OdbcDataReader), как показано в листинге 3.4.

Листинг 3.4. Использование метода ExecuteReaderQ II...

SqlDataReader sqlrdr = sqlcmd. ExecuteReader ( ) ;

while {sqlrdr. Read() ) OleDbDataReader odbrdr = odbcmd. ExecuteReader ( ) ;

while {odbrdr. Read { ) ) !

//...

Кроме того, управляемый поставщик SQL Server поддерживает метод, возвращаю щий объект XmlReader.

• ExecuteXmlReader (). Этот метод выполняет команду и возвращает экземпляр класса, производного от класса XmlReader, который используется для навига ции по результирующему набору данных. Метод ExecuteXmlReader ( } поддер живается только SQL Server 2000 или более поздней версией и требует, чтобы возвращаемые запросом или хранимой процедурой результаты были в формате XML, как показано в листинге 3.5.

Листинг 3.5. Использование метода ExecuteXmtReaderQ SqlConnection sqlconn = new SqlConnectionO ;

Глава З. Выполнение команд SqlCommand cmd = conn.CreateCommand();

cmd.CommandText = "SELECT * FROM Customer;

";

В последнем случае вместе с созданием нового объекта команды происходит оп ределение соответствующего ему объекта соединения. Так или иначе, требования "привязывать" соединение к определенной команде не существует.

Типы команд Команды — это мощный инструмент, позволяющий проводить сложные операции с базой данных. В ADO.NET существует три типа команд.

• Text. Текстовая команда состоит из инструкций, указывающих управляемому поставщику на необходимость выполнения определенных действий на уровне базы данных. В большинстве случаев такая команда написана на SQL-диалекте соответствующей базы данных (T-SQL для SQL Server, PL/SQL для Oracle и т.д.). Обычно текстовые команды передаются в базу данных без предвари тельной обработки (за исключением случаев передачи параметров). Этот тип команд поддерживается всеми управляемыми поставщиками данных: SQL Server, OLE DB, Oracle и ODBC.

• StoredProcedure. Хранимая процедура — это команда, вызывающая процеду ру, которая находится в самой базе данных. Такой тип команд поддерживается всеми управляемыми поставщиками: SQL Server, OLE DB, Oracle и ODBC.

• TableDirect. Команда типа TableDirect предназначена для извлечения из базы данных полной таблицы. Она аналогична текстовой команде SELECT * FROM ИМЯ_ТАБЛИЦЫ. Команда типа TableDirect поддерживается только управ ляемым поставщиком OLE DB. (Что касается меня, то я стараюсь избегать ее использования.) Все команды, включенные в рассмотренные выше типы, можно выполнять по отношению к базе данных. По умолчанию свойство CommandType объекта команды установлено в значение Text. Для определения типа команды используется перечис ление CommandType, расположенное в пространстве имен System. Data, как показано в листинге 3.3.

Pages:     | 1 | 2 || 4 | 5 |



© 2011 www.dissers.ru - «Бесплатная электронная библиотека»

Материалы этого сайта размещены для ознакомления, все права принадлежат их авторам.
Если Вы не согласны с тем, что Ваш материал размещён на этом сайте, пожалуйста, напишите нам, мы в течении 1-2 рабочих дней удалим его.