QueryService.QueryEx メソッド (websvcSPSearch)
指定したクエリに対して返された検索結果ごとに DataTable を含む ADO.NET の DataSet を返します。
名前空間: websvcSPSearch
アセンブリ: STSSOAP (stssoap.dll 内)
構文
'宣言
<SoapDocumentMethodAttribute("https://microsoft.com/webservices/SharePoint/QueryService/QueryEx", RequestNamespace:="https://microsoft.com/webservices/SharePoint/QueryService", ResponseNamespace:="https://microsoft.com/webservices/SharePoint/QueryService", Use:=SoapBindingUse.Literal, ParameterStyle:=SoapParameterStyle.Wrapped)> _
Public Function QueryEx ( _
queryXml As String _
) As DataSet
'使用
Dim instance As QueryService
Dim queryXml As String
Dim returnValue As DataSet
returnValue = instance.QueryEx(queryXml)
[SoapDocumentMethodAttribute("https://microsoft.com/webservices/SharePoint/QueryService/QueryEx", RequestNamespace="https://microsoft.com/webservices/SharePoint/QueryService", ResponseNamespace="https://microsoft.com/webservices/SharePoint/QueryService", Use=SoapBindingUse.Literal, ParameterStyle=SoapParameterStyle.Wrapped)]
public DataSet QueryEx (
string queryXml
)
パラメータ
- queryXml
検索クエリ XML を指定する文字列。この XML の形式は「Windows SharePoint Services 検索の Microsoft.Search.Query スキーマ」で定義されています。
戻り値
各検索結果セットの System.Data.DataTable オブジェクトを含む System.Data.DataSet オブジェクト。
備考
検索用語の簡単なリストを含むクエリについては、Microsoft.Search.Query スキーマの QueryText 要素の type 属性を 'STRING' に設定します。SQL 構文のクエリについては、type 属性を 'MSSQLFT' に設定します。
クエリ Web サービスの Microsoft Office SharePoint Server 2007 Web アプリケーションで匿名アクセスが無効になっている場合は、Credentials プロパティを使用して Web サービス要求の資格情報を指定する必要があります。検索結果は、要求の現在のコンテキストの資格情報に基づいてトリミングされます。
Microsoft.Search.Query スキーマの要素を使用して、Query Web メソッドによって返される結果セットに関する以下のことを指定できます。
結果の並べ替えと並べ替え順序の方向に関するプロパティ (SortByProperty 要素を使用)。
ステミングを有効にするかどうか (EnableStemming 要素を使用)。
重複する結果を折りたたむかどうか (TrimDuplicates 要素を使用)。
ノイズ ワードを無視するかどうか (IgnoreAllNoiseQuery 要素を使用)。
例
次のコード例は、Query メソッドの呼び出し方法を示しています。この例では、以下のことを前提にしています。
Web サービス プロキシ クラス (この例では QueryWebServiceProxy) がコード内で参照されている。
文字列変数の queryXMLString がインスタンス化されていて、この変数の値が検索クエリを含む XML 文字列に設定されている。
QueryWebServiceProxy.QueryService queryService = new QueryWebServiceProxy.QueryService();
queryService.Credentials = System.Net.CredentialCache.DefaultCredentials;
string queryResultsString = queryService.Query(queryXMLString);
.gif "メモ") メモ : |
|---|
プロキシ クラスの Credentials プロパティを System.Net.CredentialCache クラスの DefaultCredentials プロパティ プロパティに設定すると、クライアント アプリケーションを実行している ID の資格情報を Web サービス要求で使用できます。 |