その他の DataTable 列を追加する (VB)

  • [アーティクル]

作成者: Scott Mitchell

PDF のダウンロード

TableAdapter ウィザードを使用して型指定された DataSet を作成する場合、対応する DataTable には、メイン データベース クエリによって返される列が含まれます。 ただし、DataTable に追加の列を含める必要がある場合があります。 このチュートリアルでは、追加の DataTable 列が必要な場合にストアド プロシージャが推奨される理由について説明します。

はじめに

型指定された DataSet に TableAdapter を追加する場合、対応する DataTable のスキーマは、TableAdapter の メイン クエリによって決定されます。 たとえば、メイン クエリがデータ フィールド A、B、C を返す場合、DataTable には A、B、C という名前の 3 つの対応する列があります。TableAdapter には、メイン クエリに加えて、パラメーターに基づいてデータのサブセットを返す追加のクエリを含めることができます。 たとえば、すべての製品に関する情報をProductsTableAdapter返す メイン クエリに加えて、 や GetProductByProductID(productID)などのGetProductsByCategoryID(categoryID)メソッドも含まれており、指定されたパラメーターに基づいて特定の製品情報を返します。

DataTable のスキーマに TableAdapter のメイン クエリを反映するモデルは、すべての TableAdapter s メソッドが、メイン クエリで指定されたものと同じまたは少ないデータ フィールドを返す場合に適切に機能します。 TableAdapter メソッドが追加のデータ フィールドを返す必要がある場合は、それに応じて DataTable のスキーマを展開する必要があります。 マスター/詳細詳細データ リストでマスター レコードの箇条書きリストを使用するチュートリアルでは、メイン クエリNumberOfProductsで定義されている CategoryID、CategoryName、および Description データ フィールドに、各カテゴリに関連付けられている製品の数を報告する追加のデータ フィールドを返す メソッドCategoriesTableAdapterを 追加しました。 この新しいメソッドからデータ フィールド値を CategoriesDataTable キャプチャするために、 に新しい列を NumberOfProducts 手動で追加しました。

「ファイルのアップロード」チュートリアルで説明したように、アドホック SQL ステートメントを使用し、データ フィールドがメイン クエリと正確に一致しないメソッドを持つ TableAdapter を使用して、細心の注意を払う必要があります。 TableAdapter 構成ウィザードを再実行すると、すべての TableAdapter メソッドが更新され、そのデータ フィールド リストがメインクエリと一致します。 したがって、カスタマイズされた列リストを持つメソッドは、メインクエリの列リストに戻り、期待されるデータは返されません。 ストアド プロシージャを使用する場合、この問題は発生しません。

このチュートリアルでは、DataTable のスキーマを拡張して追加の列を含める方法について説明します。 アドホック SQL ステートメントを使用する場合の TableAdapter の脆弱性のため、このチュートリアルではストアド プロシージャを使用します。 ストアド プロシージャを使用するように TableAdapter を構成する方法の詳細については、「Typed DataSet s TableAdapters の新しいストアド プロシージャの作成」および「Typed DataSet s TableAdapters の既存のストアド プロシージャの使用」チュートリアルを参照してください。

手順 1: 列をPriceQuartileに追加するProductsDataTable

型指定 された DataSet の TableAdapters の新しいストアド プロシージャの作成に関 するチュートリアルでは、 という名前 NorthwindWithSprocsの型指定された DataSet を作成しました。 この DataSet には、現在、 と EmployeesDataTableの 2 つの DataTable がProductsDataTable含まれています。 ProductsTableAdapterには、次の 3 つの方法があります。

  • GetProducts- テーブルからProductsすべてのレコードを返すメイン クエリ
  • GetProductsByCategoryID(categoryID) - 指定された categoryID を持つすべての製品を返します。
  • GetProductByProductID(productID) - 指定された productID を持つ特定の製品を返します。

メイン クエリと 2 つの追加メソッドはすべて、同じデータ フィールドのセット (つまり、テーブルのすべての列) をProducts返します。 相関サブクエリや、 テーブルまたは JOIN テーブルからCategoriesSuppliers関連データをプルするデータはありません。 したがって、 ProductsDataTable にはテーブル内の各フィールドに対応する列があります Products 。

