Procedura dettagliata: Creare una pagina dell'applicazione SharePoint

Una pagina dell'applicazione è una forma specializzata di una pagina ASP.NET. Le pagine dell'applicazione contengono contenuto unito a una pagina master di SharePoint. Per altre informazioni, vedere Creare pagine dell'applicazione per SharePoint.

Questa procedura dettagliata illustra come creare una pagina dell'applicazione e quindi eseguirne il debug usando un sito di SharePoint locale. Questa pagina mostra tutti gli elementi creati o modificati da ogni utente in tutti i siti della server farm.

In questa procedura dettagliata sono illustrati i task seguenti:

• Creazione di un progetto SharePoint.
• Aggiunta di una pagina dell'applicazione al progetto SharePoint.
• Aggiunta di controlli ASP.NET alla pagina dell'applicazione.
• Aggiunta di codice dietro i controlli ASP.NET.
• Test della pagina dell'applicazione.

Nota

I nomi o i percorsi visualizzati per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti potrebbero essere diversi nel computer in uso. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per altre informazioni, vedere Personalizzare l'IDE di Visual Studio.

Prerequisiti

• Edizioni supportate di Windows e SharePoint.

Creare un progetto di SharePoint

Creare prima di tutto un progetto SharePoint vuoto. Successivamente, si aggiungerà un elemento pagina applicazione a questo progetto.

1. Avviare Visual Studio.

2. Aprire la finestra di dialogo Nuovo progetto , espandere il nodo Office/SharePoint sotto la lingua che si desidera usare e quindi scegliere il nodo Soluzioni SharePoint.

3. Nel riquadro Modelli installati di Visual Studio scegliere il modello Di progetto vuoto di SharePoint 2010. Assegnare al progetto il nome MySharePointProject e quindi scegliere il pulsante OK .

   Verrà visualizzata la Personalizzazione guidata SharePoint. Questa procedura guidata consente di selezionare il sito che verrà usato per eseguire il debug del progetto e il livello di attendibilità della soluzione.

4. Scegliere il pulsante di opzione Distribuisci come soluzione farm e quindi scegliere il pulsante Fine per accettare il sito di SharePoint locale predefinito.

Creare una pagina dell'applicazione

Per creare una pagina dell'applicazione, aggiungere un elemento pagina applicazione al progetto.

1. In Esplora soluzioni scegliere il progetto MySharePointProject.

2. Nella barra dei menu scegliere Progetto>Aggiungi nuovo elemento.

3. Nella finestra di dialogo Aggiungi nuovo elemento scegliere la pagina applicazione (modello Solo soluzione farm).

4. Assegnare alla pagina il nome SearchItems e quindi scegliere il pulsante Aggiungi .

   La finestra di progettazione Visual Web Developer visualizza la pagina dell'applicazione nella visualizzazione Origine in cui è possibile visualizzare gli elementi HTML della pagina. La finestra di progettazione visualizza il markup per diversi Content controlli. Ogni controllo esegue il mapping a un ContentPlaceHolder controllo definito nella pagina master dell'applicazione predefinita.

Progettare il layout della pagina dell'applicazione

L'elemento Pagina applicazione consente di usare una finestra di progettazione per aggiungere ASP.NET controlli alla pagina dell'applicazione. Questa finestra di progettazione è la stessa finestra di progettazione usata in Visual Web Developer. Aggiungere un'etichetta, un elenco di pulsanti di opzione e una tabella alla visualizzazione Origine della finestra di progettazione, quindi impostare le proprietà come si farebbe quando si progetta una pagina di ASP.NET standard.

1. Scegliere Visualizza>Casella degli strumenti sulla barra dei menu.

2. Nel nodo Standard della casella degli strumenti eseguire uno dei passaggi seguenti:

   • Aprire il menu di scelta rapida per l'elemento Etichetta , scegliere Copia, aprire il menu di scelta rapida per la riga sotto il controllo contenuto PlaceHolderMain nella finestra di progettazione e quindi scegliere Incolla.

   • Trascinare l'elemento Label dalla casella degli strumenti nel corpo del controllo contenuto PlaceHolderMain.

