SPSite Constructor (String, SPUserToken)
Initializes a new instance of the SPSite class based on the specified absolute URL and user token.
Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Available in Sandboxed Solutions: No
Syntax
'Declaration
<SubsetCallableExcludeMemberAttribute(SubsetCallableExcludeMemberType.PerSpec)> _
Public Sub New ( _
requestUrl As String, _
userToken As SPUserToken _
)
'Usage
Dim requestUrl As String
Dim userToken As SPUserToken
Dim instance As New SPSite(requestUrl, _
userToken)
[SubsetCallableExcludeMemberAttribute(SubsetCallableExcludeMemberType.PerSpec)]
public SPSite(
string requestUrl,
SPUserToken userToken
)
Parameters
requestUrl
Type: System.StringA string that specifies the absolute URL for the site collection.
userToken
Type: Microsoft.SharePoint.SPUserTokenAn SPUserToken object that represents the user token.
Remarks
SPSite objects that are created with a user token run in the context of the specified user. It is not possible to change the user context of an SPSite object once it has been created. Switching users requires creating a new SPSite object.
The user token is transferable across site collections, but not across identity management systems. For example, pluggable membership and role providers that are making a request must match the provider on the resource side.
Use the UserToken property to get the user token that is associated with any SPUser object, not just the current user. If the requested user is not the current user, SharePoint Foundation builds the token from the security ID (SID) of the user and gets the group membership information using the authorization object model (see Authorization, Users, and Groups).
Examples
The following code example returns the site collection located at https://Server_Name/sites/Site_Name/Subsite_Name with a specified user token.
Using oSiteCollection As New SPSite("http://Server_Name/sites/Site_Name/Subsite_Name/default.aspx", bUserToken)
...
End Using
using(SPSite oSiteCollection = new SPSite("http://Server_Name/sites/Site_Name/Subsite_Name/default.aspx", bUserToken))
{
...
}
Note
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.