このチュートリアルでは、すべての製品を返す 名前付きの GetProductsWithPriceQuartile に メソッドProductsTableAdapterを追加します。 標準の製品データ フィールドに加えて、 には、 GetProductsWithPriceQuartile 製品の価格が下がる四分位数を示すデータ フィールドも含まれます PriceQuartile 。 たとえば、価格が最も高い 25% の製品の値は PriceQuartile 1 になり、価格が下位 25% に下がる製品の値は 4 になります。 ただし、この情報を返すストアド プロシージャの作成を心配する前に、 メソッドを使用するときに結果を保持PriceQuartileする列を含むように を更新ProductsDataTableするGetProductsWithPriceQuartile必要があります。

DataSet を NorthwindWithSprocs 開き、 を ProductsDataTable右クリックします。 コンテキスト メニューから [追加] を選択し、[列] を選択します。

ProductsDataTable に新しい列を追加する

図 1: に新しい列を追加する ProductsDataTable (フルサイズの画像を表示するをクリックします)

これにより、 型 System.Stringの Column1 という名前の DataTable に新しい列が追加されます。 この列の名前を PriceQuartile とその型に System.Int32 更新する必要があります。これは、1 から 4 の間の数値を保持するために使用されるためです。 で新しく追加された列をProductsDataTable選択し、プロパティ ウィンドウから プロパティを Name PriceQuartile に設定し、 プロパティを DataType にSystem.Int32設定します。

新しい列の名前と DataType プロパティを設定する

図 2: [新しい列] Name と DataType [プロパティ] を設定する (フルサイズの画像を表示する場合はクリックします)

図 2 に示すように、列の値を一意にする必要があるかどうか、列が自動インクリメント列の場合、データベース NULL 値が許可されているかどうかなど、設定できる追加のプロパティがあります。 これらの値は既定値のままにします。

手順 2: メソッドを作成するGetProductsWithPriceQuartile

列を ProductsDataTable 含むように が更新されたので PriceQuartile 、 メソッドを作成する GetProductsWithPriceQuartile 準備ができました。 まず、TableAdapter を右クリックし、コンテキスト メニューから [クエリの追加] を選択します。 これにより、TableAdapter クエリ構成ウィザードが表示されます。最初に、アドホック SQL ステートメントを使用するか、新規または既存のストアド プロシージャを使用するかを確認するメッセージが表示されます。 価格四分位数データを返すストアド プロシージャがまだないため、TableAdapter でこのストアド プロシージャを作成できるようにしましょう。 [新しいストアド プロシージャの作成] オプションを選択し、[次へ] をクリックします。

ストアド プロシージャを作成するように TableAdapter ウィザードに指示する

図 3: ストアド プロシージャを作成するように TableAdapter ウィザードに指示する (フルサイズの画像を表示する をクリックします)

次の画面 (図 4 を参照) では、追加するクエリの種類を確認するメッセージが表示されます。 GetProductsWithPriceQuartileメソッドはテーブルからすべての列とレコードをProducts返すので、[行を返す SELECT] オプションを選択し、[次へ] をクリックします。

クエリは、複数の行を返す SELECT ステートメントになります

図 4: クエリは複数の行を SELECT 返すステートメントになります (フルサイズの画像を表示する場合はクリックします)

次に、クエリの入力を SELECT 求められます。 ウィザードに次のクエリを入力します。

SELECT ProductID, ProductName, SupplierID, CategoryID, 
       QuantityPerUnit, UnitPrice, UnitsInStock, UnitsOnOrder, 
       ReorderLevel, Discontinued,
       NTILE(4) OVER (ORDER BY UnitPrice DESC) as PriceQuartile
FROM Products

上記のクエリでは、SQL Server 2005 の新しいNTILE関数を使用して結果を 4 つのグループに分割します。このグループは、降順で並べ替えられた値によってUnitPrice決定されます。

残念ながら、クエリ ビルダーはキーワード (keyword)を解析する方法をOVER知らず、上記のクエリを解析するときにエラーが表示されます。 したがって、クエリ ビルダーを使用せずに、ウィザードのテキスト ボックスに上記のクエリを直接入力します。

注意

NTILE および SQL Server 2005 の他のランク付け関数の詳細については、SQL Server 2005 オンライン ブックの「ROW_NUMBER (Transact-SQL)」および「ランク付け関数」セクションを参照してください。

クエリを SELECT 入力して [次へ] をクリックすると、ウィザードは作成するストアド プロシージャの名前を指定するように求められます。 新しいストアド プロシージャ Products_SelectWithPriceQuartile に名前を付け、[次へ] をクリックします。

ストアド プロシージャに名前を付Products_SelectWithPriceQuartile

図 5: ストアド プロシージャ Products_SelectWithPriceQuartile に名前を付ける (フルサイズの画像を表示する場合にクリックします)

