SPSite constructor (String)

Initializes a new instance of the SPSite class based on the specified URL.

Namespace:  Microsoft.SharePoint
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Public Sub New ( _
	requestUrl As String _
Dim requestUrl As String

Dim instance As New SPSite(requestUrl)


Type: System.String

The absolute URL for the site collection.


The site collection could not be found.

The URL that is passed to the SPSite constructor does not need to match a site collection URL exactly. See examples below.

Caution noteCaution

This constructor is allowed in sandboxed solutions. in that case, the value of the requestUrl parameter must resolve to the parent site collection in which the sandboxed solution is deployed. If the value of the requestUrl parameter resolves to the URL of any other site collection, the constructor throws an exception because a sandboxed solution is not allowed to access any SharePoint objects outside its hosting site collection.

The following code example returns the site collection that is located at http://Server_Name/sites/Site_Name even though the URL that is passed to the constructor does not match the site collection URL.

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

The next code example creates an SPSite object using System.Environment.MachineName.

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

Certain objects implement the IDisposable interface, and you must avoid retaining these objects in memory after they are no longer needed. For information about good coding practices, see Disposing Objects.