ParserErrorCollection Class

Reference

Definition

Namespace:: System.Web

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Manages a set of parser errors detected during parsing. This class cannot be inherited.

public ref class ParserErrorCollection sealed : System::Collections::CollectionBase

[System.Serializable]
public sealed class ParserErrorCollection : System.Collections.CollectionBase

[<System.Serializable>]
type ParserErrorCollection = class
    inherit CollectionBase

Public NotInheritable Class ParserErrorCollection
Inherits CollectionBase

Inheritance: Object

CollectionBase
ParserErrorCollection

Attributes: SerializableAttribute

Examples

The following code example demonstrates how to use the ParserErrorCollection methods.

// Create an empty ParserErrorCollection.
ParserErrorCollection collection = new ParserErrorCollection();

// Add a ParserError to the collection.
collection.Add(new ParserError("ErrorName", "Path", 1));

// Add an array of ParserError objects to the collection.
ParserError[] errors = 
    { new ParserError("Error 2", "Path", 1), 
    new ParserError("Error 3", "Path", 1) };
collection.AddRange(errors);

// Add a collection of ParserError objects to the collection.
ParserErrorCollection errorsCollection = new ParserErrorCollection();
errorsCollection.Add(new ParserError("Error", "Path", 1));
errorsCollection.Add(new ParserError("Error", "Path", 1));
collection.AddRange(errorsCollection);

// Test for the presence of a ParserError in the 
// collection, and retrieve its index if it is found.
ParserError testError = new ParserError("Error", "Path", 1);
int itemIndex = -1;
if (collection.Contains(testError))
  itemIndex = collection.IndexOf(testError);

// Copy the contents of the collection to a
// compatible array, starting at index 0 of the
// destination array. 
ParserError[] errorsToSort = new ParserError[5];
collection.CopyTo(errorsToSort, 0);

// Retrieve the count of the items in the collection.
int collectionCount = collection.Count;

// Insert a ParserError at index 0 of the collection.
ParserError error = new ParserError("Error", "Path", 1);
collection.Insert(0, error);

// Remove the specified ParserError from the collection.
collection.Remove(error);

// Remove the ParserError at index 0.
collection.RemoveAt(0);

' Create an empty ParserErrorCollection.
Dim collection As New ParserErrorCollection()

' Add a ParserError to the collection.
collection.Add(New ParserError("ErrorName", "Path", 1))

' Add an array of ParserError objects to the collection.
Dim errors As ParserError() = _
    {New ParserError("Error 2", "Path", 1), _
    New ParserError("Error 3", "Path", 1)}
collection.AddRange(errors)

' Ads a collection of ParserError objects to the collection.
Dim errorsCollection As New ParserErrorCollection()
errorsCollection.Add(New ParserError("Error", "Path", 1))
errorsCollection.Add(New ParserError("Error", "Path", 1))
collection.AddRange(errorsCollection)

' Test for the presence of a ParserError in the 
' collection, and retrieve its index if it is found.
Dim testError As New ParserError("Error", "Path", 1)
Dim itemIndex As Integer = -1
If collection.Contains(testError) Then
  itemIndex = collection.IndexOf(testError)
End If

' Copy the contents of the collection to a
' compatible array, starting at index 0 of the
' destination array. 
Dim errorsToSort(5) As ParserError
collection.CopyTo(errorsToSort, 0)

' Retrieve the count of the items in the collection.
Dim collectionCount As Integer = collection.Count

' Insert a ParserError at index 0 of the collection.
Dim [error] As New ParserError("Error", "Path", 1)
collection.Insert(0, [error])

' Remove the specified ParserError from the collection.
collection.Remove([error])

' Remove the ParserError at index 0.
collection.RemoveAt(0)

Remarks

The ParserErrorCollection class provides methods and properties that you can use to manage a collection of ParserError objects. For example, you can add a set of parser errors to a collection upon parsing while using a custom BuildProvider object to report all parse exceptions caught during parsing.

To add parser errors to, remove them from, or locate them in a collection, use the following:

The Add method to add a single ParserError object to the collection.
The AddRange methods to add multiple ParserError objects to the collection.
Both the Insert method and the Item[] property, which is the ParserErrorCollection indexer, to add a single ParserError object to the collection at the specified index.

Additionally, you can use the ParserErrorCollection class to do the following:

Remove ParserError objects with the Remove method.
Check whether a particular ParserError is in the collection by using the Contains method.
Find where a ParserError object is located in the collection by using the IndexOf method.

Constructors

ParserErrorCollection()	Initializes a new instance of the ParserErrorCollection class.
ParserErrorCollection(ParserError[])	Initializes a new instance of the ParserErrorCollection class.

Properties

