SPWebCollection.Add - Méthode (String, String, String, UInt32, String, Boolean, Boolean)

Crée un site Web avec l'URL relative du site spécifiée, titre, description, ID de paramètres régionaux et définition de site ou nom de modèle de site.

Espace de noms :  Microsoft.SharePoint
Assembly :  Microsoft.SharePoint (dans Microsoft.SharePoint.dll)

Syntaxe

'Déclaration
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
'Utilisation
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
)

Paramètres

• strWebUrl
  Type : System.String

  Chaîne qui contient la nouvelle URL du site Web relative au site Web racine dans la collection de sites. Par exemple, pour créer un site Web à http://MyServer/sites/MySiteCollection/MyNewWebsite, spécifiez MyNewWebsite, ou pour créer un site Web de niveau immédiatement inférieur à http://MyServer/sites/MySiteCollection/Website/MyNewWebsite, spécifiez Website/MyNewWebsite.

• strTitle
  Type : System.String

  Chaîne qui contient le titre.

• strDescription
  Type : System.String

  Chaîne qui contient la description.

• nLCID
  Type : System.UInt32

  Un entier non signé 32 bits qui spécifie l'ID de paramètres régionaux.

• strWebTemplate
  Type : System.String

  Chaîne qui contient le nom de la configuration de définition de site ou d'un modèle de site.

  Par défaut, un modèle de site globale (GLOBAL#0) est ajouté à toutes les définitions de site. Vous ne pouvez pas créer explicitement un site basé sur un modèle de site globale.

• useUniquePermissions
  Type : System.Boolean

  true pour créer un sous-site qui n'hérite pas des autorisations d'un autre site ; dans le cas contraire, false .

• bConvertIfThere
  Type : System.Boolean

  true pour convertir un dossier existant du même nom sur un site SharePoint. false lève une exception qui indique qu'un chemin d'URL avec le nom de site spécifié existe déjà.

Valeur renvoyée

Type : Microsoft.SharePoint.SPWeb
Objet SPWeb qui représente le nouveau site Web.

Remarques

Le tableau suivant présente les valeurs par défaut des configurations de définition de site qui sont incluses dans une installation de Microsoft SharePoint Foundation.

Notez que WIKI fournit une configuration de définition de site pour les sites wiki hérités initialement créés dans une version antérieure de SharePoint Foundation. Étant donné que les pages de site standard dans les sites SGS sont des pages prenant en charge les wikis, vous n'avez pas besoin de créer des sites spécifiquement pour ces derniers.

Par défaut, un modèle de site globale (GLOBAL#0) est ajouté à toutes les définitions de site. Vous ne pouvez pas créer explicitement un site basé sur celle-ci, le modèle de site globale.

Exemples

L'exemple suivant est une application console qui crée un nouveau site Web en tant qu'enfant d'un autre site et utilise le modèle d'espace de travail de Document pour le nouveau site. Après avoir créé le nouveau site Web, l'application ajoute un lien à celui-ci à la barre de liens supérieure du site parent ou, si l'objet parent hérite des liens pour la barre de liens supérieure du site Web racine de la collection.

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

Voir aussi

Référence

SPWebCollection classe

SPWebCollection - Membres

Add - Surcharge

Microsoft.SharePoint - Espace de noms