Request

Response

    IElement.SourceId property

    Gets or sets the element’s source identifier — the Id of the corresponding object in the authoring connector/application. This is the value stored on the underlying element and the key used by GetElementsBySourceId.

    public string SourceId { get; set; }
    

    Remarks

    Recommended usage: an authoring connector sets and reads SourceId so it can map exchange elements back to its own objects cheaply. A loading/consuming application should rely on UniqueId instead, which is a guaranteed UUID.

    SourceId is neither guaranteed to be present (it may be null when the authoring application supplied none) nor guaranteed unique — several elements may share one, and GetElementsBySourceId returns every match for that reason. Setting this value re-keys the element for SourceId lookups and marks the element as locally modified; assigning null simply leaves the element unindexed.

    See Also