Aracılığıyla paylaş

İzlenecek yol: SharePoint Web Bölümü oluşturma

  • Makale

Web bölümleri, kullanıcıların içeriği, görünümünü ve davranışını SharePoint sitesindeki sayfaları bir tarayıcı kullanarak doğrudan değiştirmek olanak sağlar.Bu izlenecek yolda kullanarak Web Bölümü nasýl yaratýlacaðýný gösterir Web Bölümü Visual Studio 2010 Madde şablonunda.

Web Bölümü Çalışanlar veri kılavuzunda görüntüler.Kullanıcının çalışan verilerini içeren dosyanın konumunu belirtir.Kullanıcı yöneticilerinin çalışanların yalnızca listede görünmesini sağlayacak şekilde, veri kılavuzu da filtre uygulayabilirsiniz.

Bu örneklerde aşağıdaki görevler gösterilir:

  • Visual Studio kullanarak Web Bölümü oluşturma Web Bölümü Item template.

  • Özellik oluşturma Web Bölümü kullanıcı tarafından ayarlanabilir.Bu özellik, çalışanın veri dosyasının konumunu belirtir.

  • Web Bölümü denetimleri ekleyerek Web bölümünde içerik oluşturma, koleksiyon denetler.

  • Yeni menü öğesi oluşturma olarak anılacaktır bir fiil, işlenmiş Web Bölümü'nün fiiller menü görüntülenir.Fiiller Web Bölümünde görüntülenen veriyi değiştirmek kullanıcı etkinleştirin.

  • SharePoint Web Bölümü test.

    [!NOT]

    Bilgisayarınız, aşağıdaki yönergelerde yer alan Visual Studio kullanıcı arayüzü öğelerinden bazıları için farklı adlar veya konumlar gösterebilir.Bu öğeleri bilgisayarınızdaki Visual Studio sürümü ve kullandığınız ayarlar belirler.Daha fazla bilgi için bkz. Visual Studio ayarları.

Önkoşullar

Bu örneği tamamlamak için aşağıdaki bileşenler gerekmektedir:

Boş bir SharePoint proje oluşturma

İlk olarak, boş SharePoint projesi oluşturun.Daha sonra Web Bölümü project kullanarak eklediğiniz Web Bölümü Item template.

Boş bir SharePoint proje oluşturmak için

  1. Başlat Visual Studio kullanarak yönetici olarak çalıştır seçeneği.

  2. Erkekler çubuğunda Seç dosyasını, Yeni, Proje.

  3. İçinde Yeni bir proje iletişim kutusunda, genişletme SharePoint düğümü altında kullanın ve sonra seçmek istediğiniz dil 2010 düğümü.

  4. İçinde şablonları bölmesinde seçin SharePoint 2010 projeve sonra seçin Tamam düğme.

    SharePoint Özelleştirme Sihirbazı'nı görünür.Bu sihirbaz, proje ve çözüm güven düzeyini hata ayıklamak için kullanacağınız site seçmenize olanak sağlar.

  5. Seçin dağıtma grubu çözümü olarak seçenek düğmesini ve sonra Son varsayılan yerel SharePoint sitesi kabul etmek için düğme.

Projeye bir Web Bölümü ekleme

Add bir Web Bölümü proje öğesi.Web Bölümü öğe Web Bölümü kod dosyası ekler.Daha sonra Web Bölümünün içeriğini işlemek için Web Bölümü kod dosyası kodu ekleyeceksiniz.

Projeye bir Web Bölümü eklemek için

  1. Menü çubuğunda Seç Proje, Add New Item.

  2. İçinde Add New Item iletişim kutusu Yüklü şablonlar bölmesinde genişletin SharePoint düğüm ve sonra seçin 2010 düğümü.

  3. SharePoint şablonları listesinden seçin Web Bölümü şablonunu ve seçin Ekle düğme.

    Web Bölümü öğenin göründüğü Solution Explorer'da.

İçerik Web Bölümü oluşturma

Web Bölümü sınıf denetimler koleksiyonuna eklemeden Web bölümünde görüntülenmesini istediğiniz hangi denetimleri belirtebilirsiniz.