3. Ripetere il passaggio precedente per aggiungere un elemento DropDownList e un elemento Table al controllo contenuto PlaceHolderMain .

4. Nella finestra di progettazione modificare il valore dell'attributo Text del controllo etichetta in Mostra tutti gli elementi.

5. Nella finestra di progettazione sostituire l'elemento <asp:DropDownList> con il codice XML seguente.

   <asp:DropDownList ID="DropDownList1" runat="server" AutoPostBack="true"
    OnSelectedIndexChanged="DropDownList1_SelectedIndexChanged">
       <asp:ListItem Text="Created by me" Value="Author"></asp:ListItem>
       <asp:ListItem Text="Modified by me" Value="Editor"></asp:ListItem>
   </asp:DropDownList>
   

Gestire gli eventi dei controlli nella pagina

Gestire i controlli in una pagina dell'applicazione esattamente come qualsiasi pagina ASP.NET. In questa procedura si gestirà l'evento SelectedIndexChanged dell'elenco a discesa.

1. Scegliere Codice dal menu Visualizza.

   Il file di codice della pagina dell'applicazione viene aperto nell'editor di codice.

2. Aggiungere il seguente metodo alla classe SearchItems. Questo codice gestisce l'evento SelectedIndexChanged di DropDownList chiamando un metodo che verrà creato più avanti in questa procedura dettagliata.

   C#

   protected void DropDownList1_SelectedIndexChanged(object sender, EventArgs e)
   {
       SPSecurity.RunWithElevatedPrivileges(GetItems);
      
   }
   

   VB

    Protected Sub DropDownList1_SelectedIndexChanged _
   (ByVal sender As Object, ByVal e As EventArgs) _
   Handles DropDownList1.SelectedIndexChanged
        SPSecurity.RunWithElevatedPrivileges(AddressOf GetItems)
    End Sub
   

3. Aggiungere le istruzioni seguenti all'inizio del file di codice della pagina dell'applicazione.

   C#

   using System.Web.UI.WebControls;
   using Microsoft.SharePoint.Administration;
   using System.Collections;
   

   VB

   Imports System.Web.UI.WebControls
   Imports Microsoft.SharePoint.Administration
   Imports System.Collections
   

4. Aggiungere il seguente metodo alla classe SearchItems. Questo metodo scorre tutti i siti della server farm e cerca gli elementi creati o modificati dall'utente corrente.

   C#

   private void GetItems()
   {
        SPFieldUserValue currentUser = new SPFieldUserValue
        (this.Web, this.Web.CurrentUser.ID, this.Web.CurrentUser.Name);
   
       ArrayList resultsList = new ArrayList();
   
       SPFarm thisFarm = SPFarm.Local;
       SPWebService service = thisFarm.Services.GetValue<SPWebService>("");
   
       foreach (SPWebApplication webApp in service.WebApplications)
       {
           foreach (SPSite siteCollection in webApp.Sites)
           {
               foreach (SPWeb web in siteCollection.AllWebs)
               {
                   SPListCollection lists = web.Lists;
                   foreach (SPList list in lists)
                   {
                       try
                       {
                           foreach (SPListItem item in list.Items)
                           {
                               if (item[DropDownList1.SelectedValue].ToString() ==
                                   currentUser.ToString())
                               {
                                   resultsList.Add(item);
                               }
                           }
                       }
                       catch (Exception)
                       {
                           // An error with the list. Move onto the next list.
                       }
                   }
               }
           }
       }
       CreateResultsTable(resultsList);
   
   }
   

   VB

   Private Sub GetItems()
       Dim CurrentUser As New SPFieldUserValue _
           (Me.Web, Me.Web.CurrentUser.ID, Me.Web.CurrentUser.Name)
   
       Dim ResultsList As New ArrayList()
   
       Dim ThisFarm As SPFarm = SPFarm.Local
       Dim Service As SPWebService = _
           ThisFarm.Services.GetValue(Of SPWebService)("")
   
       Dim WebApp As SPWebApplication
       For Each WebApp In Service.WebApplications
           Dim SiteCollection As SPSite
           For Each SiteCollection In WebApp.Sites
               Dim Web As SPWeb
               For Each Web In SiteCollection.AllWebs
                   Dim Lists As SPListCollection = Web.Lists
                   Dim List As SPList
                   For Each List In Lists
                       Dim Item As SPListItem
                       Try
                           For Each Item In List.Items
                               If Item(DropDownList1.SelectedValue).ToString() = _
                                   CurrentUser.ToString() Then
                                   ResultsList.Add(Item)
                               End If
                           Next Item
                       Catch exception As Exception
                           'Error in list. Move on to the next list.
                       End Try
                   Next List
               Next Web
           Next SiteCollection
       Next WebApp
       CreateResultsTable(ResultsList)
   End Sub
   

