Метод SPWebCollection.Add (String, String, String, UInt32, String, Boolean, Boolean)

Статья
05/13/2015

Создание веб-сайта с указанного сайта URL-адрес, заголовок, описание, идентификатор языкового стандарта и определения сайта или имя шаблона сайта.

Пространство имен: Microsoft.SharePoint
Сборка: Microsoft.SharePoint (в Microsoft.SharePoint.dll)

Синтаксис

'Декларация
Public Function Add ( _
    strWebUrl As String, _
    strTitle As String, _
    strDescription As String, _
    nLCID As UInteger, _
    strWebTemplate As String, _
    useUniquePermissions As Boolean, _
    bConvertIfThere As Boolean _
) As SPWeb
'Применение
Dim instance As SPWebCollection
Dim strWebUrl As String
Dim strTitle As String
Dim strDescription As String
Dim nLCID As UInteger
Dim strWebTemplate As String
Dim useUniquePermissions As Boolean
Dim bConvertIfThere As Boolean
Dim returnValue As SPWeb

returnValue = instance.Add(strWebUrl, _
    strTitle, strDescription, nLCID, _
    strWebTemplate, useUniquePermissions, _
    bConvertIfThere)

public SPWeb Add(
    string strWebUrl,
    string strTitle,
    string strDescription,
    uint nLCID,
    string strWebTemplate,
    bool useUniquePermissions,
    bool bConvertIfThere
)

Параметры

strWebUrl
Тип: System.String

Строка, содержащая новый URL-адрес веб-сайта относительно корневого веб-сайта в семействе сайтов. Например для создания веб-сайта в http://MyServer/sites/MySiteCollection/MyNewWebsite, укажите MyNewWebsiteили создать один уровень веб-сайт снижение на http://MyServer/sites/MySiteCollection/Website/MyNewWebsite, укажите Website/MyNewWebsite.

strTitle
Тип: System.String

Строка, содержащая название.

strDescription
Тип: System.String

Строка, содержащая описание.

nLCID
Тип: System.UInt32

32-разрядное целое без знака, задающее код языка.

strWebTemplate
Тип: System.String

Строка, содержащая имя конфигурации определения сайта или шаблона сайта.