Web Bölümünün içeriğini işlemek için

  1. İçinde Solution Explorer'da, WebPart1.vb (Visual Basic'de) veya WebPart1.cs (C# [NULL]'taki) açın.

    Web Bölümü kod dosyasý Kod düzenleyicisinde açar.

  2. Web Bölümü kodu dosyanın en üstüne için aşağıdaki ifadeleri ekleyin.

    Imports System.Data

    using System.Data;

  3. Aşağıdaki kodu WebPart1 sınıfına ekleyin.Bu kodu aşağıdaki alanların bildirir:

    • Çalışanlar Web bölümünde görüntülenecek veri kılavuzu.

    • Veri Kılavuzu filtre uygulamak için kullanılan denetim üzerinde görüntülenen metin.

    • Veri Kılavuzu verileri görüntüleyemiyor ise bir hata görüntüler bir etiket.

    • Personel veri dosyası yolunu içeren bir dize.

    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;

  4. Aşağıdaki kodu WebPart1 sınıfına ekleyin.Bu kod adlı özel bir özellik ekler DataFilePath Web Bölümü.Uyarlanmış bir özellik SharePoint kullanıcı tarafından ayarlanabilen bir özelliktir.Bu özellik alır ve veri kılavuzu doldurmak için kullanılan bir xml veri dosyası konumunu ayarlar.

    <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;
    }
}

  5. CreateChildControls yöntemini aşağıdaki kod ile değiştirin.Bu kod aşağıdaki görevleri gerçekleştirir:

    • Bir önceki adımda yarattığınız etiket ve veri kılavuzu ekler.

    • Veri Kılavuzu çalışan verilerini içeren bir xml dosyasını bağlar.

    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();
}

  6. Aşağıdaki yöntemi WebPart1 sınıfına ekleyin.Bu kod aşağıdaki görevleri gerçekleştirir:

    • Görünür bir fiil işlenmiş Web Bölümünün Web Bölümü fiiller menü oluşturur.

    • Kullanıcı fiiller menüsündeki fiili seçtiğinde artırılıyor olayını işler.Bu kod, veri kılavuzunda görüntülenen çalışanların listesini filtre uygular.

    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";
    }
}

Web Bölümü test etme

Proje çalıştırdığınızda, SharePoint sitesini açar.Web Bölümü, SharePoint Web Bölümü Galerisi'nde otomatik olarak eklenir.Herhangi bir Web Bölümü sayfasına Web Bölümü ekleyebilirsiniz.

Web bölümünü sınamak için

  1. Aşağıdaki xml bir not defteri dosyasına yapıştırın.Bu xml dosyası Web Bölümünde görüntülenen örnek verileri içerir.

    <?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>

  2. Not Defteri'nde, menü çubuğunda Seç dosyasını, Save As.

  3. İçinde Farklı Kaydet iletişim kutusu türü listesinde, seçim Tüm dosyaları.

  4. İçinde Dosya adı kutusunda, data.xml girin.

  5. Kullanarak herhangi bir klasörü seçin Klasörlere Gözat düğmesini tıklatın ve sonra seçim kaydetmek düğme.

  6. Visual Studio'da seçin F5 anahtarı.

    SharePoint sitesini açar.

  7. Üzerinde Site eylemleri menüsünden seçin Daha fazla seçenek.

  8. İçinde Create sayfasında, seçim Web Bölümü sayfası yazın ve sonra seçin oluşturma düğmesi.

  9. İçinde Yeni Web Bölümü sayfası sayfasında, sayfa adı SampleWebPartPage.aspxve sonra seçin Create düğme.

    Web Bölümü sayfası görüntülenir.

  10. Web Bölümü sayfasındaki herhangi bir bölge seçin.

  11. Sayfanın en üstünde, seçim Ekle sekmesini tıklatın ve sonra seçin Web Bölümü düğme.

  12. İçinde Kategoriler bölmesinde seçin özel klasörü seçin WebPart1 Web Bölümü ve seçin Ekle düğmesini.

    Web Bölümü sayfasında görüntülenir.

Özel özellik sınama

Web Bölümünde görüntülenen veri kılavuzu doldurmak için her çalışan hakkında veri içeren xml dosyasının yolunu belirtin.

Özel özellik sınamak için

  1. Web Bölümü'nün sağ tarafta görünen oku seçin ve sonra Web Bölümü düzen görünen menüden.

    Web Bölümünün özelliklerini içeren bir bölmesi sayfanın sağ tarafında görüntülenir.

  2. Bölmesinde genişletin çeşitli düğümü, daha önce oluşturduğunuz xml dosyasının yolunu girin, seçim Uygula düğmesini tıklatın ve sonra seçim Tamam düğme.

    Çalışanlar listesi Web bölümünde göründüğünden emin olun.

Web Bölümü fiil sınama

Göster ve Web Bölümü fiiller menüde görüntülenen bir öğeyi tıklatarak olmayan çalışanlar gizleyebilirsiniz.

Web Bölümü fiil sınamak için

  1. Web Bölümü'nün sağ tarafta görünen oku seçin ve sonra Yalnızca yöneticileri Göster görünen menüden.

    Yöneticileri olan çalışanlar Web bölümünde görünür.

  2. Oku yeniden seçin ve sonra Göster tüm çalışanlar görünen menüden.

    Tüm çalışanların Web bölümünde görünür.

Ayrıca bkz.

Görevler

Nasıl yapılır: SharePoint Web Bölümü oluşturma

Nasıl yapılır: bir Designer'ı kullanarak bir SharePoint Web Bölümü oluşturma

İzlenecek yol:, bir tasarımcı kullanarak SharePoint Web Bölümü oluşturma

Diğer Kaynaklar

SharePoint Web bölümleri oluşturma