SPSite Constructor (Guid, SPUrlZone, SPUserToken)

Initializes a new instance of the SPSite class based on the specified site collection GUID, URL zone, 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 ( _
    id As Guid, _
    zone As SPUrlZone, _
    userToken As SPUserToken _
)
'Usage
Dim id As Guid
Dim zone As SPUrlZone
Dim userToken As SPUserToken

Dim instance As New SPSite(id, zone, _
    userToken)

[SubsetCallableExcludeMemberAttribute(SubsetCallableExcludeMemberType.PerSpec)]
public SPSite(
    Guid id,
    SPUrlZone zone,
    SPUserToken userToken
)

Parameters

• id
  Type: System.Guid

  A GUID that specifies the site collection.

• zone
  Type: Microsoft.SharePoint.Administration.SPUrlZone

  An SPUrlZone value that specifies the URL zone.

• userToken
  Type: Microsoft.SharePoint.SPUserToken

  An 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 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 identifier (SID) of the user and gets the group membership information using the authorization object model (see Authorization, Users, and Groups).

See Also

Reference

SPSite Class

SPSite Members

SPSite Overload

Microsoft.SharePoint Namespace