Bookmark.InsertDatabase メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
データ ソース (別の Microsoft Office Word 文書、Microsoft Office Excel ワークシート、Microsoft Access データベースなど) からデータを取得し、それを表として Bookmark コントロールの代わりに挿入します。
public void InsertDatabase (ref object Format, ref object Style, ref object LinkToSource, ref object Connection, ref object SQLStatement, ref object SQLStatement1, ref object PasswordDocument, ref object PasswordTemplate, ref object WritePasswordDocument, ref object WritePasswordTemplate, ref object DataSource, ref object From, ref object To, ref object IncludeFields);
abstract member InsertDatabase : obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj -> unit
Public Sub InsertDatabase (Optional ByRef Format As Object, Optional ByRef Style As Object, Optional ByRef LinkToSource As Object, Optional ByRef Connection As Object, Optional ByRef SQLStatement As Object, Optional ByRef SQLStatement1 As Object, Optional ByRef PasswordDocument As Object, Optional ByRef PasswordTemplate As Object, Optional ByRef WritePasswordDocument As Object, Optional ByRef WritePasswordTemplate As Object, Optional ByRef DataSource As Object, Optional ByRef From As Object, Optional ByRef To As Object, Optional ByRef IncludeFields As Object)
パラメーター
- Format
- Object
[表のオートフォーマット] ダイアログ ボックスの [書式] ボックスに一覧で表示された書式。 いずれかの WdTableFormat 定数です。 表のセルには、既定で境界線が付きます。
- Style
- Object
で指定された Format
AutoFormat の属性がテーブルに適用されます。 次の値の任意の組み合わせの合計を使用します:[1|1] Value[1|2] Meaning[2|1] 0 (zero)[2|2] None[3|1] 1[3|2] Borders[4|1] 2[4|2] Shading[5|1] 4[5|2] Font [6|1] 8[6|2] Color[7|1] 16[7|2] Auto Fit[8|1] 32[8|2] Heading Rows[9|1] 64[9|2] Last Row[10|1] 128[10|2] First Column[11|1] 256[11|2] 最後の列
- LinkToSource
- Object
新しい表とデータ ソースの間にリンクを確立する場合は true
。
- Connection
- Object
で SQLStatement
指定されたクエリを実行する範囲。 範囲の指定方法は、データの取得方法によって異なります。 たとえば、Open Database Connectivity (ODBC) を使用してデータを取得する場合は、接続文字列を指定します。 動的データ交換 (DDE) を使用して Microsoft Office Excel からデータを取得する場合は、名前付き範囲または "スプレッドシート全体" を指定します。注
動的データ交換 (DDE) は、セキュリティで保護されていない古いテクノロジです。 可能であれば、オブジェクトのリンクや埋め込み (OLE) など、DDE のより安全な代替手段を使用します。Microsoft Access からデータを取得する場合は、"Table" または "Query" という単語の後にテーブルまたはクエリの名前を指定します。
- SQLStatement
- Object
プライマリ データ ソースから文書に挿入する、データのサブセットを取得するためのオプションのクエリ文字列です。
- SQLStatement1
- Object
クエリ文字列が 255 文字を超える場合は、 SQLStatement
文字列の最初の部分を表し、 SQLStatement1
2 番目の部分を表します。
- PasswordDocument
- Object
データ ソースを開くために必要なパスワード (あれば)。 後の「解説」を参照してください。
- PasswordTemplate
- Object
データ ソースが Microsoft Office Word 文書の場合、この引数には接続されたテンプレートを開くために必要なパスワード (あれば) を指定します。 後の「解説」を参照してください。
- WritePasswordDocument
- Object
文書への変更を保存するために必要なパスワード。 後の「解説」を参照してください。
- WritePasswordTemplate
- Object
テンプレートへの変更を保存するために必要なパスワード。 後の「解説」を参照してください。
- DataSource
- Object
データ ソースのパスとファイル名。
- From
- Object
挿入するレコードの範囲の中で最初のデータ レコードの番号。
- To
- Object
挿入するレコードの範囲の中で最後のデータ レコードの番号。
- IncludeFields
- Object
新しい表の最初の行に、データ ソースのフィールド名を含める場合は true
。
例
次の使用例は、コントロールに Microsoft Excel スプレッドシートを Bookmark 挿入します。 Style 値 (191) は、数値 1、2、4、8、16、32、128 の組み合わせです。 この例では、 という名前 Data.xlsx
のブックが、ワークシート上に少なくとも 2 行のデータを含む C ディレクトリのルートに保存されていることを前提としています。
この例は、ドキュメント レベルのカスタマイズ用です。
private void BookmarkInsertDatabase()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
Microsoft.Office.Tools.Word.Bookmark bookmark1 =
this.Controls.AddBookmark(this.Paragraphs[1].Range,
"bookmark1");
bookmark1.Text = "This is sample bookmark text";
object Format = Word.WdTableFormat.wdTableFormatClassic1;
object Style = 191;
object LinkToSource = false;
object Connection = "Entire Spreadsheet";
object DataSource = "C:\\Data.xlsx";
bookmark1.InsertDatabase(ref Format, ref Style, ref LinkToSource,
ref Connection, ref missing, ref missing, ref missing,
ref missing, ref missing, ref missing, ref DataSource,
ref missing, ref missing, ref missing);
}
Private Sub BookmarkInsertDatabase()
Me.Paragraphs(1).Range.InsertParagraphBefore()
Dim Bookmark1 As Microsoft.Office.Tools.Word.Bookmark = _
Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")
Bookmark1.Text = "This is sample bookmark text"
Bookmark1.InsertDatabase(Format:=Word.WdTableFormat _
.wdTableFormatClassic1, Style:=191, LinkToSource:=False, _
Connection:="Entire Spreadsheet", DataSource:="C:\Data.xlsx")
End Sub
注釈
アプリケーションでハードコーディングされたパスワードを使用しないでください。 プロシージャでパスワードが必要な場合は、ユーザーにパスワードを要求し、変数に格納してから、 変数をコードで使用します。
組み込みのシステム管理者 (sa) ログオン アカウントは使用しないでください。 代わりに、システム管理者に sysadmin 固定サーバー ロールのメンバーを作成し、独自のアカウントを使用してログオンさせます。 sa は、ログオンする他の方法がない場合にのみ使用します。 sa ログオン アカウントを介した不正アクセスを防ぐには、そのアカウントに強力な一意のパスワードを割り当てる必要があります。
可能な場合は、Windows 認証 (信頼された接続とも呼ばれます) を使用します。この認証では、Windows ユーザー アカウントを使用してSQL Serverに接続します。 ユーザーが Windows ユーザー アカウントを介して接続すると、SQL Serverは Windows オペレーティング システムの情報を使用してアカウント名とパスワードを検証します。 Windows 認証を使用する前に、サーバー管理者は、この認証モードを使用するようにSQL Serverを構成する必要があります。 Windows 認証を使用できない場合は、ユーザーのログオン情報を保存しないでください。 ユーザーがログオンするたびにログオン情報を入力する方が安全です。
省略可能のパラメーター
省略可能なパラメーターの詳細については、「 Office ソリューションの省略可能なパラメーター」を参照してください。