Freigeben über


XmlSchemaObjectCollection.Add-Methode

Fügt der XmlSchemaObjectCollection ein XmlSchemaObject hinzu.

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

Syntax

'Declaration
Public Function Add ( _
    item As XmlSchemaObject _
) As Integer
'Usage
Dim instance As XmlSchemaObjectCollection
Dim item As XmlSchemaObject
Dim returnValue As Integer

returnValue = instance.Add(item)
public int Add (
    XmlSchemaObject item
)
public:
int Add (
    XmlSchemaObject^ item
)
public int Add (
    XmlSchemaObject item
)
public function Add (
    item : XmlSchemaObject
) : int

Parameter

Rückgabewert

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

Ausnahmen

Ausnahmetyp Bedingung

ArgumentOutOfRangeException

index ist kleiner als 0.

- 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 der Wert von Count bereits gleich der Kapazität ist, wird die Kapazität der Liste durch automatisches Neureservieren des internen Arrays und Kopieren der vorhandenen Elemente in das neue Array verdoppelt, bevor das neue Element hinzugefügt wird.

Wenn Count kleiner als die Kapazität ist, ist diese Methode eine O(1)-Operation. Wenn die Kapazität zur Anpassung an das neue Element erhöht werden muss, wird diese Methode zu einer O(n)-Operation, wobei n gleich Count ist.

Die Add-Methode erwartet als Parameter nur XmlSchemaExternal und davon abgeleitete Typen (XmlSchemaImport, XmlSchemaInclude und XmlSchemaRedefine). Im folgenden Beispiel wird das Hinzufügen eines eingeschlossenen Schemas zur Includes-Auflistung eines vorhandenen XmlSchema-Objekts veranschaulicht.

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

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0

Siehe auch

Referenz

XmlSchemaObjectCollection-Klasse
XmlSchemaObjectCollection-Member
System.Xml.Schema-Namespace