Udostępnij za pośrednictwem

Przewodnik: tworzenie podstawowego projektu definicji witryny

  • Artykuł

W tym przewodniku pokazano, jak utworzyć podstawową definicję witryny zawierającą wizualny składnik Web Part z niektórymi kontrolkami. Ze względu na przejrzystość tworzony składnik Web Part wizualizacji ma tylko kilka kontrolek. Można jednak utworzyć bardziej zaawansowane definicje witryn programu SharePoint, które zawierają więcej funkcji.

W tym przewodniku przedstawiono następujące zadania:

  • Tworzenie definicji witryny przy użyciu szablonu projektu programu Visual Studio.

  • Tworzenie witryny programu SharePoint przy użyciu definicji witryny w programie SharePoint.

  • Dodawanie wizualnego składnika Web Part do rozwiązania.

  • Dostosowywanie strony default.aspx witryny przez dodanie do niej nowego składnika Web Part wizualizacji.

    Uwaga

    Na komputerze w poniższych instrukcjach mogą być wyświetlane inne nazwy i lokalizacje niektórych elementów interfejsu użytkownika programu Visual Studio. Te elementy są określane przez numer wersji Visual Studio oraz twoje ustawienia. Aby uzyskać więcej informacji, zobacz Personalizowanie środowiska IDE.

Wymagania wstępne

Następujące składniki są wymagane do przeprowadzenia tego instruktażu:

  • Obsługiwane wersje systemów Microsoft Windows i SharePoint. Aby uzyskać więcej informacji, zobacz Wymagania dotyczące tworzenia rozwiązań programu SharePoint.

  • Visual Studio.

Tworzenie rozwiązania definicji witryny

Najpierw utwórz projekt definicji witryny w programie Visual Studio.

