Lists.GetListAndView Method

Returns the list and view schemas for the specified list.

Namespace:  [Lists Web service]
Web service reference: http://Site/_vti_bin/Lists.asmx

Syntax

'Declaration
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/GetListAndView", RequestNamespace := "https://schemas.microsoft.com/sharepoint/soap/",  _
    ResponseNamespace := "https://schemas.microsoft.com/sharepoint/soap/",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Function GetListAndView ( _
    listName As String, _
    viewName As String _
) As XmlNode
'Usage
Dim instance As Lists
Dim listName As String
Dim viewName As String
Dim returnValue As XmlNode

returnValue = instance.GetListAndView(listName, _
    viewName)
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/GetListAndView", RequestNamespace = "https://schemas.microsoft.com/sharepoint/soap/", 
    ResponseNamespace = "https://schemas.microsoft.com/sharepoint/soap/", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public XmlNode GetListAndView(
    string listName,
    string viewName
)

Parameters

  • listName
    Type: System.String

    A string that contains either the title or GUID for the list. When querying the UserInfo table, the string contains "UserInfo".

  • viewName
    Type: System.String

    A string that contains the GUID for the view. If no value is specified, returns the default view schema for the list.

Return Value

Type: System.Xml.XmlNode
A fragment in Collaborative Application Markup Language (CAML) in the following form that contains the list and view schemas, and that can be assigned to a System.Xml.XmlNode object.

<ListAndView xmlns="https://schemas.microsoft.com/sharepoint/soap/">
   <List DocTemplateUrl=
         "" DefaultViewUrl="/Site_Name/Lists/List_Name/AllItems.aspx" 
      ID="{42FC00F1-F7EA-4ECE-9D4C-F47A95A806B2}" Title="List_Name" 
      Description="TestCustList" ImageUrl="/_layouts/images/itgen.gif" 
      Name="{42FC00F1-F7EA-4ECE-9D4C-F47A95A806B2}" BaseType="0" 
         ServerTemplate="100" 
      Created="20030616 18:37:44" Modified="20030618 18:26:57" 
         LastDeleted="20030616 18:37:44" 
      Version="2" Direction="none" ThumbnailSize="" WebImageWidth="" 
         WebImageHeight="" 
      Flags="4096" ItemCount="5" AnonymousPermMask="" 
         RootFolder="/Site_Name/Lists/List_Name" 
      ReadSecurity="1" WriteSecurity="1" Author="1" 
         EventSinkAssembly="" EventSinkClass="" 
      EventSinkData="" EmailInsertsFolder="" AllowDeletion="True" 
         AllowMultiResponses="False" 
      EnableAttachments="True" EnableModeration="False" 
         EnableVersioning="False" Hidden="False" 
      MultipleDataList="False" Ordered="False" ShowUser="True">
      <Fields>
         <Field ColName="tp_ID" ReadOnly="TRUE" Type="Counter" 
            Name="ID" PrimaryKey="TRUE" 
            DisplayName="ID" FromBaseType="TRUE" />
         <Field Type="Text" Name="Title" DisplayName="Title" 
            Required="TRUE" FromBaseType="TRUE" 
            ColName="nvarchar1" />
            ...
      <RegionalSettings>
         <Language>1033</Language>
         <Locale>1033</Locale>
         <AdvanceHijri>0</AdvanceHijri>
         <CalendarType>1</CalendarType>
         <Time24>False</Time24>
         <TimeZone>480</TimeZone>
         <SortOrder>2070</SortOrder>
         <Presence>True</Presence>
      </RegionalSettings>
   </List>
   <View Name="{8C25D6A5-93B4-4611-B449-55A7C3B7B41A}" Type="HTML" 
      DisplayName="View_Name" Url="Lists/List_Name/View_File.aspx" 
      BaseViewID="1">
      <Query />
      <ViewFields>
         <FieldRef Name="Attachments" />
         <FieldRef Name="LinkTitle" />
         <FieldRef Name="DateColumn" />
         ...
      </ViewFields>
      <RowLimit Paged="TRUE">100</RowLimit>
   </View>
</ListAndView>

Examples

The following code example displays the list and view schemas for a specified list on the current site.

This example requires that a using (Visual C#) or Imports (Visual Basic) directive be included for the System.Xml namespace.

Dim listService As New Web_Reference_Folder.Lists()
listService.Credentials = System.Net.CredentialCache.DefaultCredentials

Dim ndLists As XmlNode = listService.GetListAndView("List_Name", 
    "8c25d6a5-93b4-4611-b449-55a7c3b7b41a")

MessageBox.Show(ndLists.OuterXml)
Web_Reference_Folder.Lists listService = new Web_Reference_Folder.Lists();
listService.Credentials= System.Net.CredentialCache.DefaultCredentials;

XmlNode ndLists = listService.GetListAndView("List_Name",
   "8c25d6a5-93b4-4611-b449-55a7c3b7b41a");

MessageBox.Show(ndLists.OuterXml);

See Also

Reference

Lists Class

Lists Members

Lists Web Service