QueryService.Query メソッド (websvcSPSearch)
指定したクエリの検索結果セットを含む XML 文字列を返します。
名前空間: websvcSPSearch
アセンブリ: STSSOAP (stssoap.dll 内)
構文
'宣言
<SoapDocumentMethodAttribute("urn:Microsoft.Search/Query", RequestNamespace:="urn:Microsoft.Search", ResponseNamespace:="urn:Microsoft.Search", Use:=SoapBindingUse.Literal, ParameterStyle:=SoapParameterStyle.Wrapped)> _
Public Function Query ( _
queryXml As String _
) As String
'使用
Dim instance As QueryService
Dim queryXml As String
Dim returnValue As String
returnValue = instance.Query(queryXml)
[SoapDocumentMethodAttribute("urn:Microsoft.Search/Query", RequestNamespace="urn:Microsoft.Search", ResponseNamespace="urn:Microsoft.Search", Use=SoapBindingUse.Literal, ParameterStyle=SoapParameterStyle.Wrapped)]
public string Query (
string queryXml
)
パラメータ
- queryXml
検索クエリ XML を指定する文字列。この XML の形式は「Windows SharePoint Services 検索の Microsoft.Search.Query スキーマ」で定義されています。
戻り値
「Windows SharePoint Services 検索の Microsoft.Search.Response.Document スキーマ」で説明されている要素を使用したクエリ応答を含む文字列。
備考
検索用語の簡単なリストを含むクエリについては、Microsoft.Search.Query スキーマの QueryText 要素の type 属性を 'STRING' に設定します。
SQL 構文クエリでは、type 属性を 'MSSQLFT' に設定します。
クエリ Web サービスの Windows SharePoint Services Web アプリケーションで匿名アクセスが無効になっている場合は、Credentials プロパティを使用して Web サービス要求の資格情報を指定する必要があります。検索結果は、要求の現在のコンテキストの資格情報に基づいてトリミングされます。
関連性のある結果のみが返されます。おすすめコンテンツは結果セットに含まれません。おすすめコンテンツを結果セットに含める場合は、QueryEx メソッドを使用します。
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 サービス要求で使用できます。 |