Aby utworzyć projekt definicji witryny

  1. Na pasku menu wybierz pozycję Plik>nowy>projekt. Jeśli środowisko IDE ma używać ustawień programowania języka Visual Basic, na pasku menu wybierz pozycję Plik>nowy projekt.

    Zostanie wyświetlone okno dialogowe Nowy projekt.

  2. Rozwiń węzeł Visual C# lub węzeł Visual Basic, rozwiń węzeł programu SharePoint, a następnie wybierz węzeł 2010.

  3. Na liście Szablony wybierz szablon project programu SharePoint 2010.

  4. W polu Nazwa wprowadź ciąg TestSiteDef, a następnie wybierz przycisk OK .

    Zostanie wyświetlony Kreator dostosowywania programu SharePoint.

  5. Na stronie Określanie witryny i poziomu zabezpieczeń na potrzeby debugowania wprowadź adres URL witryny programu SharePoint, w której chcesz debugować definicję witryny, lub użyj lokalizacji domyślnej (http:// Nazwa systemu/).

  6. W sekcji Co to jest poziom zaufania dla tego rozwiązania programu SharePoint? wybierz przycisk Wdróż jako rozwiązanie farmy.

    Wszystkie projekty definicji lokacji muszą być wdrażane jako rozwiązania farmy. Aby uzyskać więcej informacji na temat rozwiązań w trybie piaskownicy i rozwiązań farmy, zobacz Zagadnienia dotyczące rozwiązania w trybie piaskownicy.

  7. Wybierz przycisk Zakończ.

    Projekt zostanie wyświetlony w Eksplorator rozwiązań.

  8. W Eksplorator rozwiązań wybierz węzeł projektu, a następnie na pasku menu wybierz pozycję Project Add New Item (Dodaj nowy element projektu>).

  9. W obszarze Visual C# lub Visual Basic rozwiń węzeł programu SharePoint, a następnie wybierz węzeł 2010.

  10. W okienku Szablony wybierz szablon Definicja witryny, pozostaw wartość Nazwa jako SiteDefinition1, a następnie wybierz przycisk Dodaj.

Tworzenie wizualnego składnika Web Part

Następnie utwórz składnik Web Part wizualizacji, który będzie wyświetlany na stronie głównej definicji witryny.

Aby utworzyć składnik Web Part wizualizacji

  1. W Eksplorator rozwiązań wybierz przycisk Pokaż wszystkie pliki.

  2. Wybierz węzeł projektu SiteDefinition1, a następnie na pasku menu wybierz pozycję Project Add New Item (Dodaj nowy element projektu>).

    Zostanie wyświetlone okno dialogowe Dodawanie nowego elementu.

  3. Rozwiń węzeł Visual C# lub węzeł Visual Basic, rozwiń węzeł programu SharePoint, a następnie wybierz węzeł 2010.

  4. Na liście szablonów wybierz szablon składnika Visual Web Part , zachowaj domyślną nazwę VisualWebPart1, a następnie wybierz przycisk Dodaj .

    Zostanie otwarty plik VisualWebPart1.ascx .

  5. W dolnej części pliku VisualWebPart1.ascx dodaj następujące znaczniki, aby dodać trzy kontrolki do formularza: pole tekstowe, przycisk i etykietę:

    <table>
  <tr>
    <td>
      <asp:TextBox runat="server" ID="tbName"></asp:TextBox>
    </td>
    <td>
      <asp:Button runat="server" ID="btnSubmit" Text = "Change Label Text" OnClick="btnSubmit_Click"></asp:Button>
    </td>
    <td>
      <asp:Label runat="server" ID="lblName"></asp:Label>
    </td>
  </tr>
</table>

  6. W obszarze VisualWebPart1.ascx otwórz plik VisualWebPart1.ascx.cs (dla języka Visual C#) lub VisualWebPart1.ascx.vb (dla języka Visual Basic), a następnie dodaj następujący kod:

    protected void btnSubmit_Click(object sender, EventArgs e)
{            
    lblName.Text = tbName.Text;
}

    Ten kod dodaje funkcje kliknięcia przycisku składnika Web Part.

Dodawanie składnika Web Part wizualizacji do domyślnej strony ASPX

Następnie dodaj składnik Web Part wizualizacji do domyślnej strony ASPX definicji witryny.

Aby dodać składnik Web Part wizualizacji do domyślnej strony ASPX

  1. Otwórz stronę default.aspx, a następnie dodaj następujący wiersz pod tagiem WebPartPages :

    <%@ Register Tagprefix="MyWebPartControls" Namespace="TestSiteDef.VisualWebPart1" Assembly="$SharePoint.Project.AssemblyFullName$" %>

    Ten wiersz kojarzy nazwę MyWebPartControls ze składnikem Web Part i jego kodem. Parametr Przestrzeni nazw odpowiada przestrzeni nazw używanej w pliku kodu VisualWebPart1.ascx .

  2. Po elemencie </asp:Content> zastąp całą ContentPlaceHolderId="PlaceHolderMain" sekcję i jego zawartość następującym kodem:

    <asp:Content ID="Content1" ContentPlaceHolderId="PlaceHolderMain" runat="server">
    <MyWebPartControls:VisualWebPart1 runat="server" />
</asp:Content>

    Ten kod tworzy odwołanie do utworzonego wcześniej składnika Web Part wizualizacji.

  3. W Eksplorator rozwiązań otwórz menu skrótów dla węzła SiteDefinition1, a następnie wybierz pozycję Ustaw jako element startowy.

Wdrażanie i uruchamianie rozwiązania definicji witryny

Następnie wdróż projekt w programie SharePoint, a następnie uruchom projekt.

Aby wdrożyć i uruchomić definicję witryny

  • Na pasku menu wybierz pozycję Build Deploy TestSiteDef (Wdróż>test)IteDef.

  • Wybierz klawisz F5.

    Program Visual Studio kompiluje kod, dodaje jego funkcje, pakuje wszystkie pliki do pliku rozwiązania programu SharePoint (WSP) i wdraża plik WSP w programie SharePoint Server. Następnie program SharePoint instaluje pliki, a następnie aktywuje funkcje.

Tworzenie witryny na podstawie definicji witryny

Następnie utwórz lokację przy użyciu nowej definicji witryny.

Aby utworzyć witrynę przy użyciu definicji witryny

  1. W witrynie programu SharePoint zostanie wyświetlona strona Nowa witryna programu SharePoint.

  2. W sekcji Tytuł i Opis wprowadź nazwę Moja nowa witryna jako tytuł i opis witryny.

  3. W sekcji Adres witryny sieci Web wprowadź ciąg mynewsite w polu Nazwa adresu URL.

  4. W sekcji Szablon wybierz kartę Dostosowania programu SharePoint.

  5. Na liście Wybierz szablon wybierz pozycję SiteDefinition1.

  6. Pozostaw wartości domyślne pozostałych ustawień, a następnie wybierz przycisk Utwórz .

    Zostanie wyświetlona nowa witryna.

Testowanie nowej witryny

Następnie przetestuj nową witrynę, aby sprawdzić, czy działa poprawnie.

Aby przetestować nową stronę

  • Na domyślnej stronie ASPX wprowadź tekst, a następnie wybierz przycisk Zmień etykietę tekstu obok pola tekstowego.

    Tekst zostanie wyświetlony w etykiecie po prawej stronie przycisku.

Powiązana zawartość