Compartilhar via


SPQuery.Folder property

Obtém ou define a pasta em uma biblioteca de documentos do qual retornar itens na consulta.

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

Syntax

'Declaração
Public Property Folder As SPFolder
    Get
    Set
'Uso
Dim instance As SPQuery
Dim value As SPFolder

value = instance.Folder

instance.Folder = value
public SPFolder Folder { get; set; }

Property value

Type: Microsoft.SharePoint.SPFolder
Um objeto SPFolder que representa a pasta.

Examples

O exemplo de código a seguir usa a propriedade Folder para especificar a subpasta da qual retornar itens em uma biblioteca de documentos.

Dica

Para obter informações sobre como usar consultas Language-Integrated Query (LINQ) para recuperar itens de lista em SharePoint Foundation, consulte Managing Data with LINQ to SharePoint.

Este exemplo requer diretivas de using (Imports no Microsoft Visual Basic) para os namespaces Microsoft.SharePoint e Microsoft.SharePoint.Utilities .

Dim webSite As SPWeb = SPContext.Current.Site.RootWeb
Try
    webSite.Lists.IncludeRootFolder = True
    Dim list As SPList = webSite.Lists("Document_Library_Name")
    Dim subFolder As SPFolder = _
      list.RootFolder.SubFolders("Folder_Name")

    Dim query As New SPQuery()
    query.Folder = subFolder
    Dim items As SPListItemCollection = list.GetItems(query)

    Dim item As SPListItem
    For Each item In  items
        Response.Write((SPEncode.HtmlEncode(item.File.Name) + "<BR>"))
    Next item
Finally
    webSite.Dispose()
End Try
using (SPWeb oWebsiteRoot = SPContext.Current.Site.RootWeb)
{

    oWebsiteRoot.Lists.IncludeRootFolder = true;
    SPList oList = oWebsiteRoot.Lists["Document_Library_Name"];
    SPFolder oFolder = oList.RootFolder.SubFolders["Folder_Name"];

    SPQuery oQuery = new SPQuery();
    oQuery.Folder = oFolder;
    SPListItemCollection collListItems = oList.GetItems(oQuery);

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

Dica

Determinados objetos implementam a interface IDisposable , e você deve evitar reter esses objetos na memória depois que eles não são mais necessários. Para obter informações sobre boas práticas de codificação, consulte Disposing Objects.

Ver também

Referência

SPQuery class

SPQuery members

Microsoft.SharePoint namespace