Capacity	Gets or sets the number of elements that the CollectionBase can contain. (Inherited from CollectionBase)
Count	Gets the number of elements contained in the CollectionBase instance. This property cannot be overridden. (Inherited from CollectionBase)
InnerList	Gets an ArrayList containing the list of elements in the CollectionBase instance. (Inherited from CollectionBase)
Item[Int32]	Gets or sets the ParserError object at the specified index within the collection.
List	Gets an IList containing the list of elements in the CollectionBase instance. (Inherited from CollectionBase)

Methods

Add(ParserError)	Adds a value to the collection.
AddRange(ParserError[])	Adds an array of ParserError objects to the collection.
AddRange(ParserErrorCollection)	Adds the objects in an existing ParserErrorCollection to the collection.
Clear()	Removes all objects from the CollectionBase instance. This method cannot be overridden. (Inherited from CollectionBase)
Contains(ParserError)	Determines whether the ParserError object is located in the collection.
CopyTo(ParserError[], Int32)	Copies the ParserError objects in the collection to a compatible one-dimensional array, starting at the specified index of the target array.
Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
GetEnumerator()	Returns an enumerator that iterates through the CollectionBase instance. (Inherited from CollectionBase)
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetType()	Gets the Type of the current instance. (Inherited from Object)
IndexOf(ParserError)	Gets the index of the specified ParserError object in the collection.
Insert(Int32, ParserError)	Inserts the specified ParserError object into the collection at the specified index.
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
OnClear()	Performs additional custom processes when clearing the contents of the CollectionBase instance. (Inherited from CollectionBase)
OnClearComplete()	Performs additional custom processes after clearing the contents of the CollectionBase instance. (Inherited from CollectionBase)
OnInsert(Int32, Object)	Performs additional custom processes before inserting a new element into the CollectionBase instance. (Inherited from CollectionBase)
OnInsertComplete(Int32, Object)	Performs additional custom processes after inserting a new element into the CollectionBase instance. (Inherited from CollectionBase)
OnRemove(Int32, Object)	Performs additional custom processes when removing an element from the CollectionBase instance. (Inherited from CollectionBase)
OnRemoveComplete(Int32, Object)	Performs additional custom processes after removing an element from the CollectionBase instance. (Inherited from CollectionBase)
OnSet(Int32, Object, Object)	Performs additional custom processes before setting a value in the CollectionBase instance. (Inherited from CollectionBase)
OnSetComplete(Int32, Object, Object)	Performs additional custom processes after setting a value in the CollectionBase instance. (Inherited from CollectionBase)
OnValidate(Object)	Performs additional custom processes when validating a value. (Inherited from CollectionBase)
Remove(ParserError)	Removes the specified ParserError object from the collection.
RemoveAt(Int32)	Removes the element at the specified index of the CollectionBase instance. This method is not overridable. (Inherited from CollectionBase)
ToString()	Returns a string that represents the current object. (Inherited from Object)

Explicit Interface Implementations

ICollection.CopyTo(Array, Int32)	Copies the entire CollectionBase to a compatible one-dimensional Array, starting at the specified index of the target array. (Inherited from CollectionBase)
ICollection.IsSynchronized	Gets a value indicating whether access to the CollectionBase is synchronized (thread safe). (Inherited from CollectionBase)
ICollection.SyncRoot	Gets an object that can be used to synchronize access to the CollectionBase. (Inherited from CollectionBase)
IList.Add(Object)	Adds an object to the end of the CollectionBase. (Inherited from CollectionBase)
IList.Contains(Object)	Determines whether the CollectionBase contains a specific element. (Inherited from CollectionBase)
IList.IndexOf(Object)	Searches for the specified Object and returns the zero-based index of the first occurrence within the entire CollectionBase. (Inherited from CollectionBase)
IList.Insert(Int32, Object)	Inserts an element into the CollectionBase at the specified index. (Inherited from CollectionBase)
IList.IsFixedSize	Gets a value indicating whether the CollectionBase has a fixed size. (Inherited from CollectionBase)
IList.IsReadOnly	Gets a value indicating whether the CollectionBase is read-only. (Inherited from CollectionBase)
IList.Item[Int32]	Gets or sets the element at the specified index. (Inherited from CollectionBase)
IList.Remove(Object)	Removes the first occurrence of a specific object from the CollectionBase. (Inherited from CollectionBase)

Extension Methods

Cast<TResult>(IEnumerable)	Casts the elements of an IEnumerable to the specified type.
OfType<TResult>(IEnumerable)	Filters the elements of an IEnumerable based on a specified type.
AsParallel(IEnumerable)	Enables parallelization of a query.
AsQueryable(IEnumerable)	Converts an IEnumerable to an IQueryable.

Applies to

Share via