SPSite - Constructeur (String)

Article
05/12/2015

Initialise une nouvelle instance de la classe SPSite en fonction de l'URL spécifiée.

Espace de noms : Microsoft.SharePoint
Assembly : Microsoft.SharePoint (dans Microsoft.SharePoint.dll)

Syntaxe

'Déclaration
Public Sub New ( _
    requestUrl As String _
)
'Utilisation
Dim requestUrl As String

Dim instance As New SPSite(requestUrl)

public SPSite(
    string requestUrl
)

Paramètres

requestUrl
Type : System.String

L'URL absolue de la collection de sites.

Exceptions

Exception	Condition
FileNotFoundException	La collection de sites n'a pas pu être trouvée.

Remarques

L'URL qui est transmis au constructeur SPSite n'a pas besoin correspondre exactement à une URL de collection de sites. Consultez les exemples ci-dessous.

Avertissement

Ce constructeur est autorisé dans solutions bac à sable. dans ce cas, la valeur du paramètre requestUrl doit correspondre à la collection de sites parente dans laquelle le solution bac à sable est déployé. Si la valeur du paramètre requestUrl aboutit à l'URL de n'importe quelle autre collection de sites, le constructeur lève une exception, car une solution bac à sable n'est pas autorisé à accéder aux objets SharePoint en dehors de la collection de sites d'hébergement.

Exemples

L'exemple de code suivant renvoie la collection de sites qui se trouve à https://Server_Name/sites/Site_Name même si l'URL qui est transmis au constructeur ne correspond pas à l'URL de collection de sites.

Using oSiteCollection As New SPSite("http://Server_Name/sites/Site_Name/Subsite_Name/default.aspx")
    ...
End Using

using (SPSite oSiteCollection = new SPSite("http://Server_Name/sites/Site_Name/Subsite_Name/default.aspx"))
{
    ...
}

L'exemple de code suivant crée un objet SPSite à l'aide de System.Environment.MachineName.

Using oSiteCollection As New SPSite("http://" + System.Environment.MachineName + "/sites/Site_Name")
    ...
End Using

using (SPSite oSiteCollection = new SPSite("http://" + System.Environment.MachineName + "/sites/Site_Name"))
{
    ...
}

Notes

Certains objets implémentent l'interface IDisposable , et vous devez éviter la conservation de ces objets en mémoire une fois qu'ils ne sont plus nécessaires. Pour plus d'informations sur les bonnes pratiques de codage, voir Disposing Objects.

Voir aussi

Référence

SPSite classe

SPSite - Membres

SPSite - Surcharge

Microsoft.SharePoint - Espace de noms

Partager via