SPVirtualServerCollection-Klasse
HINWEIS: Diese API ist veraltet.
Veraltet. Verwenden Sie stattdessen die SPWebApplicationCollection -Klasse. (In Windows SharePoint Services 2.0, die SPVirtualServerCollection -Klasse eine Auflistung von Objekten SPVirtualServer dargestellt und wird für die Abwärtskompatibilität beibehalten.)
Vererbungshierarchie
System.Object
Microsoft.SharePoint.Administration.SPAutoSerializingObject
Microsoft.SharePoint.SPBaseCollection
Microsoft.SharePoint.Administration.SPVirtualServerCollection
Namespace: Microsoft.SharePoint.Administration
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaration
<ObsoleteAttribute("The SPVirtualServerCollection class is deprecated. Use an SPWebApplicationCollection instead.", _
False)> _
<SharePointPermissionAttribute(SecurityAction.Demand, ObjectModel := True)> _
Public NotInheritable Class SPVirtualServerCollection _
Inherits SPBaseCollection
'Usage
Dim instance As SPVirtualServerCollection
[ObsoleteAttribute("The SPVirtualServerCollection class is deprecated. Use an SPWebApplicationCollection instead.",
false)]
[SharePointPermissionAttribute(SecurityAction.Demand, ObjectModel = true)]
public sealed class SPVirtualServerCollection : SPBaseCollection
Hinweise
Verwenden Sie die VirtualServers -Eigenschaft der SPGlobalAdmin -Klasse, um alle virtuellen Server in der Bereitstellung von Microsoft SharePoint Foundationzurückzugeben.
Um einen administrativen virtuellen Server erstellen möchten, verwenden Sie die CreateAdminVirtualServer -Methode der SPGlobalAdmin -Klasse. Um einen virtuellen Server zu erweitern, verwenden Sie eine der Methoden ExtendVirtualServer der SPGlobalAdmin -Klasse.
Verwenden Sie eine Indexerstellung, um einen einzelnen virtuellen Server aus der Auflistung zurückzugeben. Verwenden Sie beispielsweise, wenn die Auflistung einer Variablen mit dem Namen myVirtualServerszugewiesen ist, myVirtualServers[index] in c# oder myVirtualServers(index) in Visual Basic .NET, wobei index die Indexnummer des Servers in der Auflistung ist.
Beispiele
Im folgenden Codebeispiel wird der virtuelle Server in einer Bereitstellung-Auflistung durchlaufen und und virtuelle Servern, die nicht mit SharePoint Foundation erweitert wurden erweitert und erstellt eine Website auf oberster Ebene für alle.
In diesem Beispiel wird das Vorhandensein einer administrativen Formulardigest in der CS- oder VB-Datei vorausgesetzt. Informationen zu Webseiten-Sicherheitsüberprüfung finden Sie unter Webseiten-Sicherheitsüberprüfung und tätigen von Beiträgen zum Aktualisieren von Daten.
[Visual Basic .NET]
Dim globalAdmin As New SPGlobalAdmin()
Dim vServers As SPVirtualServerCollection = globalAdmin.VirtualServers
Dim i As Integer
For i = 0 To vServers.Count - 1
If vServers(i).State = SPVirtualServerState.NeedExtend Then
Dim uri As New System.Uri(vServers(i).Url.ToString())
Try
Dim newSPServer As SPVirtualServer = globalAdmin.ExtendVirtualServer( _
"Database_Server", _
"Database_Name" + i.ToString(), _
Nothing, Nothing, uri, False, "StsAppPool1", False, _
Nothing, Nothing)
Dim sites As SPSiteCollection = newSPServer.Sites
sites.Add(newSPServer.Url.ToString(), "DOMAIN\User_Alias", "Email_Address")
Catch ex As System.Exception
Response.Write(ex.Message + ControlChars.Lf + ControlChars.Lf + ex.StackTrace)
End Try
End If
Next i
[C#]
SPGlobalAdmin globalAdmin = new SPGlobalAdmin();
SPVirtualServerCollection vServers = globalAdmin.VirtualServers;
for (int i=0; i < vServers.Count; i++)
{
if (vServers[i].State == SPVirtualServerState.NeedExtend)
{
System.Uri uri = new System.Uri(vServers[i].Url.ToString() );
try
{
SPVirtualServer newSPServer = globalAdmin.ExtendVirtualServer(
"Database_Server",
"Database_Name" + i.ToString(),
null, null, uri, false, "StsAppPool1", false, null, null);
SPSiteCollection sites = newSPServer.Sites;
sites.Add(newSPServer.Url.ToString(),"DOMAIN\\User_Alias","Email_Address");
}
catch (System.Exception ex)
{
Response.Write(ex.Message + "\n\n" + ex.StackTrace);
}
}
}
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Die Threadsicherheit von Instanzmembern ist nicht gewährleistet.