BeginUpdateSchemaDefinition(TimeSpan, String, ITransformationSet):ISchemaUpdateProgress

Starts a procedure for updating the schema and adapting data objects.

This method starts a procedure for updating the content of the schema. The schema is locked for editing by the system for as long as the procedure is not terminated.

Furthermore, transformations can be indicated for the adapting of existing data. Thus it is possible to adapt a schema even if the existing data objects could no longer be validated with the new schema definition. These transformations can now be used to set default values or to adapt the Xml in such a way that the existing data objects can also be validated with the new schema definition.

Parameter

waitToFinish

Type: System.TimeSpan

Blocks the calling thread until a thread is terminated or the specified time elapses, while the default COM and the SendMessage pumping are continued.

Further information on this parameter can be consulted under System.Threading.Thread.Join(TimeSpan timeout).

newSchemaDefinition

Type: System.String

This parameter contains the new schema definition to be set for the current schema.

transformationSet

Type: Onion.Client.ITransformationSet

This parameter contains a set of transformations for the revision of existing data objects.