Clase SPVirtualServerCollection
NOTA: esta API está ahora obsoleta.
Ha quedado obsoleto. En su lugar, use la clase SPWebApplicationCollection . (En Windows SharePoint Services 2.0, la clase SPVirtualServerCollection representa una colección de objetos de SPVirtualServer y se mantiene por compatibilidad con versiones anteriores.)
Jerarquía de la herencia
System.Object
Microsoft.SharePoint.Administration.SPAutoSerializingObject
Microsoft.SharePoint.SPBaseCollection
Microsoft.SharePoint.Administration.SPVirtualServerCollection
Espacio de nombres: Microsoft.SharePoint.Administration
Ensamblado: Microsoft.SharePoint (en Microsoft.SharePoint.dll)
Sintaxis
'Declaración
<ObsoleteAttribute("The SPVirtualServerCollection class is deprecated. Use an SPWebApplicationCollection instead.", _
False)> _
<SharePointPermissionAttribute(SecurityAction.Demand, ObjectModel := True)> _
Public NotInheritable Class SPVirtualServerCollection _
Inherits SPBaseCollection
'Uso
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
Comentarios
Utilice la propiedad VirtualServers de la clase SPGlobalAdmin para devolver todos los servidores virtuales en la implementación de Microsoft SharePoint Foundation.
Para crear un servidor virtual administrativo, utilice el método CreateAdminVirtualServer de la clase SPGlobalAdmin . Para extender un servidor virtual, use uno de los métodos de ExtendVirtualServer de la clase SPGlobalAdmin .
Utilice un indizador para devolver un único servidor virtual de la colección. Por ejemplo, si la colección se asigna a una variable denominada myVirtualServers, use myVirtualServers[index] en C# o myVirtualServers(index) en Visual Basic. NET, donde index es el número de índice del servidor de la colección.
Ejemplos
En el ejemplo de código siguiente se recorre la colección de los servidores virtuales en una implementación y se extiende a los servidores virtuales que no se han extendido con SharePoint Foundation y crea un sitio de nivel superior para cada uno.
En este ejemplo se supone la presencia de una síntesis de formulario administrativo en el archivo .cs o .vb. Para obtener información acerca de la validación de seguridad, vea validación de seguridad y realizar entradas para actualizar datos.
[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);
}
}
}
Seguridad para subprocesos
Los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancias sean seguros para los subprocesos.