最後に、TableAdapter メソッドに名前を付けるメッセージが表示されます。 [DataTable を塗りつぶす] チェック ボックスと [DataTable を返す] チェック ボックスの両方をオンのままにし、メソッドに と という名前を付GetProductsWithPriceQuartileけますFillWithPriceQuartile。

TableAdapter のメソッドに名前を付け、[完了] をクリックします。

図 6: TableAdapter のメソッドに名前を付け、[完了] をクリックします (フルサイズの画像を表示する場合はクリックします)

クエリを SELECT 指定し、ストアド プロシージャと TableAdapter メソッドに名前を付けて、[完了] をクリックしてウィザードを完了します。 この時点で、SQL コンストラクトまたはステートメントがサポートされていないことを示す OVER 警告がウィザードから 1 つまたは 2 つ表示されることがあります。 これらの警告は無視してかまいません。

ウィザードが完了したら、TableAdapter に メソッドと GetProductsWithPriceQuartile メソッドをFillWithPriceQuartile含める必要があり、データベースには という名前Products_SelectWithPriceQuartileのストアド プロシージャを含める必要があります。 TableAdapter に実際にこの新しいメソッドが含まれていることと、ストアド プロシージャがデータベースに正しく追加されていることを確認します。 データベースを確認するときに、ストアド プロシージャが表示されない場合は、[ストアド プロシージャ] フォルダーを右クリックし、[最新の情報に更新] を選択してみてください。

TableAdapter に新しいメソッドが追加されたことを確認する

図 7: TableAdapter に新しいメソッドが追加されたことを確認する

データベースにProducts_SelectWithPriceQuartile ストアド プロシージャが含まれていることを確認する

図 8: データベースにストアド プロシージャが含まれていることを Products_SelectWithPriceQuartile 確認する (フルサイズの画像を表示する場合はクリックします)

注意

アドホック SQL ステートメントの代わりにストアド プロシージャを使用する利点の 1 つは、TableAdapter 構成ウィザードを再実行すると、ストアド プロシージャの列リストが変更されないことです。 これを確認するには、TableAdapter を右クリックし、コンテキスト メニューから [構成] オプションを選択してウィザードを起動し、[完了] をクリックして完了します。 次に、データベースに移動し、ストアド プロシージャを Products_SelectWithPriceQuartile 表示します。 その列リストは変更されていないことに注意してください。 アドホック SQL ステートメントを使用していた場合、TableAdapter 構成ウィザードを再実行すると、このクエリの列リストがメインクエリ列リストと一致するように元に戻され、 メソッドで使用されるクエリから NTILE ステートメントがGetProductsWithPriceQuartile削除されます。

データ アクセス層の GetProductsWithPriceQuartile メソッドが呼び出されると、TableAdapter はストアド プロシージャを Products_SelectWithPriceQuartile 実行し、返される各レコードの に行を ProductsDataTable 追加します。 ストアド プロシージャによって返されるデータ フィールドは、 列に ProductsDataTable マップされます。 ストアド プロシージャから返されるデータ フィールドがあるためPriceQuartile、その値は s PriceQuartile 列にProductsDataTable割り当てられます。

クエリがデータ フィールドを返 PriceQuartile さない TableAdapter メソッドの場合、 PriceQuartile 列の値はそのプロパティで DefaultValue 指定された値です。 図 2 に示すように、この値は 既定値の に DBNull設定されています。 別の既定値を使用する場合は、それに応じて プロパティを DefaultValue 設定します。 列 (DataTypeつまり、列) が指定されている場合は、System.Int32値がPriceQuartile有効であることを確認DefaultValueしてください。

この時点で、DataTable に列を追加するために必要な手順を実行しました。 この追加の列が期待どおりに動作することを確認するには、各製品の名前、価格、価格の四分位数を表示する ASP.NET ページを作成します。 ただし、これを行う前に、まず、DAL GetProductsWithPriceQuartile の メソッドを呼び出すメソッドを含むようにビジネス ロジックレイヤーを更新する必要があります。 次に、手順 3 で BLL を更新し、手順 4 で ASP.NET ページを作成します。

手順 3: ビジネス ロジック レイヤーの拡張

プレゼンテーション レイヤーから新しい GetProductsWithPriceQuartile メソッドを使用する前に、まず対応するメソッドを BLL に追加する必要があります。 クラス ファイルを ProductsBLLWithSprocs 開き、次のコードを追加します。

<System.ComponentModel.DataObjectMethodAttribute_
    (System.ComponentModel.DataObjectMethodType.Select, False)> _
