README : IRow::GetColumns を使用した列のフェッチ (OLE DB)

[アーティクル]
12/15/2008

更新 : 2006 年 7 月 17 日

このサンプルでは、IRow インターフェイスを使用して、結果セット内の単一行の列に直接アクセスする方法を示します。このサンプルは IA64 ではサポートされていません。

シナリオ

このサンプルの詳細については、Books Online の「IRow::GetColumns を使用した列のフェッチ (OLE DB)」を参照してください。

言語

このサンプルでは、Transact-SQL および Visual C++ を使用しています。

前提条件

このサンプルを実行する前に、次のソフトウェアがインストールされていることを確認してください。

データベースエンジンを含む SQL Server 2005 または SQL Server 2005 Express Edition (SQL Server Express)。
SQL Server Express は、Microsoft ダウンロードセンターからダウンロードできます。
SQL Server 2005 に付属の AdventureWorks データベース。Microsoft SQL Server デベロッパーセンターからも入手できます。
SQL Server 2005 データベースエンジンのサンプル。これらのサンプルは SQL Server 2005 に含まれています。これらの最新バージョンは、Microsoft SQL Server デベロッパーセンターからダウンロードできます。
.NET Framework SDK 2.0 または Microsoft Visual Studio 2005。.NET Framework SDK は無料で入手できます。詳細については、「.NET Framework SDK のインストール」を参照してください。

サンプルのビルド

このサンプルでは、コンピュータの既定の SQL Server インスタンスに接続します。SQL Server Express は、既定で名前付きインスタンスとしてインストールされます。名前付きインスタンスに接続するには、接続文字列を L"(local)" から L"(local)\name" に変更します。name は名前付きインスタンスです。

このサンプルを使用するには、サンプルの Scripts ディレクトリにある次の Transact-SQL ステートメントを実行する必要があります。

USE AdventureWorks
GO

IF EXISTS (SELECT name FROM sysobjects WHERE name = 'MyTable')
     DROP TABLE MyTable
GO

CREATE TABLE MyTable
(
     col1  int,
     col2  varchar(50),
     col3  char(50),
     col4  datetime,
     col5  float,
     col6  money,
     col7  sql_variant,
     col8  binary(50),
     col9  text,
     col10 image
)
GO
INSERT INTO MyTable
values
(
     10,
     'abcdefghijklmnopqrstuvwxyz',
     'ABCDEFGHIJKLMNOPQRSTUVWXYZ',
     '11/1/1999 11:52 AM',
     3.14,
     99.95,
     CONVERT(nchar(50), N'AbCdEfGhIjKlMnOpQrStUvWxYz'),
     0x123456789,
     REPLICATE('AAAAABBBBB', 500),
     REPLICATE(0x123456789, 500)
)
GO

SQL Server Management Studio で、Scripts\setup.sql スクリプトを読み込んで実行するか、コマンドプロンプトウィンドウで次のコマンドを実行します。

sqlcmd -E -I -i Scripts\setup.sql

Visual Studio を使用する場合は、FetchColumns_B.sln ファイルを読み込んでビルドします。
MSBuild.exe を使用する場合は、コマンドプロンプトで MSBuild.exe を起動し、FetchColumns_B.sln ファイルを渡します。
```
MSBuild FetchColumns_B.sln
```

サンプルの実行

Visual Studio から、[デバッグなしで開始] を呼び出します (Ctrl キーを押しながら F5 キーを押します)。
MSBuild.exe でビルドした場合は、FetchColumns_B.exe を起動します。

変更履歴

リリース	履歴
2006 年 7 月 17 日	変更内容 : 前提条件を更新して、内容をわかりやすくしました。サンプルをダウンロードするための Web サイトが追加されています。新しい内容 : 名前付きインスタンスへの接続に関する説明を追加しました。

2006 年 7 月 17 日

変更内容 :

前提条件を更新して、内容をわかりやすくしました。サンプルをダウンロードするための Web サイトが追加されています。

新しい内容 :

名前付きインスタンスへの接続に関する説明を追加しました。

次の方法で共有