Názorný postup: Vytvoření webové části pro SharePoint

Článek
03/04/2013

Webové části umožňují uživatelům přímo upravit obsah, vzhled a chování stránek webu SharePoint pomocí prohlížeče.Tento názorný postup ukazuje, jak vytvořit pomocí webové části Webové části šablona zboží v roce 2010 Visual Studio.

Webová část zobrazuje zaměstnanců v mřížce dat..Uživatel Určuje umístění souboru, který obsahuje data zaměstnance.Uživatele můžete filtrovat také mřížky dat tak, aby zaměstnanci, kteří jsou správci zobrazit v seznamu pouze.

Tento návod ilustruje následující úkoly:

Vytvoření webové části pomocí aplikace Visual Studio Webové části položku šablony.
Vytvoření vlastnosti můžete nastavit uživatelské webové části.Tato vlastnost určuje umístění souboru data zaměstnance.
Vykreslení obsahu ve webové části přidáním prvků webové části řídí kolekce.
Vytvoření nové položky nabídky uvedené jako slovesa, , se zobrazí v nabídce příkazů tavené webové části.Slovesa umožňují uživateli změnit data zobrazená ve webové části.
Testování webových částí služby SharePoint.

[!POZNÁMKA]

Váš počítač může zobrazit jiné názvy nebo umístění pro některé prvky uživatelského rozhraní sady Visual Studio v následujících pokynech.Tyto prvky jsou určeny verzí aplikace Visual Studio a použitým nastavením.Další informace naleznete v tématu Nastavení aplikace Visual Studio.

Požadavky

Chcete-li dokončit tento návod, potřebujete následující komponenty:

Podporované edice systému Windows a serveru SharePoint.Další informace naleznete v tématu Požadavky na vývoj řešení služby SharePoint.
Visual Studio Professionalnebo vydání z Visual Studio aplikace Lifecycle Management (ALM).

Vytvoření prázdného projektu SharePoint

Nejprve vytvořte prázdný SharePoint projektu.Později bude přidání webové části projektu pomocí Webové části položku šablony.

Vytvořit prázdný projekt SharePoint

Start Visual Studio pomocí Spustit jako správce možnost.
Vyberte na panelu muže soubor, Nový, projektu.
V Nový projekt dialogovém okně pole, rozbalte položku SharePoint uzlu, kterou chcete použít a pak zvolte jazyk 2010 uzel.
V šablony podokně zvolte SharePoint 2010 projektua pak zvolte OK tlačítko.

Průvodce vlastním nastavením aplikace SharePoint se zobrazí.Tento průvodce umožňuje vybrat web, který bude používat k ladění projektu a úroveň důvěryhodnosti roztoku.
Zvolte nasadit jako řešení farmy přepínač a pak zvolte Dokončit tlačítko přijmout výchozí místní server SharePoint.

Přidání webové části do projektu

Přidat Webové části položky projektu.Webové části přidá soubor webové části kódu.Později bude přidán kód kód souboru webové části k vykreslení obsahu webové části.

Chcete-li přidat webovou část do projektu

V řádku nabídek zvolte projektu, Přidat novou položku.
V Přidat novou položku v dialogovém okně pole Nainstalované šablony podokně rozbalte SharePoint uzlu a pak zvolte 2010 uzel.
Zvolte v seznamu šablony služby SharePoint Webové části šablony a pak zvolte Přidat tlačítko.

Webové části položky se zobrazí v Aplikaci Solution Explorer.

Vykreslení obsahu ve webové části

Ovládací prvky, které chcete zobrazit ve webové části přidáním do kolekce controls třídy webové části můžete určit.

Vykreslení obsahu ve webové části

