SPWebCollection.Add method (String, String, String, UInt32, String, Boolean, Boolean)
建立網站與指定的網站與相對 URL、 標題、 描述、 地區設定識別碼和網站定義或網站範本名稱。
Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'宣告
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
'用途
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
)
參數
strWebUrl
Type: System.String內含相對於根網站的網站集合中新的網站 URL 的字串。例如，若要在http://MyServer/sites/MySiteCollection/MyNewWebsite」 建立網站，請指定MyNewWebsite，或http://MyServer/sites/MySiteCollection/Website/MyNewWebsite在建立網站一個層級較低，指定Website/MyNewWebsite。
strTitle
Type: System.String內含標題的字串。
strDescription
Type: System.String包含描述字串。
nLCID
Type: System.UInt3232 位元正負號的整數，指定地區設定識別碼。
strWebTemplate
Type: System.String包含的網站定義設定] 或 [網站範本名稱的字串。
根據預設，通用網站範本 (GLOBAL#0) 新增至所有的網站定義。您無法明確地建立的全域網站範本為基礎的網站。
useUniquePermissions
Type: System.Boolean若要建立子網站不是權限繼承自其他網站 ； true 否則，請 false 。
bConvertIfThere
Type: System.Booleantrue 可將現有的同名資料夾轉換成 SharePoint 網站。 false 擲回例外狀況，指出與指定的網站名稱的 URL 路徑已經存在。
傳回值
Type: Microsoft.SharePoint.SPWeb
代表新網站的SPWeb物件。
備註
下表顯示為預設值的Microsoft SharePoint Foundation安裝中隨附的網站定義設定。
值 |
網站定義 |
|---|---|
STS#0 |
小組網站 |
STS#1 |
空白網站 |
STS#2 |
文件工作區 |
MPS#0 |
基本會議工作區 |
MPS#1 |
空白會議工作區 |
MPS#2 |
決策會議工作區 |
MPS#3 |
社交會議工作區 |
MPS#4 |
多重頁面會議工作區 |
BLOG#0 |
部落格 |
SGS#0 |
基本群組工作網站 |
SGS#1 |
空白群組工作網站 |
WIKI#0 |
Wiki |
請注意，wiki (英文) 提供原本所建立的舊版的 SharePoint Foundation 的舊版 wiki 網站的網站定義設定。由於 SGS 網站上的標準版網站頁面 wiki (英文) 啟用頁面，因此您不需要建立專用於 wiki 網站。
根據預設，通用網站範本 (GLOBAL#0) 新增至所有的網站定義。您無法明確地建立站台根據其通用網站範本。
Examples
下列範例是另一個網站的子建立新的網站，並使用新的網站的文件工作區範本的主控台應用程式。建立新的網站之後, 應用程式會將連結新增至其父網站的上方連結列，如果父代繼承上方連結列的根網站集合中的連結，則。
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