SPQuery.Query property

取得或設定的內部使用 XML 在查詢中。

Namespace:  Microsoft.SharePoint
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

'宣告
Public Property Query As String
    Get
    Set
'用途
Dim instance As SPQuery
Dim value As String

value = instance.Query

instance.Query = value

public string Query { get; set; }

Property value

Type: System.String
字串，包含定義查詢的共同作業應用程式標記語言的片段。該字串對應到查詢中的項目連同 CAML，排除的開頭和結尾的 「 <Query></Query> 」 標籤的內部 XML。

備註

注意

您必須包含Where項目。如果不這樣做，沒有錯誤訊息，但會傳回清單中的每個項目。除了嚴重影響效能，這是具有潛在危險的案例中，當您的程式碼會對每個傳回的項目中的變更。

Examples

下列程式碼範例會使用Query屬性，來定義查詢會傳回其Field2值為大於 1000年的項目。

注意事項
如需有關如何使用 Language-Integrated 查詢 (LINQ) 查詢來擷取清單項目，在SharePoint Foundation中的資訊，請參閱Managing Data with LINQ to SharePoint。

這個範例要求using指示詞 (Imports Microsoft Visual Basic 中)， Microsoft.SharePoint和Microsoft.SharePoint.Utilities命名空間。

Dim webSite As SPWeb = SPContext.Current.Site.RootWeb
Try
    Dim list As SPList = webSite.Lists("List_Name")

    Dim query As New SPQuery()
    query.ViewFields = "<FieldRef Name='Field1'/>" + _
        "<FieldRef Name='Field2'/>"
    query.Query = "<Where><Geq><FieldRef Name='Field2'/>" + _
        "<Value Type='Number'>1000</Value></Geq></Where>"
    Dim items As SPListItemCollection = list.GetItems(query)

    Dim item As SPListItem
    For Each item In  items
        Response.Write((SPEncode.HtmlEncode(item.Xml) + "<BR>"))
    Next item
Finally
    webSite.Dispose()
End Try

using (SPWeb oWebsiteRoot = SPContext.Current.Site.RootWeb)
{
    SPList oList = oWebsiteRoot.Lists["List_Name"];

    SPQuery oQuery = new SPQuery();
    oQuery.ViewFields = "<FieldRef Name='Field1'/>" + 
        "<FieldRef Name='Field2'/>";
    oQuery.Query = "<Where><Geq><FieldRef Name='Field2'/>" +
        "<Value Type='Number'>1000</Value></Geq></Where>";
    SPListItemCollection collListItems = oList.GetItems(oQuery);

    foreach (SPListItem oListItem in collListItems)
    {
        Response.Write(SPEncode.HtmlEncode(oListItem.Xml) + "<BR>");
    }
}

注意事項
某些物件實作IDisposable介面，並且您必須避免之後不再需要保留這些物件在記憶體中。良好的程式碼撰寫方式的相關資訊，請參閱Disposing Objects。

請參閱

參照

SPQuery class

SPQuery members

Microsoft.SharePoint namespace