V Aplikaci Solution Explorer, otevřete WebPart1.vb (v jazyce Visual Basic) nebo WebPart1.cs (v C#).

Soubor webové části kódu se otevře v editoru kódu.
Přidejte na začátek souboru webové části kódu následující příkazy.
```
Imports System.Data
```
```
using System.Data;
```
Přidejte následující kód do třídy WebPart1.Tento kód deklaruje následující pole:
- Mřížky dat ve webové části zobrazení zaměstnanců.
- Text zobrazený na ovládací prvek, který slouží k filtrování dat tabulky.
- Popisek, který zobrazuje chybu, pokud je mřížka data nelze zobrazit data.
- Řetězec, který obsahuje cestu k souboru data zaměstnance.
```
Private grid As DataGrid
Private Shared verbText As String = "Show Managers Only"
Private errorMessage As New Label()
Protected xmlFilePath As String
```
```
private DataGrid grid;
private static string verbText = "Show Managers Only";
private Label errorMessage = new Label();
protected string xmlFilePath;
```

Přidejte následující kód do třídy WebPart1.Tento kód přidá vlastní vlastnost s názvem DataFilePath webové části.Vlastní vlastnost je vlastnost, kterou lze nastavit uživatele služby SharePoint.Vlastnost získává a nastavuje umístění datového souboru XML, který slouží k naplnění dat mřížky.

<Personalizable(PersonalizationScope.[Shared]), _
    WebBrowsable(True), WebDisplayName("Path to Employee Data File"), _
    WebDescription("Location of the XML file that contains employee data")> _
Public Property DataFilePath() As String
    Get
        Return xmlFilePath
    End Get
    Set(ByVal value As String)
        xmlFilePath = value
    End Set
End Property

[Personalizable(PersonalizationScope.Shared), WebBrowsable(true),
WebDisplayName("Path to Employee Data File"),
WebDescription("Location of the XML file that contains employee data")]
public string DataFilePath
{
    get
    {
        return xmlFilePath;
    }
    set
    {
        xmlFilePath = value;
    }
}

Nahradit CreateChildControls metodou s následující kód.Tento kód provede následující úkoly:

Přidá mřížky dat a popisek, který je deklarován v předchozím kroku.
Vazba mřížky dat do souboru XML, který obsahuje data o zaměstnancích.

Protected Overloads Overrides Sub CreateChildControls()

    'Define the grid control that displays employee data in the Web Part.
    grid = New DataGrid()
    With grid
        .Width = Unit.Percentage(100)
        .GridLines = GridLines.Horizontal
        .HeaderStyle.CssClass = "ms-vh2"
        .CellPadding = 2
        .BorderWidth = Unit.Pixel(5)
        .HeaderStyle.Font.Bold = True
        .HeaderStyle.HorizontalAlign = HorizontalAlign.Center
    End With



    'Populate the grid control with data in the employee data file.
    Try
        Dim dataset As New DataSet()
        dataset.ReadXml(xmlFilePath, XmlReadMode.InferSchema)
        grid.DataSource = dataset
        grid.DataBind()
    Catch x As Exception
        errorMessage.Text += x.Message
    End Try

    'Add control to the controls collection of the Web Part.
    Controls.Add(grid)
    Controls.Add(errorMessage)
    MyBase.CreateChildControls()

End Sub

protected override void CreateChildControls()
{
    // Define the grid control that displays employee data in the Web Part.
    grid = new DataGrid();
    grid.Width = Unit.Percentage(100);
    grid.GridLines = GridLines.Horizontal;
    grid.HeaderStyle.CssClass = "ms-vh2";
    grid.CellPadding = 2;
    grid.BorderWidth = Unit.Pixel(5);
    grid.HeaderStyle.Font.Bold = true;
    grid.HeaderStyle.HorizontalAlign = HorizontalAlign.Center;

    // Populate the grid control with data in the employee data file.
    try
    {
        DataSet dataset = new DataSet();
        dataset.ReadXml(xmlFilePath, XmlReadMode.InferSchema);
        grid.DataSource = dataset;
        grid.DataBind();
    }
    catch (Exception x)
    {
        errorMessage.Text += x.Message;
    }

    // Add control to the controls collection of the Web Part.
    Controls.Add(grid);
    Controls.Add(errorMessage);
    base.CreateChildControls();
}

Přidat metodu WebPart1 třídy.Tento kód provede následující úkoly:

Vytvoří příkaz, který se zobrazí v nabídce webové části příkazů tavené webové části.
Zpracovává událost, která je aktivována, když uživatel vybere příkaz v nabídce příkazů.Tento kód filtruje seznam zaměstnanců, který se zobrazí v mřížce dat..

Public Overrides ReadOnly Property Verbs() As WebPartVerbCollection
    Get
        Dim customVerb As New WebPartVerb("Manager_Filter_Verb", _
            New WebPartEventHandler(AddressOf CustomVerbEventHandler))

        customVerb.Text = verbText
        customVerb.Description = "Shows only employees that are managers"

        Dim newVerbs() As WebPartVerb = {customVerb}

        Return New WebPartVerbCollection(MyBase.Verbs, newVerbs)
    End Get
End Property

Protected Sub CustomVerbEventHandler(ByVal sender As Object, ByVal args As WebPartEventArgs)
    Dim titleColumn As Integer = 2

    Dim item As DataGridItem
    For Each item In grid.Items
        If item.Cells(titleColumn).Text <> "Manager" Then
            If item.Visible = True Then
                item.Visible = False
            Else
                item.Visible = True
            End If
        End If
    Next item
    If verbText = "Show Managers Only" Then
        verbText = "Show All Employees"
    Else
        verbText = "Show Managers Only"
    End If
End Sub

public override WebPartVerbCollection Verbs
{
    get
    {
        WebPartVerb customVerb = new WebPartVerb("Manager_Filter_Verb",
            new WebPartEventHandler(CustomVerbEventHandler));

        customVerb.Text = verbText;
        customVerb.Description = "Shows only employees that are managers";

        WebPartVerb[] newVerbs = new WebPartVerb[] { customVerb };

        return new WebPartVerbCollection(base.Verbs, newVerbs);
    }
}

protected void CustomVerbEventHandler(object sender, WebPartEventArgs args)
{
    int titleColumn = 2;

    foreach (DataGridItem item in grid.Items)
    {
        if (item.Cells[titleColumn].Text != "Manager")
        {
            if (item.Visible == true)
            {
                item.Visible = false;
            }
            else
            {
                item.Visible = true;
            }
        }

    }
    if (verbText == "Show Managers Only")
    {
        verbText = "Show All Employees";
    }
    else
    {
        verbText = "Show Managers Only";
    }
}

Testování webové části

Web služby SharePoint se otevře při spuštění projektu.Webová část je automaticky přidán do Galerie webových částí služby SharePoint.Webové části můžete přidat na libovolnou stránku webové části.

Testování webové části

Vložte následující kód XML do souboru programu Poznámkový blok.Tento soubor XML obsahuje ukázková data, která se zobrazí ve webové části.

<?xml version="1.0" encoding="utf-8" ?>
    <employees xmlns="https://schemas.microsoft.com/vsto/samples">
       <employee>
           <name>David Hamilton</name>
           <hireDate>2001-05-11</hireDate>
           <title>Sales Associate</title>
       </employee>
       <employee>
           <name>Karina Leal</name>
           <hireDate>1999-04-01</hireDate>
           <title>Manager</title>
       </employee>
       <employee>
           <name>Nancy Davolio</name>
           <hireDate>1992-05-01</hireDate>
           <title>Sales Associate</title>
       </employee>
       <employee>
           <name>Steven Buchanan</name>
           <hireDate>1955-03-04</hireDate>
           <title>Manager</title>
       </employee>
       <employee>
           <name>Suyama Michael</name>
           <hireDate>1963-07-02</hireDate>
           <title>Sales Associate</title>
       </employee>
    </employees>

V programu Poznámkový blok, v řádku nabídek zvolte soubor, Uložit jako.
V Uložit jako v dialogovém okně pole Uložit jako typ vyberte Všechny soubory.
V název souboru zadejte data.xml.
Pomocí zvolit libovolnou složku Procházet složky tlačítko a poté zvolte Uložit tlačítko.
V aplikaci Visual Studio, zvolte F5 klíč.

Otevře se web služby SharePoint.
Na Akce webu nabídce zvolte Další možnosti.
V vytvořit zvolte Stránky webové části zadejte a potom klepněte vytvořit tlačítko.
V Nové stránky webové části stránky, název stránky SampleWebPartPage.aspxa pak zvolte vytvořit tlačítko.

Zobrazí se stránka webové části.
Vyberte libovolné zóny na stránce webové části.
V horní části stránky, zvolte Vložit kartu a pak zvolte Webové části tlačítko.
V kategorie podokně zvolte vlastní složky, zvolte WebPart1 webové části a pak zvolte Přidat tlačítko.

Webová část zobrazí na stránce.

Testování vlastní vlastnosti

Naplnit zobrazené ve webové části mřížky dat, zadejte cestu k souboru XML, který obsahuje data o zaměstnanci.

Testování vlastních vlastností

Zvolte šipku na pravé straně webové části a pak zvolte Upravit webovou část ze zobrazené nabídky.

Podokna, které obsahuje vlastnosti webové části se zobrazí na pravé straně stránky.
V podokně rozbalte různé uzel, zadejte cestu k souboru XML, který jste dříve vytvořili, zvolte použít tlačítko a poté zvolte OK tlačítko.

Ověřte, že se zobrazí ve webové části Seznam zaměstnanců.

Testování sloveso webové části

Zobrazení a skrytí zaměstnanců, kteří nejsou manažeři klepnutím na položku, která se objeví v nabídce webové části akce.

Testování sloveso webové části

Zvolte šipku na pravé straně webové části a pak zvolte Zobrazit pouze vedoucí ze zobrazené nabídky.

Ve webové části se zobrazují pouze zaměstnanci, kteří jsou správci.
Zvolte znovu na šipku a zvolte Zobrazit všechny zaměstnance ze zobrazené nabídky.

Všichni zaměstnanci se zobrazí ve webové části.

Viz také

Úkoly

Jak: vytvoření webové služby SharePoint

Jak: vytvoření webové služby SharePoint pomocí Návrháře

Názorný postup: Vytvoření webové části SharePoint pomocí Návrháře

Další zdroje

Vytvoření webové části pro SharePoint

Sdílet prostřednictvím

Názorný postup: Vytvoření webové části pro SharePoint

Požadavky

Vytvoření prázdného projektu SharePoint

Vytvořit prázdný projekt SharePoint

Přidání webové části do projektu

Chcete-li přidat webovou část do projektu

Vykreslení obsahu ve webové části

Vykreslení obsahu ve webové části

Testování webové části

Testování webové části

Testování vlastní vlastnosti

Testování vlastních vlastností

Testování sloveso webové části

Testování sloveso webové části

Viz také

Úkoly

Další zdroje

Další materiály