SPWebCollection.Add-Methode (String, String, String, UInt32, String, Boolean, Boolean)
Erstellt eine Website mit dem angegebenen websiterelative URL, Titel, Beschreibung, Gebietsschema-ID und Websitedefinition oder Websitevorlagenkatalog.
Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaration
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
'Usage
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
)
Parameter
strWebUrl
Typ: System.StringEine Zeichenfolge, die die neue Website-URL relativ zu der Stammwebsite in der Websitesammlung enthält. Erstellen einer Website unter http://MyServer/sites/MySiteCollection/MyNewWebsite, geben Sie MyNewWebsiteoder eine Website eine Ebene niedriger auf http://MyServer/sites/MySiteCollection/Website/MyNewWebsitezu erstellen, geben Sie beispielsweise Website/MyNewWebsite.
strTitle
Typ: System.StringEine Zeichenfolge, die den Titel enthält.
strDescription
Typ: System.StringEine Zeichenfolge, die Beschreibung enthält.
nLCID
Typ: System.UInt32Eine 32-Bit-Ganzzahl ohne Vorzeichen, die angibt, die Gebietsschema-ID.
strWebTemplate
Typ: System.StringEine Zeichenfolge, die den Namen der websitedefinitionskonfiguration oder Websitevorlage enthält.
Standardmäßig wird allen Websitedefinitionen eine globalen Vorlage (GLOBAL#0) hinzugefügt. Sie können nicht explizit eine Website basierend auf einer globalen Vorlage erstellen.
useUniquePermissions
Typ: System.Booleantrue zum Erstellen einer Unterwebsite, die keine Berechtigungen aus einer anderen Website erbt; andernfalls false .
bConvertIfThere
Typ: System.Booleantrue , um einen vorhandenen Ordner mit demselben Namen in einer SharePoint-Website zu konvertieren. false eine Ausnahme ausgelöst, die angibt, dass ein URL-Pfad mit dem Namen der angegebenen Website bereits vorhanden ist.
Rückgabewert
Typ: Microsoft.SharePoint.SPWeb
Ein SPWeb -Objekt, das die neue Website darstellt.
Hinweise
In der folgenden Tabelle sind die Werte für die standardmäßige Websitedefinitionskonfigurationen, die in einer Installation von Microsoft SharePoint Foundation enthalten sind.
Wert |
Websitedefinition |
|---|---|
STS#0 |
Teamwebsite |
STS#1 |
Leere Website |
STS#2 |
Dokumentarbeitsbereich |
MPS#0 |
Standard-Besprechungsarbeitsbereich |
MPS#1 |
Leerer Besprechungsarbeitsbereich |
MPS#2 |
Entscheidung-Besprechungsarbeitsbereich |
MPS#3 |
Sozialer Besprechungsarbeitsbereich |
MPS#4 |
Mehrseitiger Besprechungsarbeitsbereich |
BLOG#0 |
Blog |
SGS#0 |
Einfache Gruppenarbeitssite |
SGS#1 |
Leere Gruppenarbeitssite |
WIKI#0 |
Wiki |
Beachten Sie, dass WIKI eine Websitedefinitionskonfiguration für Wiki-Websites bietet, die ursprünglich in einer früheren Version von SharePoint Foundation erstellt wurden. Da die Standardwebsiteseiten auf SGS-Websites Wiki-fähig sind, müssen Sie keine speziellen Wiki-Websites erstellen.
Standardmäßig wird allen Websitedefinitionen eine globalen Vorlage (GLOBAL#0) hinzugefügt. Sie können nicht explizit erstellen eine Website auf ihrer Grundlage die globalen Websitevorlage.
Beispiele
Das folgende Beispiel ist eine Konsolenanwendung, die eine neue Website als untergeordnetes Element von einem anderen Standort erstellt und verwendet die Dokumentarbeitsbereich-Vorlage für die neue Website. Nach dem Erstellen der neuen Website an, fügt die Anwendung einen Link hinzu, auf der übergeordneten Website-Leiste für häufig verwendete Hyperlinks oder, wenn das übergeordnete Objekt Links, um die Leiste für häufig verwendete Hyperlinks für die Stammwebsite in der Auflistung erbt.
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