5. Aggiungere il seguente metodo alla classe SearchItems. Questo metodo visualizza gli elementi creati o modificati dall'utente corrente nella tabella.

   C#

   private void CreateResultsTable(ArrayList resultsList)
   {
       string currentList = "";
       string currentSite = "";
       Table1.Rows.Clear();
   
       foreach (SPListItem item in resultsList)
       {
           if (item.ParentList.ParentWeb.Title != currentSite)
           {
               currentSite = item.ParentList.ParentWeb.Title;
   
               TableCell newSiteCell = new TableCell();
               newSiteCell.Text = currentSite;
   
               TableRow newSiteRow = new TableRow();
               newSiteRow.Cells.Add(newSiteCell);
               newSiteRow.Font.Bold = true;
               newSiteRow.Font.Size = FontUnit.Larger;
               newSiteRow.Font.Underline = true;
   
               Table1.Rows.Add(newSiteRow);
           }
           if (item.ParentList.Title != currentList)
           {
               currentList = item.ParentList.Title;
               TableCell newListCell = new TableCell();
               newListCell.Text = currentList;
   
               TableRow newListRow = new TableRow();
               newListRow.Cells.Add(newListCell);
               newListRow.Font.Bold = true;
   
               Table1.Rows.Add(newListRow);
   
               TableCell itemHeading = new TableCell();
               itemHeading.Text = "Item";
               itemHeading.Font.Italic = true;
   
               TableCell createdHeading = new TableCell();
               createdHeading.Text = "Created";
               createdHeading.Font.Italic = true;
   
               TableCell modifiedHeading = new TableCell();
               modifiedHeading.Text = "Last Modified";
               modifiedHeading.Font.Italic = true;
   
               TableRow headingRow = new TableRow();
               headingRow.Cells.Add(itemHeading);
               headingRow.Cells.Add(createdHeading);
               headingRow.Cells.Add(modifiedHeading);
   
               Table1.Rows.Add(headingRow);
           }
   
           TableCell itemName = new TableCell();
           HyperLink itemLink = new HyperLink();
           try
           {
               itemLink.NavigateUrl = item.ParentList.ParentWeb.Url + "/" +
                   item.ParentList.Forms[PAGETYPE.PAGE_DISPLAYFORM].Url +
                   "?ID=" + item.ID;
           }
           catch (Exception)
           {
               // Some items might not have a form page. Ignore the exception.
           }
           itemLink.Text = item.DisplayName;
           itemName.Controls.Add(itemLink);
   
           TableCell created = new TableCell();
           created.Text = item["Created"].ToString();
   
           TableCell modified = new TableCell();
           modified.Text = item["Modified"].ToString();
   
           TableRow dataRow = new TableRow();
           dataRow.Cells.Add(itemName);
           dataRow.Cells.Add(created);
           dataRow.Cells.Add(modified);
   
           Table1.Rows.Add(dataRow);
       }
   }
   

   VB

   Private Sub CreateResultsTable(ByVal ResultsList As ArrayList)
       Dim CurrentList As String = ""
       Dim CurrentSite As String = ""
       Table1.Rows.Clear()
   
       Dim Item As SPListItem
       For Each Item In ResultsList
           If Item.ParentList.ParentWeb.Title <> CurrentSite Then
               CurrentSite = Item.ParentList.ParentWeb.Title
   
               Dim NewSiteCell As New TableCell()
               NewSiteCell.Text = CurrentSite
   
               Dim NewSiteRow As New TableRow()
               With NewSiteRow
                   .Cells.Add(NewSiteCell)
                   .Font.Bold = True
                   .Font.Size = FontUnit.Larger
                   .Font.Underline = True
               End With
               Table1.Rows.Add(NewSiteRow)
   
           End If
   
           If Item.ParentList.Title <> CurrentList Then
               CurrentList = Item.ParentList.Title
               Dim NewListCell As New TableCell()
               NewListCell.Text = CurrentList
   
               Dim NewListRow As New TableRow()
               With NewListRow
                   .Cells.Add(NewListCell)
                   .Font.Bold = True
               End With
               Table1.Rows.Add(NewListRow)
   
               Dim ItemHeading As New TableCell()
               With ItemHeading
                   .Text = "Item"
                   .Font.Italic = True
               End With
   
               Dim CreatedHeading As New TableCell()
               With CreatedHeading
                   .Text = "Created"
                   .Font.Italic = True
               End With
   
   
               Dim ModifiedHeading As New TableCell()
               With ModifiedHeading
                   .Text = "Last Modified"
                   .Font.Italic = True
               End With
   
               Dim HeadingRow As New TableRow()
               HeadingRow.Cells.Add(ItemHeading)
               HeadingRow.Cells.Add(CreatedHeading)
               HeadingRow.Cells.Add(ModifiedHeading)
   
               Table1.Rows.Add(HeadingRow)
           End If
   
           Dim ItemName As New TableCell()
           Dim ItemLink As New HyperLink()
           Try
               ItemLink.NavigateUrl = Item.ParentList.ParentWeb.Url & _
                   "/" & Item.ParentList.Forms(PAGETYPE.PAGE_DISPLAYFORM).Url & _
                   "?ID=" & Item.ID
           Catch exception As Exception
               ' Some items might not have a form page. Ignore the exception.
           End Try
           ItemLink.Text = Item.DisplayName
           ItemName.Controls.Add(ItemLink)
   
           Dim Created As New TableCell()
           Created.Text = Item("Created").ToString()
   
           Dim Modified As New TableCell()
           Modified.Text = Item("Modified").ToString()
   
           Dim DataRow As New TableRow()
           DataRow.Cells.Add(ItemName)
           DataRow.Cells.Add(Created)
           DataRow.Cells.Add(Modified)
   
           Table1.Rows.Add(DataRow)
       Next Item
   End Sub
   

Testare la pagina dell'applicazione

Quando si esegue il progetto, viene aperto il sito di SharePoint e viene visualizzata la pagina dell'applicazione.

1. In Esplora soluzioni aprire il menu di scelta rapida per la pagina dell'applicazione e quindi scegliere Imposta come elemento di avvio.

2. Premere F5.

   Verrà aperto il sito di SharePoint.

3. Nella pagina dell'applicazione scegliere l'opzione Modificato da me .

   La pagina dell'applicazione viene aggiornata e visualizza tutti gli elementi modificati in tutti i siti della server farm.

4. Nella pagina dell'applicazione scegliere Creato da me nell'elenco.

   La pagina dell'applicazione viene aggiornata e visualizza tutti gli elementi creati in tutti i siti della server farm.

Passaggi successivi

Per altre informazioni sulle pagine dell'applicazione SharePoint, vedere Creare pagine dell'applicazione per SharePoint.

Per altre informazioni su come progettare il contenuto della pagina di SharePoint, vedere Visual Web Designer da questi argomenti:

• Creare web part per SharePoint.

• Creare controlli riutilizzabili per web part o pagine dell'applicazione.

Contenuto correlato

• Procedura: Creare una pagina dell'applicazione
• Tipo di pagina _layouts applicazione