SPVirtualServerCollection-Klasse

Artikel
05/06/2015

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.

Siehe auch

Referenz

SPVirtualServerCollection-Member

Microsoft.SharePoint.Administration-Namespace

Freigeben über