TeamFoundationVersionControlService.Shelve Method (TeamFoundationRequestContext, String, String, array<String , Shelveset, Boolean)

Copies the pending changes to a shelveset. Changes will remain in the workspace also.

Namespace:  Microsoft.TeamFoundation.VersionControl.Server
Assembly:  Microsoft.TeamFoundation.VersionControl.Server (in Microsoft.TeamFoundation.VersionControl.Server.dll)

Syntax

'Declaration
Public Function Shelve ( _
    requestContext As TeamFoundationRequestContext, _
    workspaceName As String, _
    workspaceOwner As String, _
    serverItems As String(), _
    shelveset As Shelveset, _
    replace As Boolean _
) As List(Of Failure)

public List<Failure> Shelve(
    TeamFoundationRequestContext requestContext,
    string workspaceName,
    string workspaceOwner,
    string[] serverItems,
    Shelveset shelveset,
    bool replace
)

public:
List<Failure^>^ Shelve(
    TeamFoundationRequestContext^ requestContext, 
    String^ workspaceName, 
    String^ workspaceOwner, 
    array<String^>^ serverItems, 
    Shelveset^ shelveset, 
    bool replace
)

member Shelve : 
        requestContext:TeamFoundationRequestContext * 
        workspaceName:string * 
        workspaceOwner:string * 
        serverItems:string[] * 
        shelveset:Shelveset * 
        replace:bool -> List<Failure> 

public function Shelve(
    requestContext : TeamFoundationRequestContext, 
    workspaceName : String, 
    workspaceOwner : String, 
    serverItems : String[], 
    shelveset : Shelveset, 
    replace : boolean
) : List<Failure>

Parameters

• requestContext
  Type: Microsoft.TeamFoundation.Framework.Server.TeamFoundationRequestContext

  The request context.

• workspaceName
  Type: System.String

  Name of the workspace to shelve from.

• workspaceOwner
  Type: System.String

  Username of the workspace's owner.

• serverItems
  Type: array<System.String[]

  List of items to shelve.

• shelveset
  Type: Microsoft.TeamFoundation.VersionControl.Server.Shelveset

  Shelveset object populated with metadata (name, owner, comment, etc.).

• replace
  Type: System.Boolean

  If true and there is already a shelveset with the same name, it will be deleted.

Return Value

Type: System.Collections.Generic.List<Failure>
The list of failures which occurred when trying to shelve.

Remarks

The call sequence for Shelve() resembles Checkin().

Clients should: 1) Call QueryPendingSets(). 2) For each edited file, upload the content. 3) Call Shelve() with the list of server items from 1). 4) Call UndoPendingChanges() if "move" behavior is desired.

.NET Framework Security

• Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

See Also

Reference

TeamFoundationVersionControlService Class

Shelve Overload

Microsoft.TeamFoundation.VersionControl.Server Namespace