(String, String, String, UInt32, String, Boolean, Boolean) del método SPWebCollection.Add
Crea un sitio Web con la dirección URL relativa al sitio especificado, título, descripción, el identificador de configuración regional y definición de sitio o nombre de la plantilla de sitio.
Espacio de nombres: Microsoft.SharePoint
Ensamblado: Microsoft.SharePoint (en Microsoft.SharePoint.dll)
Sintaxis
'Declaración
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
Tipo: System.StringUna cadena que contiene la dirección URL de sitio Web nuevo en relación con el sitio Web raíz de la colección de sitios. Por ejemplo, para crear un sitio Web en http://MyServer/sites/MySiteCollection/MyNewWebsite, especifique MyNewWebsite, o para crear una sitio Web en un nivel inferior en http://MyServer/sites/MySiteCollection/Website/MyNewWebsite, especifique Website/MyNewWebsite.
strTitle
Tipo: System.StringUna cadena que contiene el título.
strDescription
Tipo: System.StringUna cadena que contiene la descripción.
nLCID
Tipo: System.UInt32Un entero sin signo de 32 bits que especifica el identificador de configuración regional.
strWebTemplate
Tipo: System.StringUna cadena que contiene el nombre de la plantilla de sitio o configuración de definición de sitio.
De forma predeterminada, se agrega una plantilla de sitio globales (GLOBAL#0) para todas las definiciones de sitio. No se puede crear explícitamente un sitio basado en una plantilla de sitio global.
useUniquePermissions
Tipo: System.Booleantrue para crear un subsitio que herede los permisos de otro sitio. en caso contrario, false .
bConvertIfThere
Tipo: System.Booleantrue para convertir una carpeta existente del mismo nombre en un sitio de SharePoint. false para producir una excepción que indica que ya existe una ruta de acceso de dirección URL con el nombre del sitio especificado.
Valor devuelto
Tipo: Microsoft.SharePoint.SPWeb
Un objeto SPWeb que representa el nuevo sitio Web.
Comentarios
En la siguiente tabla muestra los valores para el valor predeterminado de las configuraciones de definición de sitio que se incluyen en una instalación de Microsoft SharePoint Foundation.
Valor |
Definición de sitio |
|---|---|
STS#0 |
Sitio de grupo |
STS#1 |
Sitio en blanco |
STS#2 |
Área de trabajo de documento |
MPS#0 |
Área de reuniones básica |
MPS#1 |
Área de reuniones en blanco |
MPS#2 |
Área de toma de decisiones |
MPS#3 |
Área de reuniones sociales |
MPS#4 |
Área de reuniones de varias páginas |
BLOG#0 |
Blog |
SGS#0 |
Sitio de trabajo de grupo básico |
SGS#1 |
Sitio de trabajo de grupo en blanco |
WIKI#0 |
Wiki |
Tenga en cuenta que WIKI proporciona una configuración de definición de sitio para sitios wiki heredados creados originalmente en una versión anterior de SharePoint Foundation. Dado que las páginas de sitio estándar de sitios SGS son páginas habilitadas para wiki, no es necesario crear sitios que sean específicamente para wikis.
De forma predeterminada, se agrega una plantilla de sitio globales (GLOBAL#0) para todas las definiciones de sitio. No se puede crear explícitamente un sitio basado en él la plantilla de sitio global.
Ejemplos
En el siguiente ejemplo es una aplicación de consola que crea un nuevo sitio Web como un elemento secundario de otro sitio y se usa la plantilla de área de documentos para el nuevo sitio. Después de crear el nuevo sitio Web, la aplicación agrega un vínculo a ella a la barra de vínculos superior del sitio primario o, si el elemento primario hereda vínculos a la barra de vínculos superior para el sitio Web raíz de la colección.
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