6.4.2 .NET APIの場合

ダイレクト検索には、SearchByKeyメソッドを使用します。

.NET APIでのダイレクト検索の流れについて、以下の図に示します。

図6.5 ダイレクト検索の流れ

記述例

ShunService service = new ShunService();
service.Connect();

ShunRecord record1 = new ShunRecord();
ShunRecord record2 = new ShunRecord();
ShunRecord record3= new ShunRecord();
record1.Key = "20061101,00000001";                                       (1)
record2.Key = "20061101,00000002";                                       (1)
record3.Key = "20061101,00000003";                                       (1)

ShunKeyRequirement keyReq = new ShunKeyRequirement();                    (2)
keyReq.KeyName = "key1";                                                 (3)
keyReq.SearchType = ShunKeySearchType.CompleteMatch;                     (3)
keyReq.Records.Add( record1 );                                           (3)
keyReq.Records.Add( record2 );                                           (3)
keyReq.Records.Add( record3 );                                           (3)

ShunResultSet rs = service.SearchByKey( keyReq, "/" );                   (4)
Console.WriteLine( "[結果件数] = " + rs.ReturnCount );
foreach ( ShunRecord record in rs.Records ) {
  Console.WriteLine( "[結果] = " + record.Data );
}

service.Disconnect();

(1) ダイレクトアクセスキーの設定: ShunRecordオブジェクトにダイレクトアクセスキーを設定します。

(2) ShunKeyRequirementオブジェクトの作成: ShunKeyRequirementオブジェクトを作成します。

(3) ShunKeyRequirementオブジェクトへの設定: ShunKeyRequirementオブジェクトにダイレクトアクセスキー名、ShunRecordオブジェクトを設定します。

ポイント
Addメソッドで複数のShunRecordオブジェクトを指定することで、一度に複数のXML文書を取得することができます。

(4) 検索の実行(ShunResultSetオブジェクトの作成): リターン式とShunKeyRequirementオブジェクトをSearchByKeyメソッドに指定し、検索の実行をします。検索した結果としてShunResultSetオブジェクトが作成されます。

参照

ダイレクトアクセスのサンプルプログラムは、以下を参照してください。

C# .NETの場合：“G.3.2 ダイレクトアクセスキーを使用してデータを検索する”
VB .NETの場合：“H.3.2 ダイレクトアクセスキーを使用してデータを検索する”
C++ .NETの場合：“I.3.2 ダイレクトアクセスキーを使用してデータを検索する”