XmlSchemaObjectCollection.Add Method (XmlSchemaObject)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Adds an XmlSchemaObject to the XmlSchemaObjectCollection.

Namespace:   System.Xml.Schema
Assembly:  System.Xml (in System.Xml.dll)

public int Add(
	XmlSchemaObject item
)

Return Value

Type: System.Int32

The index at which the item has been added.

Exception Condition
ArgumentOutOfRangeException

index is less than zero.

-or-

index is greater than Count.

InvalidCastException

The XmlSchemaObject parameter specified is not of type XmlSchemaExternal or its derived types XmlSchemaImport, XmlSchemaInclude, and XmlSchemaRedefine.

If Count already equals the capacity, the capacity of list is doubled by automatically reallocating the internal array and copying the existing elements to the new array before the new element is added.

If Count is less than the capacity, this method is an 0(1) operation. If the capacity needs to be increased to accommodate the new element, this method becomes an 0(n) operation, where n is Count.

The Add method expects only XmlSchemaExternal and its derived types (XmlSchemaImport, XmlSchemaInclude, and XmlSchemaRedefine) as parameters. The following example illustrates adding an included schema to the Includes collection of an existing XmlSchema object.

XmlSchema schema = new XmlSchema();

XmlTextReader textReader = new XmlTextReader("include.xsd");
XmlSchema includeSchema = XmlSchema.Read(textReader, null);

XmlSchemaInclude include = new XmlSchemaInclude();
include.Schema = includeSchema;
schema.Includes.Add(include);

.NET Framework
Available since 1.1
Return to top
Show: