SPSite - Constructeur (String)
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.StringL'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.