По умолчанию шаблон узла global (GLOBAL#0) добавляется всех определений сайтов. Не удается явно создать сайт на основе шаблона узла global.

useUniquePermissions
Тип: System.Boolean

true для создания дочернего сайта, который не наследует разрешения от другого сайта; в противном случае — false .

bConvertIfThere
Тип: System.Boolean

true преобразовать существующую папку с таким же именем на сайте SharePoint. false исключение, которое указывает, что URL-адрес с именем указанного сайта уже существует.

Возвращаемое значение

Тип: Microsoft.SharePoint.SPWeb
Объект SPWeb , который представляет нового веб-сайта.

Замечания

В следующей таблице показаны значения по умолчанию конфигурации определения сайта, которые включены в установку Microsoft SharePoint Foundation.

Значение	Определение сайта
STS#0	Сайт группы
STS#1	Пустой сайт
STS#2	Рабочая область для документов
MPS#0	Базовая рабочая область для собраний
MPS#1	Пустая рабочая область для собраний
MPS#2	Рабочая область для собраний — решения
MPS#3	Рабочая область для собраний — социальные
MPS#4	Многостраничная рабочая область для собраний
BLOG#0	Блог
SGS#0	Основной рабочий сайт группы
SGS#1	Пустой сайт групповой работы
WIKI#0	Wiki

Обратите внимание, что WIKI содержит конфигурацию определения сайта для старых вики-сайтов, создававшихся в предыдущих версиях SharePoint Foundation. Поскольку стандартные страницы на сайтах SGS поддерживают вики-функции, пользователям не нужно создавать сайты, специально предназначенные для вики-контента.

По умолчанию шаблон узла global (GLOBAL#0) добавляется всех определений сайтов. Не удается создать явно сайта на его основе шаблона узла global.

Примеры

Следующий пример является консольное приложение, которое создает нового веб-сайта в качестве дочернего для другого сайта и для нового веб-сайта с помощью шаблона рабочей области для документов. После создания нового веб-сайта, приложение добавляет ссылку на его родительский сайт верхнюю панель ссылок или, если родительский наследует ссылки на верхней панели ссылок для корневого веб-сайта в семействе сайтов.

using System;
using Microsoft.SharePoint;
using Microsoft.SharePoint.Navigation;

namespace ConsoleApp
{
    class Program
    {
        static void Main(string[] args)
        {
            using (SPSite site = new SPSite("https://localhost"))
            {
                string parentWebName = "Team";

                using (SPWeb parentWeb = site.OpenWeb(parentWebName))
                {
                    string webTitle = "Our Documents";
                    string webDesc = "A site created by a console application.";
                    string webName = "ourdocs";
                    string webUrl = String.Format("{0}/{1}", parentWebName, webName);
                    uint webLcid = parentWeb.Language;

                    // Name value for the Document Workspace template.
                    string webTemplateName = "STS#2";

                    SPWeb newWeb = null;

                    // Create the new web.
                    try
                    {
                        newWeb = site.AllWebs.Add(webUrl, webTitle, webDesc, webLcid, webTemplateName, false, false);
                    }
                    catch (ArgumentException ex)
                    {
                        Console.WriteLine(ex.Message);
                    }

                    // Add a link to the new web on the RootWeb's topnav bar.
                    if (newWeb != null)
                    {
                        // Set the new web's top link bar to inherit links from its parent web.
                        newWeb.Navigation.UseShared = true;

                        // Create a link pointing to the new web.
                        SPNavigationNode node = new SPNavigationNode(newWeb.Title, newWeb.ServerRelativeUrl);

                        // Find out if the parent inherits links.
                        bool parentInheritsTopNav = newWeb.ParentWeb.Navigation.UseShared;

                        if (parentInheritsTopNav)
                        {
                            // Add the link to the top link bar on the root web.
                            site.RootWeb.Navigation.TopNavigationBar.AddAsLast(node);
                        }
                        else
                        {
                            // Add the link to the top link bar on the parent web.
                            newWeb.ParentWeb.Navigation.TopNavigationBar.AddAsLast(node);
                        }

                        newWeb.Dispose();
                    }
                }
            }
            Console.Write("\nPress ENTER to continue....");
            Console.ReadLine();
        }
    }
}

Imports System
Imports Microsoft.SharePoint
Imports Microsoft.SharePoint.Navigation

Module ConsoleApp

    Sub Main()

        Using site As New SPSite("https://localhost")

            Dim parentWebName As String = "Team"

            Using parentWeb As SPWeb = site.OpenWeb(parentWebName)
                Dim webTitle As String = "Our Documents"
                Dim webDesc As String = "A site created by a console application."
                Dim webName As String = "ourdocs"
                Dim webUrl As String = [String].Format("{0}/{1}", parentWebName, webName)
                Dim webLcid As UInteger = parentWeb.Language

                ' Name value for the Document Workspace template.
                Dim webTemplateName As String = "STS#2"

                Dim newWeb As SPWeb = Nothing

                ' Create the new web.
                Try
                    newWeb = site.AllWebs.Add(webUrl, webTitle, _
                                              webDesc, webLcid, _
                                              webTemplateName, _
                                              False, False)
                Catch ex As ArgumentException
                    Console.WriteLine(ex.Message)
                End Try

                ' Add a link to the new web on the RootWeb's topnav bar.
                If newWeb IsNot Nothing Then
                    ' Set the new web's top link bar to inherit links from its parent web.
                    newWeb.Navigation.UseShared = True

                    ' Create a link pointing to the new web.
                    Dim node As New SPNavigationNode(newWeb.Title, newWeb.ServerRelativeUrl)

                    ' Find out if the parent inherits links.
                    Dim parentInheritsTopNav As Boolean = newWeb.ParentWeb.Navigation.UseShared

                    If parentInheritsTopNav Then
                        ' Add the link to the top link bar on the root web.
                        site.RootWeb.Navigation.TopNavigationBar.AddAsLast(node)
                    Else
                        ' Add the link to the top link bar on the parent web.
                        newWeb.ParentWeb.Navigation.TopNavigationBar.AddAsLast(node)
                    End If

                    newWeb.Dispose()
                End If

            End Using
        End Using

        Console.Write(vbCrLf & "Press ENTER to continue....")
        Console.Read()
    End Sub

End Module

См. также

Справочные материалы

SPWebCollection класс

Элементы SPWebCollection

Перегрузка Add

Пространство имен Microsoft.SharePoint

Поделиться через