ItemService.CreateItem Method

MultiArchive SDK .NET

Collapse image Expand Image Copy image CopyHover image

[This is preliminary documentation and is subject to change.]

Method for creating a new item in MultiArchive.

The method makes sure that the ItemSpecification contains both field- and content-specifications and then makes an asynchronous call to the MultiArchive webservice. It then waits for the asynchronous call to return before it itself returns the URN of the newly created item.

Namespace: MultiArchive.SDK.Services
Assembly: MultiArchive.SDK (in MultiArchive.SDK.dll) Version: 1.2.30.413 (1.2.30.413)

Syntax

C#
public string CreateItem(
	Credentials credentials,
	ItemSpecification itemSpecification
)
Visual Basic
Public Function CreateItem ( 
	credentials As Credentials,
	itemSpecification As ItemSpecification
) As String
Visual C++
public:
String^ CreateItem(
	Credentials^ credentials, 
	ItemSpecification^ itemSpecification
)

Parameters

credentials
Type: Credentials
A Credentials object with information about the current user.
itemSpecification
Type: ItemSpecification
A ItemSpecification object containing information about the item being created.

Return Value

Type: String
The returned object from this method is a string representation of the item URN returned from MultiArchive.

Exceptions

Exception Condition
MultiArchive.SDK.Services.Exceptions..::..LogonException Throws a LogonException if the Credentials object is no longer valid.
MultiArchive.SDK.Services.Exceptions..::..ItemException Throws an ItemException if either FieldSpecifications or ContentSpecifications are missing or there are any problems with the ItemSpecification in the call to the webservice.
MultiArchive.SDK.Services.Exceptions..::..MultiArchiveSDKException Throws a MultiArchiveSDKException if an unexpected error occurs.

See Also