Namespace: Ingeniux.CMS
Assembly: Ingeniux.CMS.CSAPI (in Ingeniux.CMS.CSAPI.dll) Version: 9.0.565.0 (9.0.565)
Parameters
- name
- Type: SystemString
The new schema's root element name, which must be a valid XML element name. - friendlyName
- Type: SystemString
The new schema's friendly name. This can be any name you choose, but it's recommended that you limit its length. - icon
- Type: SystemInt32
An icon ID, which corresponds to an icon image.
Return Value
Type: ISchemaThe newly created component schema.
Exception | Condition |
---|---|
ArgumentNullException | When the "name" parameter is null, empty or contains whitespace |
ArgumentException | When the "name" parameter is not a valid XML element name, or there are already schemas with the same root name or friendly name. |
The returned schema is not yet saved to the content store.
The "name" parameter provided cannot be null, empty, or whitespace, and it must be a valid XML element name.
The friendly names and root element names are unique to the schema's collection. If any schemas with a matching friendly name or root element name already exist, an error is thrown.
The newly created schema will be in draft mode. It cannot be used to create pages until it is saved with a new version.
If the icon ID provided doesn't match any icon images, it defaults to a blank page icon.
The newly created schema doesn't have any fields yet. Fields must be added to the returned object before saving (for more information, see UserWriteSession disposal).
using (IUserWriteSession session = _Store.OpenWriteSession(operatingUser)) { schema = session.SchemasManager.CreateComponentSchema("NewsDetails", "News Details", 2); ISchemaFieldType attributeType = session.SchemasManager.FieldDefinitions.ItemByID("1"); ISchemaField attribField = new SchemaField(attributeType, "Source", "Source Publication"); attribField.HelpText = "The Publication that first published the news"; attribField.DefaultValue = "Seattle Times"; ISchemaFieldType textElementType = session.SchemasManager.FieldDefinitions.ItemByID("2"); ISchemaField textField = new SchemaField(textElementType, "Title", "Title", true, false, false); schema.AddField(attribField); schema.AddField(textField); schema.Save(true); }