Displaying SharePoint lists in Web Parts

Applies to
Microsoft Windows® SharePoint® Services technology

When you create a built-in or custom list in Microsoft Windows SharePoint Services, Windows SharePoint Services creates a Web Part, a basic building block of a SharePoint site, to display that list. These Web Parts are called List View Web Parts. Windows SharePoint Services stores List View Web Parts in the site collection Web Part gallery. (The site collection Web Part gallery is the most central gallery of Web Parts for a work group. By default, the gallery name is the name of the site, such as "Our Team Site Web Part Gallery." )

Windows SharePoint Services gives a new List View Web Part the same name as the list. For example, if you create a custom list titled "Sample List," a List View Web Part named "Sample List" will be added to the site collection Web Part gallery. When you create a new Web site in Windows SharePoint Services, each list in the Web Site, such as the Contacts list and Tasks list, has a corresponding List View Web Part with the same title.

 Note   Because lists are specific to particular sites, List View Web Parts are not listed in the Web Part Gallery maintenance page for the site collection.

You can use List View Web Parts to customize your site by displaying lists on the home page of your site, or by displaying lists on a custom Web Part Page in your site.

You can further customize your site by using your List View Web Parts to do the following:

  • Display different views of a list.
  • Display a list in Datasheet view. Datasheet view requires that you have a Windows SharePoint Services-compatible datasheet program installed, such as Microsoft Office 2003 Professional. Datasheet view lets you add, delete, and update list entries just as you would in a spreadsheet program, such as Microsoft Office Excel 2003.
  • Connect a list to another Web Part. You can send information to another Web Part, for example.
  • Provide a help link for a list.
  • Display a list in minimized form. Users can "open" the list from the List View Web Part menu.

The procedures in this topic present some basic techniques for creating and using List View Web Parts to display and manipulate list data in your SharePoint site.

 Note   To customize SharePoint sites, including Web Part Pages, you must be a member of a site group with the following rights: Manage Lists, Add and Customize Pages, Apply Themes and Borders, and Apply Style Sheets. All of these rights are included in the Web Designer and Administrator site groups by default.

Create a List View Web Part
  • No special step is required to create a new List View Web Part. When you create a built-in or custom list, Windows SharePoint Services creates a corresponding List View Web Part that is available in the site in which the list was created. When you create a new Web site in Windows SharePoint Services, each list in the Web Site has a corresponding List View Web Part.
Insert a List View Web Part on a page

You can insert a List View Web Part on your site's Home Page or on any Web Part page.

  1. Click Modify Shared Page or Modify My Page, point to Add Web Parts, and then click Browse.

The Add Web Parts tool pane opens and the page is displayed in its design view. Notice that each Web Part zone, which is an area on the page that can contain Web Parts, is labeled.

  1. In the Add Web Parts tool pane, locate the List View Web Part that you want to insert.

 Note   To view only the List View Web Parts in a Web Part gallery, in the Add Web Parts tool pane, at the top of the Web Parts List, click Filter and, in the Show list, click Lists.

  1. Click and drag the List View Web Part into the Web Part zone where you want the list to appear. If there are other Web Parts in the zone, use the insertion bar to position the List View Web Part relative to the other Web Parts.
  2. Click the Close button Close button at the top of the Add Web Parts tool pane to close the tool pane.
Change the view used by a List View Web Part

By default, the List View Web Part displays the default view of a list. However, you can change the Web Part to display any view of the list you want.

 Note   You can change the view associated with a List View Web Part only in shared view. If Modify My Page appears at the top of a page, the page is displaying your personal view. To switch to shared view, click Modify My Page, and then click Shared View.

  1. Go to the Web Part Page that contains the List View Web Part.

 Note   Your site's home page is a Web Part Page.

  1. Click Modify Shared Page, point to Modify Shared Web Parts, and then click the name of the Web Part to change, such as "Announcements."

The Web Part's tool pane opens. You use a Web Part's tool pane to configure a Web Part's unique properties and to choose general settings that control the Web Part's layout and appearance.

  1. In the Selected View list, click the new view that you want to display.

 Note   You can also change the current view by clicking Edit the current view, and then changing the view on the Edit View page. When you do this, you change the view everywhere that it is used in the site.

  1. In the List View Web Part tool pane, click OK.
Connect a List View Web Part to another Web Part

You can connect a List View Web Part to another Web Part, including another List View Web Part. By connecting two List View Web Parts, you can sort or filter data in one Web Part based on information in the other.

  1. On the Modify Shared Page menu, click Design This Page.
  2. On the List View Web Part, click the Web Part Menu button Web Part Menu, point to Connections, and then do one of the following:
    • To pass a selected row of data to another Web Part, select Provide Row To and click the name of the Web Part to pass data to.
    • To pass all the data in the view to another Web Part, select Provide View Data To and click the name of the Web Part to pass data to.
    • To filter or sort data in the List View Web Part based on information from another Web Part, select Get Sort/Filter From and click the name of the Web Part that will provide the filtering or sorting information, such as a column value to filter on.

By using the methods described in this topic, you can start using your SharePoint lists to customize your site and make list data more dynamic and useful. In addition to using specific List View Web Part features, such as changing views or connecting a List View Web Part to another Web Part, you can customize your List View Web Parts by using general Web Part features that List View Web Parts include. For example, you can adjust the Web Part's height and width, specify whether or not the Web Part is minimized by default, turn on or off the Web Part's border and toolbar, modify the ScreenTip that appears when you rest the mouse pointer on the Web Part title, and provide links to Help content and additional files supporting a List View Web Part.

 
 
Applies to:
Deployment Center 2003, Windows Sharepoint Services 2.0