Návod: Vytvoření webové části Silverlight, která zobrazuje OData pro SharePoint

SharePoint 2010 zveřejňuje data seznamu pomocí OData. V SharePointu je služba OData implementována službou RESTful ListData.svc. Tento návod ukazuje, jak vytvořit webovou část SharePointu, která je hostitelem aplikace Silverlight. Aplikace Silverlight zobrazí informace o seznamu oznámení sharepointu pomocí ListData.svc. Další informace naleznete v tématu Rozhraní REST služby SharePoint Foundation a Open Data Protocol.

Poznámka:

Váš počítač může v následujících pokynech zobrazovat odlišné názvy nebo umístění některých prvků uživatelského rozhraní sady Visual Studio. Tyto prvky jsou určeny edicí sady Visual Studio a použitým nastavením. Další informace naleznete v tématu Přizpůsobení integrovaného vývojového prostředí (IDE).

Požadavky

K dokončení tohoto návodu budete potřebovat následující komponenty:

• Podporované edice systému Microsoft Windows a SharePoint.

• Visual Studio 2012.

Vytvoření aplikace Silverlight a webové části Silverlight

Nejprve v sadě Visual Studio vytvořte aplikaci Silverlight. Aplikace Silverlight načte data ze seznamu oznámení služby SharePoint pomocí služby ListData.svc.

Poznámka:

Žádné verze Silverlightu před verzí 4.0 nepodporují požadovaná rozhraní pro odkazování na data sharepointového seznamu.

Vytvoření aplikace Silverlight a webové části Silverlight

1. Na řádku nabídek zvolte Soubor>nový>projekt, aby se zobrazilo dialogové okno Nový projekt.

2. Rozbalte uzel SharePointu v sadě Visual C# nebo Visual Basic a zvolte uzel 2010.

3. V podokně šablon zvolte šablonu webové části Silverlight sharepointu 2010.

4. Do pole Název zadejte SLWebPartTest a pak zvolte tlačítko OK.

   Zobrazí se dialogové okno Průvodce přizpůsobením SharePointu.