Public Function GetProductsWithPriceQuartile() As NorthwindWithSprocs.ProductsDataTable
    Return Adapter.GetProductsWithPriceQuartile()
End Function

の他のデータ取得メソッドと同様に ProductsBLLWithSprocs、 メソッドは GetProductsWithPriceQuartile DAL の対応する GetProductsWithPriceQuartile メソッドを呼び出し、その結果を返します。

手順 4: ASP.NET Web ページに価格四分位数情報を表示する

BLL の追加が完了したら、各製品の価格四分位数を示す ASP.NET ページを作成する準備ができました。 フォルダー内のAddingColumns.aspxページをAdvancedDAL開き、GridView をツールボックスからDesignerにドラッグし、そのプロパティを ID にProducts設定します。 GridView のスマート タグから、 という名前 ProductsDataSourceの新しい ObjectDataSource にバインドします。 クラス s GetProductsWithPriceQuartile メソッドを使用するように ObjectDataSource をProductsBLLWithSprocs構成します。 これは読み取り専用グリッドであるため、UPDATE、INSERT、DELETE タブのドロップダウン リストを (None) に設定します。

ProductsBLLWithSprocs クラスを使用するように ObjectDataSource を構成する

図 9: クラスを使用 ProductsBLLWithSprocs するように ObjectDataSource を構成する (フルサイズの画像を表示するにはクリックします)

GetProductsWithPriceQuartile メソッドから製品情報を取得する

図 10: メソッドから製品情報を取得します GetProductsWithPriceQuartile (フルサイズの画像を表示する場合はクリックします)

データ ソースの構成ウィザードが完了すると、Visual Studio によって、 メソッドによって返される各データ フィールドの BoundField または CheckBoxField が GridView に自動的に追加されます。 これらのデータ フィールドの 1 つは です PriceQuartile。これは、手順 1 で に追加した ProductsDataTable 列です。

GridView のフィールドを編集し、、UnitPrice、および BoundFields を除くProductNameすべてのフィールドをPriceQuartile削除します。 値を UnitPrice 通貨として書式設定し UnitPrice 、BoundFields と PriceQuartile BoundFields をそれぞれ右揃えと中央揃えにするように BoundField を構成します。 最後に、残りの BoundFields HeaderText プロパティをそれぞれ Product、Price、Price Quartile に更新します。 また、GridView のスマート タグから [並べ替えを有効にする] チェック ボックスをチェックします。

これらの変更の後、GridView と ObjectDataSource の宣言型マークアップは次のようになります。

<asp:GridView ID="Products" runat="server" AllowSorting="True"
    AutoGenerateColumns="False" DataKeyNames="ProductID" 
    DataSourceID="ProductsDataSource">
    <Columns>
        <asp:BoundField DataField="ProductName" HeaderText="Product" 
            SortExpression="ProductName" />
        <asp:BoundField DataField="UnitPrice" DataFormatString="{0:c}" 
            HeaderText="Price" HtmlEncode="False" 
            SortExpression="UnitPrice">
            <ItemStyle HorizontalAlign="Right" />
        </asp:BoundField>
        <asp:BoundField DataField="PriceQuartile" HeaderText="Price Quartile" 
            SortExpression="PriceQuartile">
            <ItemStyle HorizontalAlign="Center" />
        </asp:BoundField>
    </Columns>
</asp:GridView>
<asp:ObjectDataSource ID="ProductsDataSource" runat="server" 
    OldValuesParameterFormatString="original_{0}"
    SelectMethod="GetProductsWithPriceQuartile" 
    TypeName="ProductsBLLWithSprocs">
</asp:ObjectDataSource>

図 11 は、ブラウザーからアクセスした場合のこのページを示しています。 最初は、各製品に適切な PriceQuartile 値が割り当てられた降順で、製品が価格順に並べ替えられたことに注意してください。 もちろん、このデータは、価格に関する製品の順位付けが反映された価格四分位数列の値を使用して、他の条件で並べ替えることができます (図 12 を参照)。

製品は価格順に並べ替え

図 11: 製品は価格順に並べ替えられます (クリックするとフルサイズの画像が表示されます)

製品は名前順に並べ替え

図 12: 製品は名前で並べ替えられます (フルサイズの画像を表示するにはクリックします)

注意

数行のコードを使用すると、GridView を拡張して、値に基づいて製品行に色を PriceQuartile 付けることができました。 これらの製品は、最初の四分位数で薄い緑、2 番目の四分位数の製品は薄い黄色などに色を付ける場合があります。 この機能を追加することをお勧めします。 GridView の書式設定に関する更新プログラムが必要な場合は、「 データに基づくカスタム書式設定」チュートリアルを 参照してください。

