XmlNameTable.Add Method (array<Char[], Int32, Int32)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

When overridden in a derived class, atomizes the specified string and adds it to the XmlNameTable.

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

Syntax

'Declaration
Public MustOverride Function Add ( _
    array As Char(), _
    offset As Integer, _
    length As Integer _
) As String
public abstract string Add(
    char[] array,
    int offset,
    int length
)

Parameters

  • array
    Type: array<System.Char[]
    The character array containing the name to add.
  • offset
    Type: System.Int32
    Zero-based index into the array specifying the first character of the name.
  • length
    Type: System.Int32
    The number of characters in the name.

Return Value

Type: System.String
The new atomized string or the existing one if it already exists. If length is zero, String.Empty is returned.

Exceptions

Exception Condition
IndexOutOfRangeException

0 > offset

-or-

offset >= array.Length

-or-

length > array.Length

The above conditions do not cause an exception to be thrown if length =0.

ArgumentOutOfRangeException

length < 0.

ArgumentNullException

array is nulla null reference (Nothing in Visual Basic).

Remarks

For more information on atomized strings, see XmlNameTable.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.