5. Na stránce Zadat web a úroveň zabezpečení pro ladění zadejte adresu URL webu serveru SharePoint, kde chcete ladit definici webu, nebo použijte výchozí umístění (název systému http:///).

6. V části Co je úroveň důvěryhodnosti pro toto řešení SharePointu? zvolte tlačítko Nasadit jako řešení farmy.

   I když tento příklad používá řešení farmy, je možné projekty webových částí Silverlight nasadit jako řešení farmy nebo izolovaného prostoru (sandbox). Další informace o řešeních v izolovaném prostoru (sandbox) a farmových řešeních najdete v tématu Aspekty řešení v izolovaném prostoru (sandbox).

7. V části Jak chcete přidružit webovou část Silverlight na stránce Zadat informace o konfiguraci silverlightu , zvolte možnost Vytvořit nový projekt Silverlight a přidružte ho k tlačítku možnosti webové části .

8. Změňte název na SLApplication, nastavte jazyk na Visual Basic nebo Visual C# a potom nastavte verzi Silverlightu na Silverlight 4.0.

9. Zvolte tlačítko Dokončit. Projekty se zobrazí v Průzkumník řešení.

   Řešení obsahuje dva projekty: aplikaci Silverlight a webovou část Silverlight. Aplikace Silverlight načte a zobrazí data seznamu ze SharePointu a webová část Silverlight je hostitelem aplikace Silverlight a umožňuje ji zobrazit v SharePointu.

Přizpůsobení aplikace Silverlight

Přidejte do aplikace Silverlight prvky kódu a návrhu.

Přizpůsobení aplikace Silverlight

1. Do aplikace Silverlight přidejte odkaz na sestavení System.Windows.Data. Další informace naleznete v tématu Postupy: Přidání nebo odebrání odkazů pomocí dialogového okna Přidat odkaz.

2. V Průzkumník řešení otevřete místní nabídku pro odkazy a pak zvolte Přidat odkaz na službu.

   Poznámka:

   Pokud používáte Visual Basic, musíte zvolit ikonu Zobrazit všechny soubory v horní části Průzkumník řešení a zobrazit uzel Reference.

3. Do pole Adresa dialogového okna Přidat odkaz služby zadejte adresu URL sharepointového webu, například http://MySPSitea pak zvolte tlačítko Přejít .

   Když Silverlight vyhledá službu SharePoint OData ListData.svc, nahradí adresu úplnou adresou URL služby. V tomto příkladu http://myserver se stane http://myserver/_vti_bin/ListData.svc.

4. Kliknutím na tlačítko OK přidáte odkaz na službu do projektu a použijete výchozí název služby ServiceReference1.

5. Na řádku nabídek zvolte Sestavit>řešení.

6. Přidejte do projektu nový zdroj dat založený na službě SharePoint. Uděláte to tak, že na řádku nabídek zvolíte Zobrazit>další zdroje dat Windows.>

   Okno Zdroje dat zobrazuje všechna dostupná data sharepointového seznamu, jako jsou úkoly, oznámení a kalendář.

7. Přidejte data seznamu Oznámení do aplikace Silverlight. Oznámení můžete přetáhnout z okna Zdroje dat do návrháře Silverlightu.

   Tím se vytvoří ovládací prvek mřížky vázaný na seznam oznámení webu SharePointu.

8. Změňte velikost ovládacího prvku mřížky tak, aby odpovídal stránce Silverlightu.

9. Do souboru kódu MainPage.xaml (MainPage.xaml.cs pro Visual C# nebo MainPage.xaml.vb pro Visual Basic) přidejte následující odkazy na obor názvů.

   C#

   // Add the following three using directives.
   using SLApplication.ServiceReference1;
   using System.Windows.Data;
   using System.Data.Services.Client;
   

   VB

   ' Add the following three Imports statements.
   Imports SLApplication.ServiceReference1
   Imports System.Windows.Data
   Imports System.Data.Services.Client
   

10. Na začátek třídy přidejte následující deklarace proměnných.

    C#

    private TeamSiteDataContext context;
    private CollectionViewSource myCollectionViewSource;
    DataServiceCollection<AnnouncementsItem> announcements = new DataServiceCollection<AnnouncementsItem>();
    

    VB

    Private context As TeamSiteDataContext
    Private myCollectionViewSource As CollectionViewSource
    Private announcements As New DataServiceCollection(Of AnnouncementsItem)()
    

11. UserControl_Loaded Nahraďte postup následujícím kódem.

    C#

    private void UserControl_Loaded_1(object sender, RoutedEventArgs e)
    {
        // The URL for the OData service.
        // Replace <server name> in the next line with the name of your
        // SharePoint server.
        context = new TeamSiteDataContext(new Uri("http://ServerName>/_vti_bin/ListData.svc"));
    
        // Do not load your data at design time.
        if (!System.ComponentModel.DesignerProperties.GetIsInDesignMode(this))
        {
            //Load your data here and assign the results to the CollectionViewSource.
            myCollectionViewSource = (System.Windows.Data.CollectionViewSource)this.Resources["announcementsViewSource"];
            announcements.LoadCompleted += new EventHandler<LoadCompletedEventArgs>(announcements_LoadCompleted);
            announcements.LoadAsync(context.Announcements);
        }
    }
    

    VB

    Private Sub UserControl_Loaded_1(sender As Object, e As RoutedEventArgs)
        ' The URL for the OData service.
        ' Replace <server name> in the next line with the name of your SharePoint server.
        context = New TeamSiteDataContext(New Uri("http://<server name>/_vti_bin/ListData.svc"))
    
        ' Do not load your data at design time.
        If Not System.ComponentModel.DesignerProperties.GetIsInDesignMode(Me) Then
            'Load your data here and assign the results to the CollectionViewSource.
            myCollectionViewSource =   DirectCast(Me.Resources("announcementsViewSource"), System.Windows.Data.CollectionViewSource)
            announcements.LoadCompleted += New EventHandler(Of LoadCompletedEventArgs)(AddressOf announcements_LoadCompleted)
            announcements.LoadAsync(context.Announcements)
        End If
    End Sub
    

    Zástupný symbol ServerName nahraďte názvem vašeho serveru, na kterém běží SharePoint.

12. Přidejte následující postup zpracování chyb.

    C#

    void announcements_LoadCompleted(object sender, LoadCompletedEventArgs e)
    {
        // Handle any errors.
        if (e.Error == null)
        {
            myCollectionViewSource.Source = announcements;
        }
        else
        {
            MessageBox.Show(string.Format("ERROR: {0}", e.Error.Message));
        }
    }
    

    VB

    Private Sub announcements_LoadCompleted(sender As Object, e As LoadCompletedEventArgs)
        ' Handle any errors.
        If e.[Error] Is Nothing Then
            myCollectionViewSource.Source = announcements
        Else
            MessageBox.Show(String.Format("ERROR: {0}", e.[Error].Message))
        End If
    End Sub
    
    

Úprava webové části Silverlight

Změňte vlastnost v projektu webové části Silverlight a povolte ladění Silverlightu.

Úprava webové části Silverlight

1. Otevřete místní nabídku projektu webové části Silverlight (SLWebPartTest) a pak zvolte Vlastnosti.

2. V okně Vlastnosti zvolte kartu SharePointu .

3. Pokud ještě není zaškrtnuté, zaškrtněte políčko Povolit ladění silverlightu (místo ladění skriptů).

4. Uložte projekt.

Testování webové části Silverlight

Otestujte novou webovou část Silverlight v SharePointu, abyste měli jistotu, že správně zobrazuje data sharepointového seznamu.

Otestování webové části Silverlight

1. Zvolte klávesu F5 pro sestavení a spuštění řešení SharePointu.

2. V SharePointu v nabídce Akce webu zvolte Nová stránka.

3. V dialogovém okně Nová stránka zadejte název, například test webové části SL, a pak zvolte tlačítko Vytvořit.

4. V návrháři stránek na kartě Nástroje pro úpravy zvolte Vložit.

5. Na pásu karet zvolte webovou část.

6. V poli Kategorie zvolte vlastní složku.

7. V seznamu Webové části zvolte webovou část Silverlight a pak kliknutím na tlačítko Přidat webovou část přidejte do návrháře.

8. Po přidání všech požadovaných doplňků na webovou stránku zvolte kartu Stránka a pak na panelu nástrojů zvolte tlačítko Uložit a zavřít .

   Webová část Silverlight by teď měla zobrazovat data oznámení z sharepointového webu. Ve výchozím nastavení je stránka uložená v seznamu Stránky webu v SharePointu.

   Poznámka:

   Při přístupu k datům v Silverlightu napříč doménami chrání Silverlight před ohroženími zabezpečení, která je možné použít ke zneužití webových aplikací. Pokud při přístupu ke vzdáleným datům v silverlightu narazíte na problémy, přečtěte si téma Zpřístupnění služby napříč hranicemi domény.

Související obsah

• Vytvoření webových částí pro SharePoint
• Nasazení, publikování a upgrade balíčků řešení SharePointu