別の方法 - 別の TableAdapter の作成

このチュートリアルで説明したように、メイン クエリで指定されたデータ フィールド以外のデータ フィールドを返す TableAdapter にメソッドを追加する場合は、対応する列を DataTable に追加できます。 ただし、このような方法は、TableAdapter に異なるデータ フィールドを返すメソッドが少数あり、それらの代替データ フィールドがメインクエリとあまり異なっていない場合にのみ適切に機能します。

DataTable に列を追加するのではなく、別のデータ フィールドを返す最初の TableAdapter のメソッドを含む別の TableAdapter を DataSet に追加できます。 このチュートリアルでは、 (メソッドでのみ使用GetProductsWithPriceQuartileされる) 列にProductsDataTable列を追加PriceQuartileするのではなく、ストアド プロシージャをメイン クエリとして使用Products_SelectWithPriceQuartileする という名前ProductsWithPriceQuartileTableAdapterの DataSet に TableAdapter を追加できました。 ASP.NET 価格四分位数で製品情報を取得する必要があるページでは を ProductsWithPriceQuartileTableAdapter使用しますが、 を引き続き使用できなかったページは を ProductsTableAdapter使用します。

新しい TableAdapter を追加すると、DataTables は未学習のままであり、その列は TableAdapter のメソッドによって返されるデータ フィールドを正確にミラーします。 ただし、追加の TableAdapter では、反復的なタスクと機能が導入される可能性があります。 たとえば、列を表示PriceQuartileした ASP.NET ページでも、挿入、更新、削除のサポートを提供する必要がある場合は、 ProductsWithPriceQuartileTableAdapter で、UpdateCommand、および DeleteCommand プロパティをInsertCommand適切に構成する必要があります。 これらのプロパティは をミラーしますがProductsTableAdapter、この構成では追加の手順が導入されています。 さらに、 クラスと ProductsWithPriceQuartileTableAdapter クラスを使用して、データベースに製品を更新、削除、または追加する方法が ProductsTableAdapter 2 つあります。

このチュートリアルのダウンロードには、 ProductsWithPriceQuartileTableAdapter この代替アプローチを NorthwindWithSprocs 示す DataSet のクラスが含まれています。

まとめ

ほとんどのシナリオでは、TableAdapter 内のすべてのメソッドが同じデータ フィールドのセットを返しますが、特定のメソッドまたは 2 つのメソッドが追加のフィールドを返す必要がある場合があります。 たとえば、詳細データリストを使用したマスター レコードの箇条書きの使用に関するチュートリアルでは、メイン クエリのデータ フィールドに加えて、各カテゴリにCategoriesTableAdapter関連付けられている製品の数を報告するフィールドを返すメソッドを に追加しましたNumberOfProducts。 このチュートリアルでは、メイン クエリのデータ フィールドに加えて、フィールドを返した PriceQuartile にメソッドを追加する方法ProductsTableAdapterについて説明しました。 TableAdapter のメソッドによって返される追加のデータ フィールドをキャプチャするには、対応する列を DataTable に追加する必要があります。

DataTable に列を手動で追加する場合は、TableAdapter でストアド プロシージャを使用することをお勧めします。 TableAdapter がアドホック SQL ステートメントを使用する場合、TableAdapter 構成ウィザードが実行されるたびに、すべてのメソッド データ フィールド リストが、メイン クエリによって返されるデータ フィールドに戻ります。 この問題はストアド プロシージャには及ばないため、このチュートリアルで使用することをお勧めします。

プログラミングに満足!

著者について

7 冊の ASP/ASP.NET 書籍の著者であり、 4GuysFromRolla.com の創設者である Scott Mitchell は、1998 年から Microsoft Web テクノロジと協力しています。 Scott は、独立したコンサルタント、トレーナー、ライターとして働いています。 彼の最新の本は サムズは24時間で2.0 ASP.NET 自分自身を教えています。 にアクセスするか、ブログを使用して にアクセスmitchell@4GuysFromRolla.comできます。これは でhttp://ScottOnWriting.NET見つけることができます。

特別な感謝

このチュートリアル シリーズは、多くの役に立つ校閲者によってレビューされました。 このチュートリアルのリード レビュー担当者は、Randy Schmidt、Jacky Goor、Bernadette Leigh、および Hilton Giesenow でした。 今後の MSDN の記事を確認することに関心がありますか? その場合は、 にmitchell@4GuysFromRolla.com行をドロップしてください。

前へ次へ