DataRecordsets.AddFromConnectionFile メソッド (Visio)

Office Data Connection (ODC) ファイルに含まれる接続情報とクエリ情報を使用して、OLEDB または ODBC データ ソースに接続してデータを取得することで、DataRecordset オブジェクトを DataRecordsets コレクションに追加します。

注:

この Visio オブジェクトまたはメンバーは Visio Professional 2013 のライセンス ユーザーのみが使用できます。

構文

式。AddFromConnectionFile (FileName, AddOptions, Name)

式DataRecordsets オブジェクトを返す式。

パラメーター

名前	必須 / オプション	データ型	説明
FileName	必須	String	使用する ODC 接続ファイルの名前です。
AddOptions	必須	Long	追加するデータ レコードセットのプロパティを決定するオプションです。 VisDataRecordsetAddOptions からの 1 つ以上の列挙値の組み合わせ。 詳細については、「備考」を参照してください。
名前	省略可能	String	追加する DataRecordset オブジェクトの表示名を割り当てます。

戻り値

DataRecordset

注釈

FileName パラメーターには、OLEDB または ODBC データ ソースに接続する方法を指定する接続文字列、および必要なデータを抽出する方法を指定するクエリ文字列を含む、ODC ファイルの名前と完全パスを渡します。

ODC ファイルは、HTML と XML を使用して接続情報およびクエリ情報を保存します。 このファイルの内容は、任意のテキスト エディターを使用して表示および編集できます。 ODC ファイルの拡張子は .odc です。 Microsoft Access または Microsoft Excel のデータ接続ウィザードを使用して、接続して目的のデータを取得する ODC ファイルを作成します。

AddOptions パラメーターは、Visio タイプ ライブラリで宣言される VisDataRecordsetAddOptions 列挙から取得される以下の値の 1 つ以上の組み合わせになります。 既定値はゼロ (0) で、どのオプションも設定されません。

定数	値	説明
visDataRecordsetNoExternalDataUI	1	新しいデータ レコードセットのデータは [外部データ] ウィンドウに表示されません。
visDataRecordsetNoRefreshUI	2	データ レコードセットは更新操作に含まれず、[最新のデータに更新] ダイアログ ボックスに表示されません。
visDataRecordsetNoAdvConfig	4	データ レコードセットは [データ更新の構成] ダイアログ ボックスに表示されません。
visDataRecordsetDelayQuery	8	データ レコードセットは追加されますが、次回 Refresh メソッドを呼び出すまで CommandString クエリは実行されません。
visDataRecordsetDontCopyLinks	16	データ レコードセットを追加しますが、図形データ リンクは切り取られたりコピーされたりしません。

一度割り当てた値は、DataRecordset オブジェクトが存在する間は変更することができません。

引数 Name は、データ レコードセットに表示名を割り当てるための文字列です (省略可能)。 [外部データ] ウィンドウを Visio UI に表示するように指定している場合、この引数によって渡される名前が追加したデータ レコードセットに対応する [外部データ] ウィンドウのタブに表示されます。

AddFromConnectionFile メソッドが成功すると、次のアクションが実行されます。

• DataRecordset オブジェクトを作成し、Name パラメーターに指定されている名前を割り当てます。 名前を指定しない場合、Visio はデータ レコードセットに、データのソースであるデータベース テーブルの名前を割り当てます。

• 新規または既存の DataConnection オブジェクトに DataRecordset オブジェクトを関連付けます。

• ODC ファイル内のコマンド文字列で指定されたクエリ文字列を実行し、結果のデータを取得します。

• データ ソースの列のデータ型を対応する Visio データ型にマップします。同時に、対応する Visio データ型を持たないために Visio の図形にリンクできないデータ ソースの列を削除するため、結果をフィルター処理します。

• データ レコードセットの各行に行 ID を割り当てます。 行 ID の詳細については、 DataRecordset.GetDataRowIDs プロパティのトピックを参照してください。

注:

ネットワーク接続エラー、ネットワーク タイムアウト、またはデータベース アクセス許可エラーが発生すると、AddFromConnectionFile メソッドは失敗し、例外を返します。

例

次の Microsoft Visual Basic for Applications (VBA) マクロは、AddFromConnectionString メソッドを使用して Visio 図面を接続し、Microsoft Access で提供される Northwind データベースの Products テーブル内のデータに接続する方法を示しています。 このサンプル コードを実行する前に、データ接続ウィザードを使用して ODC ファイルを作成し、 strFile 変数の値を、作成した ODC ファイルの完全なパスとファイル名に置き換えます。 必要に応じて、 strName 変数に別の値を指定します。

Public Sub AddFromConnectionFile_Example() 
 
    Dim strFile As String 
    Dim strName As String 
    Dim vsoDataRecordset As Visio.DataRecordset 
 
    strFile = "C:\Users\username \Documents\My Data Sources\Northwind.mdb Products.odc" 
 
    strName = "Data from ODC" 
 
    Set vsoDataRecordset = ThisDocument.DataRecordsets.AddFromConnectionFile(strFile, 0, strName) 
 
End Sub

サポートとフィードバック

Office VBA またはこの説明書に関するご質問やフィードバックがありますか？ サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。