insert_entry
Description:
public Entry insert_entry (AuthorizationDomain? domain, string upload_uri, Entry entry, Cancellable? cancellable = null) throws Error
Inserts entry by uploading it to the online service at upload_uri.
For more information about the concept of inserting entries, see the online documentation for the GData protocol.
The service will return an updated version of the entry, which is the return value of this function on success.
If cancellable is not null, then the operation can be cancelled by triggering the cancellable object
from another thread. If the operation was cancelled before or during network activity, the error
CANCELLED will be returned. Cancellation has no effect after network
activity has finished, however, and the insertion will return successfully (or return an error sent by the server) if it is first cancelled
after network activity has finished. See the overview of cancellation for more details.
If the entry is marked as already having been inserted a ENTRY_ALREADYSERTED error will be returned immediately (there will be no network requests).
If there is an error inserting the entry, a PROTOCOL_ERROR
error will be returned. Currently, subclasses cannot cannot override this or provide more specific errors.
Parameters:
| this |
a Service |
| domain |
the AuthorizationDomain the insertion operation falls under, or
|
| upload_uri |
the URI to which the upload should be sent |
| entry |
the Entry to insert |
| cancellable |
optional Cancellable object, or |