Range.InsertDatabase メソッド (Word)
(別の Microsoft Word 文書、Microsoft Excel のワークシート、または Microsoft Access データベースなど) は、データ ソースからデータを取得し、として指定した範囲の代わりにテーブル データを挿入します。
構文
式。InsertDatabase (Format、Style、LinkToSource、Connection、SQLStatement、SQLStatement1、PasswordDocument、PasswordTemplate、WritePasswordDocument、WritePasswordTemplate、DataSource、From、To、IncludeFields)
expression 必須です。 Range オブジェクトを表す変数を指定します。
パラメーター
| 名前 | 必須 / オプション | データ型 | 説明 |
|---|---|---|---|
| Format | オプション | バリアント型 | [表のオートフォーマット] ダイアログ ボックス ([罫線] メニュー) の [書式] ボックスに表示された書式を指定します。 WdTableFormat 定数のいずれかをすることができます。 既定では、テーブル内のセルに罫線が適用されます。 |
| Style | 省略可能 | バリアント型 (Variant) | 引数 Format に指定したオートフォーマットの属性を指定します。 |
| LinkToSource | 省略可能 | バリアント型 (Variant) | True 新しい表とデータ ソース間のリンクを確立します。 |
| Connection | 省略可能 | バリアント型 | SQLStatement で指定されたクエリを実行する範囲。 |
| SQLStatement | 省略可能 | String | 文書に挿入するプライマリ データ ファイルのデータ サブセットを検索する任意のクエリ文字列を指定します。 |
| SQLStatement1 | 省略可能 | String | クエリ文字列が 255 文字より長い場合、 SQLStatement は文字列の最初の部分を表し、 SQLStatement1 は 2 番目の部分を表します。 |
| PasswordDocument | 省略可能 | バリアント型 (Variant) | データ ソースを開くために必要なパスワード (存在する場合)。 下記の「備考」を参照してください。 |
| PasswordTemplate | 省略可能 | バリアント型 (Variant) | データ ソースが Word 文書の場合、この引数は添付されたテンプレートを開くために必要なパスワード (存在する場合) です。 下記の「備考」を参照してください。 |
| WritePasswordDocument | 省略可能 | バリアント型 (Variant) | ドキュメントへの変更を保存するために必要なパスワード。 下記の「備考」を参照してください。 |
| WritePasswordTemplate | 省略可能 | バリアント型 (Variant) | テンプレートへの変更を保存するために必要なパスワード。 下記の「備考」を参照してください。 |
| DataSource | 省略可能 | バリアント型 (Variant) | データ ソースのパスとファイル名を指定します。 |
| From | 省略可能 | バリアント型 (Variant) | 挿入するレコード範囲の最初のデータ レコードの番号を指定します。 |
| To | 省略可能 | バリアント型 (Variant) | 挿入するレコード範囲の最後のデータ レコードの番号を指定します。 |
| IncludeFields | 省略可能 | バリアント型 (Variant) | True を新しいテーブルの最初の行で、データ ソースのフィールド名が含まれます。 |
セキュリティ
重要
アプリケーションではハードコードされたパスワードを使用しないでください。 プロシージャ内でパスワードが必要な場合、ユーザーからのパスワードを要求し、変数に格納して、コードでその変数を使用します。 これを行う方法の推奨されるベスト プラクティスについては、「 Office ソリューション開発者向けのセキュリティ ノート」を参照してください。
注釈
Style 引数の値には、次に示す値を任意に組み合わせた合計値を使用できます。
| 値 | 説明 |
|---|---|
| 0 (ゼロ) | なし |
| 1 | 罫線 |
| 2 | 網かけ |
| 4 | フォント |
| 8 | 色 |
| 16 | 自動調整 |
| 32 | タイトル行 |
| 64 | 最終行 |
| 128 | 1 列目 |
| 256 | 最終列 |
Connection 引数の指定方法はデータの検索方法によって異なります。 次に示すのは、その例です。
Open Database Connectivity (ODBC) でデータを取得する場合は、接続文字列を指定します。
動的データ交換 (DDE) を使用して Excel のデータを検索する場合、名前付き範囲または "ワークシート全体" を指定します。
Access のデータを検索する場合は、文字列 "Table" または "Query" の後にテーブルまたはクエリの名前を指定します。
例
次の使用例は、選択範囲の後ろに "Data.xls" という名前の Excel ワークシートを挿入します。 引数 Style の値 (191) は 1、2、4、8、16、32、および 128 の合計です。
With Selection
.Collapse Direction:=wdCollapseEnd
.Range.InsertDatabase _
Format:=wdTableFormatSimple2, Style:=191, _
LinkToSource:=False, Connection:="Entire Spreadsheet", _
DataSource:="C:\MSOffice\Excel\Data.xls"
End With
サポートとフィードバック
Office VBA またはこの説明書に関するご質問やフィードバックがありますか？ サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。