XmlSchemaObjectCollection.Add(XmlSchemaObject) Methode

Definition

Namespace:

System.Xml.Schema

Assembly:

System.Xml.ReaderWriter.dll

Source:

XmlSchemaObjectCollection.cs

Fügt dem XmlSchemaObject eine XmlSchemaObjectCollection hinzu.

public:
 int Add(System::Xml::Schema::XmlSchemaObject ^ item);

public int Add (System.Xml.Schema.XmlSchemaObject item);

member this.Add : System.Xml.Schema.XmlSchemaObject -> int

Public Function Add (item As XmlSchemaObject) As Integer

Parameter

item

XmlSchemaObject

Die XmlSchemaObject.

Gibt zurück

Int32

Der Index, an dem das Element hinzugefügt wurde.

Ausnahmen

ArgumentOutOfRangeException

index ist kleiner als Null.

- oder -

index ist größer als Count.

InvalidCastException

Der angegebene XmlSchemaObject-Parameter besitzt nicht den Typ XmlSchemaExternal oder einen der von diesem abgeleiteten Typen XmlSchemaImport, XmlSchemaInclude und XmlSchemaRedefine.

Hinweise

Wenn Count bereits der Kapazität entspricht, wird die Kapazität der Liste verdoppelt, indem das interne Array automatisch neu zugewiesen und die vorhandenen Elemente in das neue Array kopiert werden, bevor das neue Element hinzugefügt wird.

Wenn Count die Kapazität kleiner ist, handelt es sich bei dieser Methode um einen 0(1)-Vorgang. Wenn die Kapazität erhöht werden muss, um das neue Element aufzunehmen, wird diese Methode zu einem 0(n)-Vorgang, wobei n ist Count.

Die Add -Methode erwartet nur XmlSchemaExternal und ihre abgeleiteten Typen (XmlSchemaImport, XmlSchemaIncludeund XmlSchemaRedefine) als Parameter. Das folgende Beispiel veranschaulicht das Hinzufügen eines enthaltenen Schemas zur Includes Auflistung eines vorhandenen XmlSchema Objekts.

Dim schema As XmlSchema = New XmlSchema()  

Dim textReader As XmlTextReader = New XmlTextReader("include.xsd")  
Dim includeSchema As XmlSchema = XmlSchema.Read(textReader, null)  

Dim include As XmlSchemaInclude = New XmlSchemaInclude()  
include.Schema = includeSchema;  
schema.Includes.Add(include);  

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);