SPSiteCollection.Add - Méthode (String, String, String, UInt32, String, String, String, String)
Crée un objet SPSite dans la collection basée sur l'URL spécifiée, titre, description, l'identificateur de paramètres régionaux (LCID) et définition de site ou le modèle de site, ainsi que sur le nom d'utilisateur, nom d'utilisateur complet et adresse de messagerie du propriétaire de la collection de sites.
Espace de noms : Microsoft.SharePoint.Administration
Assembly : Microsoft.SharePoint (dans Microsoft.SharePoint.dll)
Syntaxe
'Déclaration
Public Function Add ( _
siteUrl As String, _
title As String, _
description As String, _
nLCID As UInteger, _
webTemplate As String, _
ownerLogin As String, _
ownerName As String, _
ownerEmail As String _
) As SPSite
'Utilisation
Dim instance As SPSiteCollection
Dim siteUrl As String
Dim title As String
Dim description As String
Dim nLCID As UInteger
Dim webTemplate As String
Dim ownerLogin As String
Dim ownerName As String
Dim ownerEmail As String
Dim returnValue As SPSite
returnValue = instance.Add(siteUrl, title, _
description, nLCID, webTemplate, _
ownerLogin, ownerName, ownerEmail)
public SPSite Add(
string siteUrl,
string title,
string description,
uint nLCID,
string webTemplate,
string ownerLogin,
string ownerName,
string ownerEmail
)
Paramètres
siteUrl
Type : System.StringChaîne qui contient l'URL de l'objet de site, par exemple, nom_site ou sites/nom_site. Elle peut-être être relative de serveur ou absolue pour les sites classiques.
title
Type : System.StringString qui contient le titre de l'objet de site.
description
Type : System.StringString qui contient la description de l'objet de site.
nLCID
Type : System.UInt32Un non signé 32 bits integer qui spécifie le LCID de l'objet de site.
webTemplate
Type : System.StringString qui spécifie la définition de site ou d'un modèle de site pour l'objet de site. Spécifiez une référence Null (Rien dans Visual Basic) pour créer un site sans lui appliquer un modèle. Pour obtenir la liste des définitions de site par défaut, consultez la section Notes.
ownerLogin
Type : System.StringString qui contient le nom d'utilisateur du propriétaire de l'objet de site (par exemple, domaine\utilisateur). En mode de création de compte de Services de domaine Active Directory, le paramètre ownerLogin doit contenir une valeur même si la valeur ne correspond pas à un nom d'utilisateur.
ownerName
Type : System.StringString qui contient le nom complet du propriétaire de l'objet de site.
ownerEmail
Type : System.StringString qui contient l'adresse de messagerie du propriétaire de l'objet de site.
Valeur renvoyée
Type : Microsoft.SharePoint.SPSite
Objet SPSite qui représente la collection de sites.
Remarques
Le tableau suivant présente les valeurs par défaut des définitions de site qui sont incluses dans une installation de Microsoft SharePoint Foundation.
Valeur |
Définition de site |
---|---|
STS#0 |
Site d’équipe |
STS#1 |
Site vide |
STS#2 |
Espace de travail de document |
MPS#0 |
Espace de travail de réunion de base |
MPS#1 |
Espace de travail de réunion vide |
MPS#2 |
Espace de travail de réunion pour la prise de décision |
MPS#3 |
Espace de travail de réunion informelle |
MPS#4 |
Espace de travail de réunion multipage |
BLOG#0 |
Blog |
SGS #0 |
Site de travail de groupe de base |
SGS #1 |
Site de travail de groupe vide |
WIKI#0 |
Wiki |
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 un modèle de site globale.
Exemples
L'exemple de code suivant crée une collection de sites au sein d'une application Web spécifiée.
Dim webApp As SPWebApplication = New SPSite("http://MySiteCollection").WebApplication
Dim siteCollections As SPSiteCollection = webApp.Sites
Dim newSiteCollection As SPSite = siteCollections.Add("sites/Site_Name", "Site_Title", "Site_Description", 1033, "STS#0", "DOMAIN\User", "Owner_User_Name", "Owner_Email")
SPWebApplication webApp = new SPSite("http://MySiteCollection").WebApplication;
SPSiteCollection siteCollections = webApp.Sites;
SPSite newSiteCollection = siteCollections.Add("sites/Site_Name",
"Site_Title", "Site_Description", 1033, "STS#0",
"DOMAIN\\User", "Owner_User_Name", "Owner_Email");