SPWebCollection.Add method (String, String, String, UInt32, String, Boolean, Boolean)
Cria um site com a URL do site relativa especificada, título, descrição, ID de localidade e definição de site ou nome do modelo de site.
Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaração
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
'Uso
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
)
Parâmetros
strWebUrl
Type: System.StringUma cadeia de caracteres que contém a nova URL do site em relação ao site da raiz do conjunto de sites. Por exemplo, para criar um site no http://MyServer/sites/MySiteCollection/MyNewWebsite, especifique MyNewWebsiteou para criar um nível de um site inferior em http://MyServer/sites/MySiteCollection/Website/MyNewWebsite, especifique Website/MyNewWebsite.
strTitle
Type: System.StringUma cadeia de caracteres que contém o título.
strDescription
Type: System.StringUma string que contém a descrição.
nLCID
Type: System.UInt32Um inteiro não assinado de 32 bits que especifica a ID de localidade.
strWebTemplate
Type: System.StringUma cadeia de caracteres que contém o nome do modelo de site ou configuração de definição de site.
Por padrão, um modelo de site global (GLOBAL#0) é adicionado a todas as definições de site. Você não pode criar explicitamente um site baseado em um modelo de site global.
useUniquePermissions
Type: System.Booleantrue para criar um subsite que não herdam permissões de outro site; Caso contrário, false .
bConvertIfThere
Type: System.Booleantrue para converter uma pasta existente do mesmo nome em um site do SharePoint. false gerar uma exceção que indica que já existe um caminho de URL com o nome do site especificado.
Valor retornado
Type: Microsoft.SharePoint.SPWeb
Um objeto SPWeb que representa o novo site.
Comentários
A tabela a seguir mostra os valores para o padrão de configurações de definição de site incluídos em uma instalação do Microsoft SharePoint Foundation.
Valor |
Definição de site |
|---|---|
STS#0 |
Site de equipe |
STS#1 |
Site em branco |
STS#2 |
Espaço de trabalho do Documento |
MPS#0 |
Espaço de Trabalho de Reunião Básico |
MPS#1 |
Espaço de trabalho de reunião em branco |
MPS#2 |
Espaço de Trabalho de Reunião de Decisão |
MPS#3 |
Espaço de trabalho de reunião social |
MPS#4 |
Espaço de trabalho de reunião com várias páginas |
BLOG#0 |
Blog |
SGS#0 |
Site de trabalho em grupo básico |
SGS#1 |
Site do trabalho de grupo em branco |
WIKI#0 |
Wiki |
Observe que o WIKI fornece uma configuração de definição de site para sites de wiki herdado que foram criados em uma versão anterior do SharePoint Foundation. Como páginas de site padrão em sites SGS são páginas wiki habilitado, você não precisará criar sites que são especificamente para wikis.
Por padrão, um modelo de site global (GLOBAL#0) é adicionado a todas as definições de site. Você não pode criar explicitamente um site baseado no modelo de site globais.
Examples
O exemplo a seguir é um aplicativo de console que cria um novo site como um filho do outro site e usa o modelo de espaço de trabalho de documento para o novo site. Depois de criar o novo site, o aplicativo adiciona um link a ela a barra de links superior do site pai ou, se o pai herda links à barra de links superior do site raiz na coleção.
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